Azure Cosmos DB for Apache Cassandra で Spring Data を使用する方法

この記事では、Spring Data を使用して、Azure Cosmos DB for Apache Cassandraを使用して情報を格納および取得するサンプル アプリケーションを作成する方法について説明します。

前提 条件

• Azure サブスクリプション - 無料アカウントを作成します。

• Java Development Kit (JDK)、バージョン 8 以降。

• Apache Maven。

• Azure CLI。

• Git クライアント。

• cURL または同様の HTTP ユーティリティ を使用して機能をテストします。

Azure Cosmos DB アカウントを作成する

次の手順では、Azure portal で Azure Cosmos DB アカウントを作成して構成します。

Azure portal を使用して Azure Cosmos DB アカウントを作成する

1. https://portal.azure.com/ で Azure portal に移動し、サインインします。

2. [リソースの作成] を選択し、[作業の開始] を選択して、[Azure Cosmos DB] を選択します。

3. [API オプションの選択] 画面で、[Cassandra] を選択します。

   Azure portal

4. 次の情報を指定します。

   • サブスクリプション: 使用する Azure サブスクリプションを指定します。
   • リソース グループ: 新しいリソース グループを作成するか、既存のリソース グループを選択するかを指定します。
   • アカウント名: Azure Cosmos DB アカウントの一意の名前を選択します。この 名前 は、wingtiptoyscassandra.documents.azure.comなどの完全修飾ドメイン名を作成するために使用されます。
   • API: このチュートリアルでは Cassandra を指定します。
   • 場所: データベースに最も近い地理的リージョンを指定します。

   

5. 上記の情報をすべて入力したら、[確認と作成] をクリックします。

6. レビュー ページに問題がなければ、[作成] をクリックします。

データベースのデプロイには数分かかります。

Azure Cosmos DB アカウントにキースペースを追加する

1. https://portal.azure.com/ で Azure portal に移動し、サインインします。

2. [すべてのリソース を選択し、作成した Azure Cosmos DB アカウントを選択します。

3. データ エクスプローラー を選択し、下矢印を選択し、[新しいキースペース]選択します。 [キースペース ID] に一意の識別子を入力し、[OK] を選択します。

   

   

Azure Cosmos DB アカウントの接続設定を取得する

1. https://portal.azure.com/ で Azure portal に移動し、サインインします。

2. [すべてのリソース を選択し、作成した Azure Cosmos DB アカウントを選択します。

3. [接続文字列選択し、連絡先ポイントの、ポート、ユーザー名、およびプライマリ パスワード フィールドの値 コピーします。これらの値を使用して、後でアプリケーションを構成します。

   

サンプル アプリケーションを構成する

次の手順では、テスト アプリケーションを構成します。

1. コマンド シェルを開き、次の例のように git コマンドを使用してサンプル プロジェクトを複製します。

   git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure.git
   

2. サンプル プロジェクトの resources ディレクトリ内で application.properties ファイルを探すか、まだ存在しない場合はファイルを作成します。

3. テキスト エディターで application.properties ファイルを開き、ファイルに次の行を追加または構成し、サンプル値を前の適切な値に置き換えます。

   spring.data.cassandra.contact-points=wingtiptoyscassandra.cassandra.cosmos.azure.com
   spring.data.cassandra.port=10350
   spring.data.cassandra.username=wingtiptoyscassandra
   spring.data.cassandra.password=********
   

   どこ：

   パラメーター	説明
   spring.data.cassandra.contact-points	この記事の前半の 連絡先ポイント を指定します。
   spring.data.cassandra.port	この記事の前半の ポート を指定します。
   spring.data.cassandra.username	この記事で前述した ユーザー名 を指定します。
   spring.data.cassandra.password	この記事の前半の プライマリ パスワード を指定します。

4. application.properties ファイルを保存して閉じます。

サンプル アプリケーションをパッケージ化してテストする

アプリケーションをビルドしてテストする pom.xml ファイルが含まれているディレクトリを参照します。

1. Maven を使用してサンプル アプリケーションをビルドする。例えば：

   mvn clean package
   

2. サンプル アプリケーションを起動します。例えば：

   java -jar target/spring-data-cassandra-on-azure-0.1.0-SNAPSHOT.jar
   

3. 次の例のように、コマンド プロンプトから curl を使用して新しいレコードを作成します。

   curl -s -d "{\"name\":\"dog\",\"species\":\"canine\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets
   
   curl -s -d "{\"name\":\"cat\",\"species\":\"feline\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets
   

   アプリケーションは、次の例のような値を返す必要があります。

   Added Pet{id=60fa8cb0-0423-11e9-9a70-39311962166b, name='dog', species='canine'}.
   
   Added Pet{id=72c1c9e0-0423-11e9-9a70-39311962166b, name='cat', species='feline'}.
   

4. 次の例のように、コマンド プロンプトから curl を使用して既存のすべてのレコードを取得します。

   curl -s http://localhost:8080/pets
   

   アプリケーションは、次の例のような値を返す必要があります。

   [{"id":"60fa8cb0-0423-11e9-9a70-39311962166b","name":"dog","species":"canine"},{"id":"72c1c9e0-0423-11e9-9a70-39311962166b","name":"cat","species":"feline"}]
   

概要

このチュートリアルでは、Spring Data を使用して Azure Cosmos DB for Apache Cassandra を使用して情報を格納および取得するサンプル Java アプリケーションを作成しました。

リソースのクリーンアップ

不要になったら、azure portal を使用して、この記事で作成したリソースを削除して、予期しない料金を回避します。

次の手順

Spring と Azure の詳細については、Spring on Azure ドキュメント センターに進んでください。

関連項目

Java での Azure の使用の詳細については、Java 開発者向け Azure と、Azure DevOps と Javaの使用に関する を参照してください。