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

5 分

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

Azure Synapse Link と Azure Cosmos DB および Azure Synapse Analytics との統合を示す図。

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

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

Azure Cosmos DB で Azure Synapse Link を有効にする

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 を有効にすることができます。

Cosmos DB for NoSQL アカウントで Azure Synapse Link を有効にするオプションを示すスクリーンショット。

ヒント

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

Azure Synapse Link を有効にする場合の考慮事項

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