Cosmos DB アカウントで Azure Synapse Link を使用できるようにする

  • 5 分

Azure Synapse Link for Azure Cosmos DB はクラウドネイティブの HTAP 機能であり、Azure Cosmos DB と Azure Synapse Analytics の間の統合が可能になります。

A diagram showing Azure Synapse Link integration with Azure Cosmos DB and Azure Synapse Analytics.

上の図では、Azure Synapse Link for Cosmos DB アーキテクチャにおける以下の主な機能を示しています。

  1. Azure Cosmos DB コンテナーには、読み取りおよび書き込み操作用に最適化された行ベースのトランザクション ストアが用意されています。
  2. コンテナーには、分析ワークロード用に最適化された列ベースの分析ストアも用意されています。 フル マネージドの自動同期プロセスでは、データ ストアの同期を維持します。
  3. Azure Synapse Link には、Azure Cosmos DB の分析ストア対応コンテナーを Azure Synapse Analytics ワークスペースに接続するリンク サービスが用意されています。
  4. Azure Synapse Analytics には Synapse SQL と Apache Spark ランタイムが用意されています。これにより、Azure Cosmos DB のトランザクション データ ストアに影響を与えることなく、Azure Cosmos DB 分析ストアからデータを取得、処理、分析するコードを実行できます。

Azure Synapse Link for Cosmos DB を使用するための最初の手順は、それを Azure Cosmos DB アカウントで有効にすることです。 Azure Synapse Link は、次の種類の Azure Cosmos DB アカウントでサポートされています。

  • NoSQL 用 Azure Cosmos DB
  • Azure Cosmos DB for MongoDB
  • Azure Cosmos DB for Apache Gremlin ("プレビュー")

Azure Synapse Link は、Cosmos DB アカウントの Azure portal ページで、またはコマンド ラインまたはスクリプトから Azure CLI または Azure PowerShell を使用して有効にできます。

Azure ポータルの使用

Azure portal では、次に示すように、[統合] セクションの [Azure Synapse Link] ページで Cosmos DB アカウントの Azure Synapse Link を有効にすることができます。

A screenshot showing the option to enable Azure Synapse Link for a Cosmos DB for NoSQL account.

ヒント

Azure Cosmos DB for NoSQL アカウントの場合は、Data Explorer ページにもリンクがあります。

Azure CLI の使用

Azure CLI を使用して Azure Synapse Link を有効にするには、az cosmosdb create コマンド (新しい Cosmos DB アカウントを作成する) または az cosmosdb update コマンド (既存の Cosmos DB アカウントを構成する) を、--enable-analytical-storage true パラメーターを指定して実行します。 たとえば、次のコマンドを実行すると、my-cosmos-db という名前の既存の Cosmos DB アカウントを更新して、Azure Synapse Link を有効にします。

az cosmosdb update --name my-cosmos-db --resource-group my-rg --enable-analytical-storage true

Azure Cosmos DB for Apache Gremlin アカウントの Azure Synapse Link を有効にするには、--capabilities EnableGremlin パラメーターを含めます。

Azure PowerShell の使用

Azure PowerShell を使用して Azure Synapse Link を有効にするには、New-AzCosmosDBAccount コマンドレット (新しい Cosmos DB アカウントを作成する) または Update-AzCosmosDBAccount コマンドレット (既存の Cosmos DB アカウントを構成する) を、-EnableAnalyticalStorage 1 パラメーターを指定して実行します。 たとえば、次のコマンドを実行すると、my-cosmos-db という名前の既存の Cosmos DB アカウントを更新して、Azure Synapse Link を有効にします。

Update-AzCosmosDBAccount -Name "my-cosmos-db" -ResourceGroupName "my-rg" -EnableAnalyticalStorage 1

Cosmos DB アカウントに対して Azure Synapse Link を有効にする場合は、次の点を考慮してください。

  • アカウントに対して Azure Synapse Link を有効にした後は、無効にすることはできません。

  • Azure Synapse Link を有効にしても、運用データの分析ストアへの同期は開始されません。分析ストアをサポートするコンテナーを作成または更新する必要もあります。

  • Azure CLI または PowerShell を使用して Cosmos DB for NoSQL アカウントに対して Azure Synapse Link を有効にする場合は、--analytical-storage-schema-type (Azure CLI) または -AnalyticalStorageSchemaType (PowerShell) パラメーターを使って、スキーマの種類を WellDefined (既定) または FullFidelity として指定できます。 Cosmos DB for MongoDB アカウントの場合、既定の (また唯一サポートされている) スキーマの種類は FullFidelity です。

  • スキーマの種類を割り当てた後は、変更できません。

    Note

    分析ストアとそのスキーマの種類の詳細については、次のユニットで学習します。