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

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

前提条件

Azure サブスクリプション - 無料アカウントを作成します。
Java Development Kit (JDK)、バージョン 8 以降。
Apache Maven。
Azure CLI。

Git クライアント。
cURL または同様の HTTP ユーティリティを使用して機能をテストします。

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

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

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

手記

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

https://portal.azure.com/ で Azure portal に移動し、サインインします。
[リソースの作成] を選択し、[はじめに] を選択し、Azure Cosmos DBを選択します。
[API オプションの選択] 画面で、[Cassandra] を選択します。
次の情報を指定します。
- サブスクリプション: 使用する Azure サブスクリプションを指定します。
- リソースグループ: 新しいリソースグループを作成するか、既存のリソースグループを選択するかを指定します。
- アカウント名: Azure Cosmos DB アカウントの一意の名前を選択します。この名前は、 wingtiptoyscassandra.documents.azure.comなどの完全修飾ドメイン名を作成するために使用されます。
- API: このチュートリアルでは Cassandra を指定します。
- 場所: データベースに最も近い地理的リージョンを指定します。
上記の情報をすべて入力したら、[ 確認と作成] を選択します。
レビューページですべてが正しく表示される場合は、[ 作成] を選択します。

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

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

https://portal.azure.com/ で Azure portal に移動し、サインインします。
[すべてのリソース] を選択し、作成したAzure Cosmos DBアカウントを選択します。
Data Explorer選択し、下矢印を選択して、[新しいキースペース] を選択します。 キースペース ID の一意の識別子を入力し、[OK] を選択します。

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

https://portal.azure.com/ で Azure portal に移動し、サインインします。
[すべてのリソース] を選択し、作成したAzure Cosmos DBアカウントを選択します。
接続文字列を選択し、[連絡先ポイント]、[ポート]、[ユーザー名]、[プライマリパスワード] フィールドの値をコピーします。これらの値を使用して、後でアプリケーションを構成します。

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

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

コマンドシェルを開き、次の例のように git コマンドを使用してサンプルプロジェクトを複製します。
```
git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure.git
```
サンプルプロジェクトの resources ディレクトリ内で application.properties ファイルを探すか、まだ存在しない場合はファイルを作成します。

テキストエディターで 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`	この記事の前半のプライマリパスワードを指定します。

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

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

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

Maven を使用してサンプルアプリケーションをビルドする。例えば：
```
mvn clean package
```
サンプルアプリケーションを起動します。例えば：
```
java -jar target/spring-data-cassandra-on-azure-0.1.0-SNAPSHOT.jar
```

コマンドプロンプトから 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'}.

コマンドプロンプトから 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 を使用して Apache Cassandra のAzure Cosmos DBを使用して情報を格納および取得するサンプル Java アプリケーションを作成しました。

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

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

次の手順

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

アジュールの春 (Spring on Azure)

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-14