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