各製品の資料を入手。
詳細はこちら →複数Cosmos DB アカウントをレプリケーション
複数のCosmos DB アカウントを、1つあるいは多数のデータベースにレプリケーション。
最終更新日:2022-06-05
こんにちは!プロダクトスペシャリストの宮本です。
CData Sync for CosmosDB は、データベースにサンドボックスや製品インスタンスをレプリケートするなどの、レプリケーションの多様なシナリオに対する解決策を提供するスタンドアロンアプリケーションです。Sync for Windows およびSync for Java はどちらもコマンドラインインターフェース(CLI)を含んでおり、複数のCosmos DB 接続を簡単に管理できます。この記事では、CLI を使って複数のCosmos DB アカウントをレプリケートする方法について説明します。
Cosmos DB 接続の構成
接続およびE メール通知設定をXML 設定ファイルに保存できます。複数のCosmos DB アカウントをレプリケートするには、複数の設定ファイルを使います。以下にCosmos DB をSQLite にレプリケートする設定例を示します。
Windows
<?xml version="1.0" encoding="UTF-8" ?>
<CDataSync>
<DatabaseType>SQLite</DatabaseType>
<DatabaseProvider>System.Data.SQLite</DatabaseProvider>
<ConnectionString>AccountEndpoint=myAccountEndpoint;AccountKey=myAccountKey;</ConnectionString>
<ReplicateAll>False</ReplicateAll>
<NotificationUserName></NotificationUserName>
<DatabaseConnectionString>Data Source=C:\my.db</DatabaseConnectionString>
<TaskSchedulerStartTime>09:51</TaskSchedulerStartTime>
<TaskSchedulerInterval>Never</TaskSchedulerInterval>
</CDataSync>
Java
<?xml version="1.0" encoding="UTF-8" ?>
<CDataSync>
<DatabaseType>SQLite</DatabaseType>
<DatabaseProvider>org.sqlite.JDBC</DatabaseProvider>
<ConnectionString>AccountEndpoint=myAccountEndpoint;AccountKey=myAccountKey;</ConnectionString>
<ReplicateAll>False</ReplicateAll>
<NotificationUserName></NotificationUserName>
<DatabaseConnectionString>Data Source=C:\my.db</DatabaseConnectionString>
</CDataSync>
CosmosDB 接続プロパティの取得・設定方法
SQL API を使ってCosmos DB アカウントに接続するために必要な接続文字列を取得するには、Azure Portal にログインして「Azure Cosmos DB」を選択し、自分のアカウントを選択します。「Settings」セクションで、「Connection String」をクリックして次の値を設定します。
- AccountEndpoint:この値は、Cosmos DB アカウントの「Keys」ブレードからのCosmos DB アカウントURL に設定してください。
- AccountKey:Azure ポータルで、Cosmos DB サービスに移動してAzure Cosmos DB アカウントを選択します。リソースメニューから、 「Keys」ページに移動します。「PRIMARY KEY」値を見つけ、Token をこの値に設定します。
各Cosmos DB インスタンスにクエリを設定
Sync を使うと標準SQL でレプリケーションを制御できます。REPLICATE ステートメントはハイレベルなコマンドで、データベースにテーブルをキャッシュして維持します。Cosmos DB API がサポートするあらゆるSELECT クエリを定義できます。下記のステートメントは、Cosmos DB のデータ のテーブルをキャッシュしてインクリメンタルに更新します。
REPLICATE Customers;
特定のデータベースを更新するために使用するレプリケーションクエリを含むファイルを指定することができます。レプリケーションステートメントはセミコロンで区切ります。次のオプションは、複数のCosmos DB アカウントを同じデータベースにレプリケートする場合に便利です。
REPLICATE SELECT ステートメントでは、異なるテーブルのプレフィックスを使用できます。
REPLICATE PROD_Customers SELECT * FROM Customers
異なるスキーマを使用することもできます。
REPLICATE PROD.Customers SELECT * FROM Customers
Sync の実行
接続文字列およびレプリケーションクエリの設定が完了したら、次のコマンドラインオプションを使ってSync を実行できます。
Windows
CosmosDBSync.exe -g MyProductionCosmosDBConfig.xml -f MyProductionCosmosDBSync.sql
Java
java -Xbootclasspath/p:c:\sqlitejdbc.jar -jar CosmosDBSync.jar -g MyProductionCosmosDBConfig.xml -f MyProductionCosmosDBSync.sql