Azure Cosmos DB for MongoDB API で Spring Data を使用する

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

前提条件

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

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

• Apache Maven。

• Azure CLI。

• Git クライアント。

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

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

注意

アカウントの作成の詳細については、 Azure Cosmos DB のドキュメントを参照してください。

1. Azure portal (https://portal.azure.com/) を参照し、サインインします。

2. [リソースの作成] 、 [データベース] 、 [Azure Cosmos DB] の順に選択します。

   

3. [ API の選択] オプション 画面で、[ Azure Cosmos DB for MongoDB] を選択します。

   

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

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

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

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

   

Azure Cosmos DB アカウントの接続文字列を取得する

1. Azure portal (https://portal.azure.com/) を参照し、サインインします。

2. [すべてのリソース] をクリックしてから、先ほど作成した Azure Cosmos DB アカウントをクリックします。

3. [ 接続文字列] をクリックし、[ プライマリ接続文字列 ] フィールドの値をコピーします。この値を使用して、後でアプリケーションを構成します。

   

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

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

   git clone https://github.com/spring-guides/gs-accessing-data-mongodb.git
   

2. サンプル プロジェクトの <プロジェクト ルート>/complete/src/main ディレクトリに resources ディレクトリを作成し、この resources ディレクトリに application.properties ファイルを作成します。

3. テキスト エディターで application.properties ファイルを開き、このファイルに次の行を追加して、サンプルの値を前半の該当する値に置き換えます。

   spring.data.mongodb.database=wingtiptoysmongodb
   spring.data.mongodb.uri=mongodb://wingtiptoysmongodb:AbCdEfGhIjKlMnOpQrStUvWxYz==@wingtiptoysmongodb.documents.azure.com:10255/?ssl=true&replicaSet=globaldb
   

   各値の説明:

   パラメーター	説明
   spring.data.mongodb.database	この記事の前半の Azure Cosmos DB アカウントの名前を指定します。
   spring.data.mongodb.uri	この記事の前半のプライマリ接続文字列を指定します。

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

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

アプリケーションをビルドするには、pom.xml ファイルを含むディレクトリ /gs-accessing-data-mongodb/complete を参照します。

1. Maven でサンプル アプリケーションをビルドし、テストをスキップします。次に例を示します。

   mvn clean package -DskipTests
   

2. サンプル アプリケーションを開始します。次に例を示します。

   
   java -jar target/accessing-data-mongodb-complete-0.0.1-SNAPSHOT.jar
   

   アプリケーションから次のような値が返されます。

   Customers found with findAll():
   -------------------------------
   Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
   Customer[id=5c1b4ae4d0b5080ac105cc14, firstName='Bob', lastName='Smith']
   
   Customer found with findByFirstName('Alice'):
   --------------------------------
   Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
   Customers found with findByLastName('Smith'):
   --------------------------------
   Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
   Customer[id=5c1b4ae4d0b5080ac105cc14, firstName='Bob', lastName='Smith']
   

まとめ

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

リソースをクリーンアップする

予想外の課金を防ぐために、この記事で作成したリソースが不要になったら、Azure portal を使用して削除してください。

次のステップ

Spring および Azure の詳細については、Azure ドキュメント センターで引き続き Spring に関するドキュメントをご確認ください。

Azure の Spring

こちらもご覧ください

Java での Azure の使用の詳細については、「Java 開発者向けの Azure」および「Azure DevOps と Java の操作」を参照してください。