Azure Stream Analytics からの Azure Cosmos DB 出力

  • [アーティクル]

Azure Cosmos DB はグローバル分散型データベース サービスです。世界各地に対応する、制限のないエラスティックなスケーリング、スキーマに依存しないデータ モデルでの豊富なクエリと自動インデックス作成機能を提供します。 Stream Analytics の Azure Cosmos DB コンテナー オプションについては、Azure Cosmos DB を出力として使用する Stream Analytics に関する記事を参照してください。

Stream Analytics からの Azure Cosmos DB 出力は、現在、21Vianet によって運営される Microsoft Azure および Azure Germany (T-Systems International) では利用できません。

注意

Azure Stream Analytics は、SQL API を使用した Azure Cosmos DB への接続のみをサポートしています。 その他の Azure Cosmos DB API は、まだサポートされていません。 Azure Stream Analytics を、その他のAPI で作成した Azure Cosmos DB アカウントへ接続する場合は、データが正しく格納されない可能性があります。

次の表では、Azure Cosmos DB の出力を作成するプロパティについて説明します。

プロパティ名 説明
出力エイリアス Stream Analytics クエリ内でこの出力を意味するエイリアス。
シンク Azure Cosmos DB。
インポート オプション [Select Azure Cosmos DB from your subscription](サブスクリプションから Azure Cosmos DB を選択する) または [Provide Azure Cosmos DB settings manually](Azure Cosmos DB 設定を手動で指定します) を選択します。
Account ID Azure Cosmos DB アカウントの名前またはエンドポイント URI。
アカウント キー Azure Cosmos DB アカウントの共有アクセス キー。
データベース Azure Cosmos DB データベース名。
コンテナー名 使用するコンテナーの名前。Azure Cosmos DB に存在する必要があります。 例:
  • MyContainer: "MyContainer" という名前のコンテナーが存在する必要があります。
ドキュメント ID 省略可能。 挿入操作または更新操作の基盤となるプライマリ キーを指定するために使用される、出力イベント内のフィールドの名前です。

注意

Azure Stream Analytics の Azure Cosmos DB 出力では、.NET V3 SDK が使用されます。 複数のリージョンに書き込む場合、SDK は自動的に利用可能な最適なリージョンを選択します。

パーティション分割

パーティション キーは、クエリの PARTITION BY 句に基づきます。 出力ライターの数は、完全並列化されたクエリに対する入力のパーティション分割に従います。 Stream Analytics によって、Azure Cosmos DB 出力パーティション キーが文字列に変換されます。 たとえば、bigint 型の値が 1 のパーティション キーがある場合、string 型の "1" に変換されます。 この変換は、パーティションのプロパティが Azure Cosmos DB に書き込まれるかどうかにかかわらず、常に発生します。

出力バッチ サイズ

メッセージの最大サイズについては、「Azure Cosmos DB の制限」を参照してください。 バッチ サイズと書き込みの頻度は、Azure Cosmos DB の応答に基づいて動的に調整されます。 Stream Analytics からの事前に定義された制限はありません。

次のステップ