Azure Cosmos DB 用の Azure Synapse Link に接続する
この記事では、Azure Synapse Link を使用して Azure Synapse Analytics Studio から Azure Cosmos DB データベースにアクセスする方法について説明します。
前提条件
Azure Cosmos DB データベースをワークスペースに接続する前に、次が必要です。
- 既存の Azure Cosmos DB データベース。または、Azure Cosmos アカウントを管理する方法のクイックスタートの手順に従って新しいアカウントを作成します。
- 既存の Azure Synapse ワークスペース。または、「クイックスタート: Synapse ワークスペースを作成する」の手順に従って新しいワークスペースを作成します。
Azure Cosmos DB データベース アカウントで Synapse Link を有効にする
運用上のパフォーマンスに影響を与えることなく Azure Cosmos DB に大規模な分析を実行するには、Azure Cosmos DB 用の Synapse Link を有効にすることをお勧めします。 Synapse Link により、Azure Synapse のコンテナーと組み込みサポートに HTAP 機能が提供されます。
Synapse Studio に移動する
対象の Azure Synapse ワークスペースから、 [Synapse Studio の起動] を選択します。 Synapse Studio のホーム ページで、 [データ] を選択します。これにより、データ オブジェクト エクスプローラーに移動します。
Azure Cosmos DB データベースを Azure Synapse ワークスペースに接続する
Azure Cosmos DB データベースの接続は、リンクされたサービスとして行われます。 Azure Cosmos DB のリンクされたサービスを使用すると、Azure Synapse Analytics 用の Apache Spark または SQL からデータを参照して探索したり、Azure Cosmos DB に読み書きしたりできます。
データ オブジェクト エクスプローラーから Azure Cosmos DB データベースに直接接続するには、次の手順を実行します。
- [データ] の近くにある + アイコンを選択します。
- [Connect to external data]\(外部データに接続する\) を選択します。
- 接続する API (SQL API、MongoDB 用 API など) を選択します。
- [続行] をクリックします。
- フレンドリ名を使用して、リンクされたサービスに名前を付けます。 この名前は、データ オブジェクト エクスプローラーに表示され、データベースとコンテナーに接続するために Azure Synapse ランタイムによって使用されます。
- Azure Cosmos DB アカウント名とデータベース名を選択します。
- (省略可能) リージョンが指定されていない場合、Azure Synapse ランタイム操作は、分析ストアが有効になっている最も近いリージョンにルーティングされます。 また、ユーザーが Azure Cosmos DB 分析ストアにアクセスするために使用するリージョンを手動で設定することもできます。 [Additional connection properties]\(追加の接続プロパティ\) を選択し、 [新規] を選択します。 [プロパティ名] に「PreferredRegions」と入力します。 [値] を任意のリージョンに設定します (例: WestUS2)。 (単語と数字の間にスペースはありません)。
- ［作成］ を選択します
Azure Cosmos DB データベースは、 [Azure Cosmos DB] セクションの [リンク済み] タブの下に表示されます。 Azure Cosmos DB では、次のアイコンによって、HTAP 対応のコンテナーと OLTP のみのコンテナーを区別できます。
OLTP のみのコンテナー:
HTAP 対応のコンテナー:
コード生成アクションをすばやく操作する
コンテナーを右クリックすると、Spark または SQL ランタイムをトリガーするジェスチャの一覧が表示されます。 コンテナーへの書き込みは、Azure Cosmos DB のトランザクション ストアを通じて行われ、要求ユニットが使用されます。