Azure Purview : Azure Cosmos DB の登録とスキャン

今回は [Azure Cosmos Database (SQL API) の登録とスキャン](https://docs.microsoft.com/ja-jp/azure/purview/register-scan-azure-cosmos-database) の内容を見ていきます。タイトルにもある通り、SQL API のみ現時点ではサポートされています。

# Cosmos DB アカウントの作成とキーの登録

まだ Cosmos DB アカウントがない場合、Azure ポータルのリソース追加より作成します。

1\. Azure Portal より Cosmos DB を追加。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/5160482e-e40d-6b56-c70b-5a79d067301d.png)

2\. 作成の際は、API で「コア SQL」を選択。またテストの場合は Free レベルの割引を利用するとコストが節約可能。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/19466c08-b2ce-41f9-1301-697741bd80c8.png)

3\. 作成完了後、「キー」より「プライマリキー」をコピー。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/9399a4ea-7402-619e-e76b-1e5d8fd6621c.png)

4\. [前回の記事](https://qiita.com/kenakamu/items/4a653fb08714b1a43043#key-vault-%E3%81%AE%E4%BD%9C%E6%88%90) で作成した Key Vault にシークレットを追加。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/13837ae8-d6a6-6edb-5cc7-a85cebae38ac.png)

# データの追加

スキャンする用のデータを追加します。手元にデータソースがない場合、[Cosmos DB : サンプルデータを簡単に作成する](https://qiita.com/kenakamu/items/4598dbf484751d31e967) を参考にデータを作成してください。

# Azure Purview に登録

1\. Azure Purview Studio の「Sources」より、「Register」をクリック。「Azure Cosmos DB (SQL API)」を選択し、「Continue」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/96766cec-d393-4703-abd2-1c7289040919.png)

2\. スキャンする Cosmos DB アカウントを選択して「Register」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/40962023-53de-0d37-afa7-7ee2aa5df39e.png)

3\. 登録後、Cosmos DB のスキャンアイコンをクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/17c8870c-1a9f-2fc5-b066-94acf0a955c6.png)

4\.「Credential」より「New」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/30ede857-103d-f3b8-3608-ad47dd3617fa.png)

5\. 任意の名前を付け、先ほど作成した Key Vault のシークレットを指定。「Create」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/997dc7ab-a1ff-cd82-7acb-f37c0f02ddd2.png)

6\.「Test connection」をクリックして接続を確認。その後「Continue」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/8128a8c8-af39-e019-58fd-621b8e0ac1b0.png)

7\. スキャン対象を選択して「Continue」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/0dc67bd5-c7c6-57bf-0c68-9b6d0d365da7.png)

8\. 既定のスキャンルールを選択して、「Continue」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/384dd135-cfbf-c889-a059-62c002217e3a.png)

9\. トリガーは「Once」を選択して、スキャンを実行。スキャン完了まで待つ。

# スキャン結果の確認

スキャンが完了したら資産を確認していきます。

1\. ホーム画面より「Browse assets」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/b6c3720b-ca2e-f998-befc-c1ce50953d48.png)

2\. 一覧より「Azure Cosmos DB」を選択。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/2eeeef14-139b-a71e-91a5-9923b406449d.png)

3\. スキャンしたアカウントを選択。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/ad0d587e-8ee2-39a6-5c2e-7d6122da8227.png)

4\. データベースとコレクションがスキャンされていることを確認。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/ab1f974a-f1cc-3afd-9b5c-faf5c16dc7e5.png)

5\. コレクションを開き、概要を確認。他の資産同様、階層や名前などが生成されている。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/39043a1b-dbd6-f0b3-5c46-4d659d1681a9.png)

6\. スキーマを確認。Country 列など期待した分類が行われている事を確認。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/df6e3f7e-f6ee-725e-5d4a-4f072d323304.png)

7\. スキーマの編集や連絡先の追加などは他の資産と同様に行える。

# アイテムの検索

次に検索を試してみます。

1\. 上部検索バーで「volcano」を検索。結果として Azure Cosmos DB の結果が出ることを確認。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/bd04c487-2e65-31eb-ae27-0eec20d01b70.png)

2\. 他の資産にも含まれるであろう「region」でも検索を実行。volcanocollection のスキーマに region があるため、検索結果に出ることを確認。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/7233b835-ae73-80ff-e2e1-c1b46f5b8bb3.png)

Cosmos DB の登録とスキャンは認証方法がキーのみであるため、比較的容易に行えました。今後データも Power BI などで直接参照できると良いですね。

次回はスキャン時に利用してきたスキャンルールセットについて見ていきます。

[次の記事へ](https://qiita.com/kenakamu/items/1d6d59222bb2ff23f1fa)
[前の記事へ](https://qiita.com/kenakamu/items/4a653fb08714b1a43043)