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

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

前提 条件

  • Git クライアント。

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

Azure ポータルを使用してAzure Cosmos DB アカウントを作成する

手記

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

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

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

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

    Azure ポータルの [Api の選択] オプション画面のスクリーンショット。MongoDB のAzure Cosmos DBが選択されています。

  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. https://portal.azure.com/ で Azure portal に移動し、サインインします。

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

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

    Azure Cosmos DB アカウントのプライマリ接続文字列を示す [接続文字列] ページのスクリーンショット。

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

  1. コマンド シェルを開き、git コマンドを使用してサンプル プロジェクトを複製します。 例えば次が挙げられます。

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

  2. サンプル プロジェクトの <project root>/complete/src/main ディレクトリにリソース ディレクトリを作成します。 次に、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 を使用してサンプル アプリケーションをビルドし、テストをスキップするように 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 を使用して MongoDB のAzure Cosmos DBを使用して情報を格納および取得するサンプル Java アプリケーションを作成しました。

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

リソースが不要になったら、Azure ポータルを使用してリソースを削除します。 リソースを削除すると、予期しない料金を回避するのに役立ちます。

次の手順

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

アジュールの春

関連項目

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

  • Last updated on