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

  • [アーティクル]

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

前提条件

  • Git クライアント。

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

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

Note

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

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

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

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

    Azure portal、リソースの作成、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 アカウントの設定を確認します。

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

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

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

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

    Azure Cosmos DB 接続文字列を取得します。

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

  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 ファイルを保存して閉じます。

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

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

  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 の操作」を参照してください。