Microsoft Purview で Azure Cosmos DB for SQL API に接続する

[アーティクル]
11/13/2024

この記事では、Azure Cosmos DB データベースソースを認証して操作する手順など、Microsoft Purview で Azure Cosmos DB for SQL API インスタンスを登録してスキャンするプロセスについて説明します

サポートされている機能

メタデータ抽出	フルスキャン	増分スキャン	スコープスキャン	分類	ラベル付け	アクセスポリシー	系統	データ共有	ライブビュー
○	はい	いいえ	○	○	はい	いいえ	いいえ**	いいえ	いいえ

** データセットが Data Factory Copy アクティビティのソース/シンクとして使用されている場合は、系列がサポートされます

前提条件

アクティブなサブスクリプションを持つ Azure アカウント。無料でアカウントを作成します。
アクティブな Microsoft Purview アカウント。
Microsoft Purview ガバナンスポータルでソースを登録して管理するには、データソース管理者およびデータ閲覧者である必要があります。詳細については、 Microsoft Purview のアクセス許可に関するページを参照してください。

登録

このセクションでは、Azure Cosmos DB for SQL API インスタンスを登録し、適切な認証メカニズムを設定して、データソースを正常にスキャンできるようにします。

登録手順

データソースのスキャンを設定する前に、Microsoft Purview でデータソースを登録することが重要です。

次の方法で Microsoft Purview ガバナンスポータルを開きます。
- https://web.purview.azure.comに直接移動し、Microsoft Purview アカウントを選択します。
- Azure portalを開き、Microsoft Purview アカウントを検索して選択します。 [Microsoft Purview ガバナンスポータル] ボタンを選択します。
データマップ --> コレクションに移動します
[コレクション] メニューを使用してコレクション階層を作成し、必要に応じて個々のサブコレクションにアクセス許可を割り当てます
[ ソース ] メニューの適切なコレクションに移動し、[ 登録 ] アイコンを選択して新しい Azure Cosmos DB データベースを登録します
Azure Cosmos DB for SQL API データソースを選択し、[続行] を選択します
データソースに適した名前を指定し、関連する Azure サブスクリプション、Cosmos DB アカウント名、コレクションを選択し、[適用] を選択します
選択したコレクションの下に Azure Cosmos DB データベース ストレージアカウントが表示されます

スキャン

スキャンの認証

データソースをスキャンするためのアクセス権を持つためには、Azure Cosmos DB データベースストレージアカウントの認証方法を構成する必要があります。

Azure Cosmos DB Database の認証を設定する方法は 1 つだけです。

アカウントキー - Microsoft Purview がシークレットを使用してデータソースを安全にスキャンできるように、資格情報を格納するために、Azure Key Vault内にシークレットを作成できます。シークレットには、ストレージアカウントキー、SQL ログインパスワード、またはパスワードを指定できます。

注:

サブスクリプションに Azure キーコンテナー リソースをデプロイし、必要なアクセス許可を持つ Microsoft Purview アカウントの MSI を Azure キーコンテナー内のシークレットに割り当てる必要があります。

スキャンにアカウントキーを使用する

アクセスキーを取得し、キーコンテナーに格納する必要があります。

Azure Cosmos DB データベースストレージアカウントに移動します
[設定] > [キー] を選択します
キーをコピーし、次の手順で個別に保存します
キーコンテナーに移動する
[シークレット>設定] を選択し、[+ 生成/インポート] を選択します
ストレージアカウントのキーとして [名前] と [値] を入力し、[作成] を選択して完了します
キーコンテナーがまだ Microsoft Purview に接続されていない場合は、新しいキーコンテナー接続を作成する必要があります
最後に、キーを使用して新しい資格情報を作成してスキャンを設定します。

スキャンの作成

Microsoft Purview アカウントを開き、[Microsoft Purview ガバナンスポータルを開く] を選択します
[データマップ] -->[ソース] に移動してコレクション階層を表示します
先ほど登録した Azure Cosmos データベースの下にある [新しいスキャン] アイコンを選択します
スキャンの [名前] を指定します。
ソースがパブリックにアクセス可能な場合は Azure 統合ランタイム、マネージド仮想ネットワークを使用する場合はマネージド仮想ネットワーク統合ランタイム、ソースがプライベート仮想ネットワークにある場合はセルフホステッド統合ランタイムのいずれかを選択します。使用する統合ランタイムの詳細については、適切な統合ランタイム構成の選択に関する記事を参照してください。
スキャンに適したコレクションを選択し、[資格情報] で [+ 新規] を選択します。
アカウントキーの作成時に使用された適切な Key Vault 接続 と シークレット名 を選択 します。 [アカウントキー] として [認証方法] を選択します
[ 接続のテスト] を選択します。接続が正常に完了したら、[続行] を選択 します