Microsoft Purview で Azure Synapse Analytics ワークスペースに接続して管理する

この記事では、Azure Synapse Analytics ワークスペースを登録する方法について説明します。また、Microsoft Purview で Azure Synapse Analytics ワークスペースを認証して操作する方法についても説明します。 Microsoft Purview の詳細については、こちらをご覧ください。

注:

専用 SQL プール (旧称 SQL DW) と専用 SQL プールは、Azure Synapse ワークスペースにあります。 2 つの違いの詳細については、「Azure Synapse ワークスペースの専用 SQL プール (SQL DW) と専用 SQL プールの違いは何ですか」を参照してください。現在、Microsoft Purview では、専用 SQL プール (旧称 SQL DW) と専用 SQL プールに個別のデータソースが用意されています。

専用 SQL プール (旧称 SQL DW) を登録してスキャンするには、「 Microsoft Purview で専用 SQL プールに接続して管理する」を参照してください。
「専用 SQL プール (旧称 SQL DW) のAzure Synapseワークスペース機能を有効にする」で説明されているように、Azure Synapseワークスペース機能を有効にした専用 SQL プール (旧称 SQL DW) を登録してスキャンするには、「Microsoft Purview で Azure Synapse Analytics ワークスペースに接続して管理する」を参照してください。
Azure Synapse ワークスペースで専用 SQL プールまたはサーバーレス SQL プールを登録してスキャンするには、「Microsoft Purview で Azure Synapse Analytics ワークスペースに接続して管理する」を参照してください。

サポートされている機能

スキャン機能

メタデータ抽出	フルスキャン	増分スキャン	スコープスキャン
○	○	はい	いいえ

Azure Synapse Analytics Lake データベースは現在サポートされていません。これらのデータベースのスキャンされた資産に不整合が生じる場合があります。

外部テーブルの場合、Azure Synapse Analytics では現在、それらのテーブルと元のファイルのリレーションシップはキャプチャされません。

その他の機能

分類、秘密度ラベル、ポリシー、データ系列、ライブビューについては、サポートされている機能の一覧を参照してください。

前提条件

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

登録

次の手順では、Microsoft Purview ガバナンスポータルを使用して、Azure Synapse Analytics ワークスペースを Microsoft Purview に登録する方法について説明します。

Synapse Analytics ワークスペースを登録するには、少なくとも Synapse Analytics ワークスペースのデータ閲覧者ロールが必要であり、Microsoft Purview のデータソース管理者である必要があります。

Microsoft Purview ガバナンスポータルを開き、Microsoft Purview アカウントを選択します。

または、Azure portalに移動し、Microsoft Purview アカウントを検索して選択し、[Microsoft Purview ガバナンスポータル] ボタンを選択します。
左側のウィンドウで、[ソース] を選択 します。
[登録] を選択します。
[ソースの登録] で、[Azure Synapse Analytics (複数)] を選択します。
[続行] を選択します。
[ソースの登録 (Azure Synapse Analytics)] ページで、次の操作を行います。
1. [名前] に、Microsoft Purview 統合カタログに一覧表示するデータソースの名前を入力します。
2. 必要に応じて、Azureサブスクリプションの場合は、フィルター処理するサブスクリプションを選択します。
3. [ ワークスペース名] で、操作しているワークスペースを選択します。
  
  SQL エンドポイントのボックスは、ワークスペースの選択に基づいて自動的に入力されます。
4. 一覧からコレクションを選択します。
5. [ 登録] を選択して、データソースの登録を完了します。

スキャン

次の手順を使用して、Azure Synapse Analytics ワークスペースをスキャンして、資産を自動的に識別し、データを分類します。一般的なスキャンの詳細については、「 Microsoft Purview でのスキャンとインジェスト」を参照してください。

専用リソースまたはサーバーレスリソースを列挙するための認証を設定します。認証を設定することで、Microsoft Purview はワークスペース資産を列挙し、スキャンを実行できます。
アクセス許可を適用して、ワークスペースの内容をスキャンします。
Microsoft Purview へのアクセスを許可するようにネットワークが設定されていることを確認します。

列挙認証

認証を設定するには、次の手順に従います。指定したロールを追加するには、所有者またはユーザーアクセス管理者である必要があります。

専用 SQL データベースリソースを列挙するための認証

Azure portalで、Azure Synapse Analytics ワークスペースリソースに移動します。
左側のウィンドウで、[Access Control (IAM)] を選択します。
[追加] ボタンを選択します。
閲覧者ロールを設定し、マネージドサービス ID (MSI) を表す Microsoft Purview アカウント名を入力します。
[ 保存] を 選択して、ロールの割り当てを完了します。

専用 SQL プール (旧称 SQL DW) のAzure Synapse ワークスペース機能を有効にするに関するページに記載されているように、Azure Synapse Analytics ワークスペース機能を有効にした専用 SQL プール (旧称 SQL DW) をスキャンする場合は、専用 SQL プール (旧称 SQL DW) に対して次の追加の構成手順に従います。

Azure portalで、専用 SQL プール (旧称 SQL DW) に関連付けられているSQL Server リソースに移動します。
左側のウィンドウで、[Access Control (IAM)] を選択します。
[追加] ボタンを選択します。
閲覧者ロールを設定し、マネージドサービス ID (MSI) を表す Microsoft Purview アカウント名を入力します。
[ 保存] を 選択して、ロールの割り当てを完了します。

注:

Microsoft Purview アカウントで複数のAzure Synapse Analytics ワークスペースを登録してスキャンする予定の場合は、リソースグループやサブスクリプションなど、より高いレベルからロールを割り当てることもできます。

サーバーレス SQL Database リソースを列挙するための認証

Microsoft Purview がサーバーレス SQL Database リソースを列挙できるように、認証を 3 か所に設定します。

Azure Synapse Analytics ワークスペースの認証を設定するには:

Azure portalで、Azure Synapse Analytics ワークスペースリソースに移動します。
左側のウィンドウで、[Access Control (IAM)] を選択します。
[追加] ボタンを選択します。
閲覧者ロールを設定し、MSI を表す Microsoft Purview アカウント名を入力します。
[ 保存] を 選択して、ロールの割り当てを完了します。

ストレージアカウントの認証を設定するには:

Azure portalで、Azure Synapse Analytics ワークスペースに関連付けられているストレージアカウントを含むリソースグループまたはサブスクリプションに移動します。
左側のウィンドウで、[Access Control (IAM)] を選択します。
[追加] ボタンを選択します。
[ストレージ BLOB データ閲覧者] ロールを設定し、[選択] ボックスに Microsoft Purview アカウント名 (MSI を表します) を入力します。
[ 保存] を 選択して、ロールの割り当てを完了します。

Azure Synapse Analytics サーバーレスデータベースの認証を設定するには:

Azure Synapse Analytics ワークスペースに移動し、Synapse Studioを開きます。
左側のウィンドウで、[データ] を選択 します。
いずれかのデータベースの横にある省略記号 (...) を選択し、新しい SQL スクリプトを開始します。
SQL スクリプトで次のコマンドを実行して、サーバーレス SQL データベースに Microsoft Purview アカウント MSI (アカウント名で表される) を追加します。
```
CREATE LOGIN [PurviewAccountName] FROM EXTERNAL PROVIDER;
```

アクセス許可を適用してワークスペースの内容をスキャンする

Azure Synapse Analytics ワークスペースから登録してスキャンする各SQL Databaseで認証を設定する必要があります。アクセス許可を適用する手順については、次のシナリオを参照してください。

重要

サーバーレスデータベースの次の手順は、レプリケートされたデータベースには適用されません。 Azure Synapse Analytics では、Spark データベースからレプリケートされるサーバーレスデータベースは現在、読み取り専用です。詳細については、「レプリケートされたデータベースに対する操作が許可されていません」を参照してください。

専用 SQL データベースにマネージド ID を使用する

重要

セルフホステッド統合ランタイムを使用してプライベートネットワーク上のリソースに接続する場合、マネージド ID は機能しません。サービスプリンシパル認証または SQL 認証を使用する必要があります。

次の手順でコマンドを実行するには、ワークスペースのAzure Synapse管理者である必要があります。 Azure Synapse Analytics アクセス許可の詳細については、「Azure Synapse Analytics ワークスペースのアクセス制御を設定する」を参照してください。

Azure Synapse Analytics ワークスペースに移動します。
[ データ ] セクションに移動し、専用 SQL データベースのいずれかを探します。
データベース名の横にある省略記号 (...) を選択し、新しい SQL スクリプトを開始します。
SQL スクリプトで次のコマンドを実行して、専用 SQL データベースに Microsoft Purview アカウント MSI (アカウント名で表される) を db_datareader として追加します。
```
CREATE USER [PurviewAccountName] FROM EXTERNAL PROVIDER
GO

EXEC sp_addrolemember 'db_datareader', [PurviewAccountName]
GO
```

SQL スクリプトで次のコマンドを実行して、ロールの追加を確認します。

SELECT p.name AS UserName, r.name AS RoleName
FROM sys.database_principals p
LEFT JOIN sys.database_role_members rm ON p.principal_id = rm.member_principal_id
LEFT JOIN sys.database_principals r ON rm.role_principal_id = r.principal_id
WHERE p.authentication_type_desc = 'EXTERNAL'
ORDER BY p.name;

スキャンするデータベースごとに同じ手順に従います。

サーバーレス SQL データベースにマネージド ID を使用する

Azure Synapse Analytics ワークスペースに移動します。
[ データ ] セクションに移動し、いずれかの SQL データベースを選択します。
データベース名の横にある省略記号 (...) を選択し、新しい SQL スクリプトを開始します。
SQL スクリプトで次のコマンドを実行して、Microsoft Purview アカウント MSI (アカウント名で表される) をサーバーレス SQL データベースに db_datareader として追加します。
```
CREATE USER [PurviewAccountName] FOR LOGIN [PurviewAccountName];
ALTER ROLE db_datareader ADD MEMBER [PurviewAccountName]; 
```

SQL スクリプトで次のコマンドを実行して、ロールの追加を確認します。

SELECT p.name AS UserName, r.name AS RoleName
FROM sys.database_principals p
LEFT JOIN sys.database_role_members rm ON p.principal_id = rm.member_principal_id
LEFT JOIN sys.database_principals r ON rm.role_principal_id = r.principal_id
WHERE p.authentication_type_desc = 'EXTERNAL'
ORDER BY p.name;

スキャンするデータベースごとに同じ手順に従います。

外部テーブルに資格情報を使用するアクセス許可を付与する

Synapse Analytics ワークスペースに外部テーブルがある場合は、外部テーブルのスコープ資格情報に対する Microsoft Purview マネージド ID 参照アクセス許可を付与する必要があります。 [参照] アクセス許可を使用すると、Microsoft Purview は外部テーブルからデータを読み取ることができます。

SQL スクリプトで次のコマンドを実行して、データベーススコープの資格情報の一覧を取得します。
```
Select name, credential_identity
from sys.database_scoped_credentials;
```
データベーススコープの資格情報へのアクセスを許可するには、次のコマンドを実行します。 scoped_credentialをデータベーススコープの資格情報の名前に置き換えます。
```
GRANT REFERENCES ON DATABASE SCOPED CREDENTIAL::[scoped_credential] TO [PurviewAccountName];
```

アクセス許可の割り当てを確認するには、SQL スクリプトで次のコマンドを実行します。

SELECT dp.permission_name, dp.grantee_principal_id, p.name AS grantee_principal_name
FROM sys.database_permissions AS dp
JOIN sys.database_principals AS p ON dp.grantee_principal_id = p.principal_id
JOIN sys.database_scoped_credentials AS c ON dp.major_id = c.credential_id;

専用 SQL データベースにサービスプリンシパルを使用する

「Microsoft Purview のソース認証の資格情報」の手順に従って、サービスプリンシパルの種類の新しい資格情報を設定します。
Azure Synapse Analytics ワークスペースに移動します。
[ データ ] セクションに移動し、専用 SQL データベースのいずれかを探します。
データベース名の横にある省略記号 (...) を選択し、新しい SQL スクリプトを開始します。
SQL スクリプトで次のコマンドを実行して、専用 SQL データベースにサービスプリンシパル ID を db_datareader として追加します。
```
CREATE USER [ServicePrincipalID] FROM EXTERNAL PROVIDER
GO

EXEC sp_addrolemember 'db_datareader', [ServicePrincipalID]
GO
```

Azure Synapse Analytics ワークスペース内のすべての専用 SQL データベースに対して前の手順を繰り返します。

サーバーレス SQL データベースにサービスプリンシパルを使用する

Azure Synapse Analytics ワークスペースに移動します。
[ データ ] セクションに移動し、サーバーレス SQL データベースのいずれかを探します。
データベース名の横にある省略記号 (...) を選択し、新しい SQL スクリプトを開始します。
SQL スクリプトで次のコマンドを実行して、サーバーレス SQL データベースにサービスプリンシパル ID を追加します。
```
CREATE LOGIN [ServicePrincipalID] FROM EXTERNAL PROVIDER;
```
SQL スクリプトで次のコマンドを実行して、スキャンする各サーバーレス SQL データベースにサービスプリンシパル ID を db_datareader として追加します。
```
 CREATE USER [ServicePrincipalID] FOR LOGIN [ServicePrincipalID];
 ALTER ROLE db_datareader ADD MEMBER [ServicePrincipalID]; 
```

専用 SQL データベースに SQL 認証を使用する

「Microsoft Purview のソース認証の資格情報」の手順に従って、SQL 認証の種類の新しい資格情報を設定します。
Azure Synapse Analytics ワークスペースに移動します。
[ データ ] セクションに移動し、専用 SQL データベースのいずれかを探します。
データベース名の横にある省略記号 (...) を選択し、新しい SQL スクリプトを開始します。
SQL スクリプトで次のコマンドを実行して、SQL 認証ログイン名を専用 SQL データベースに db_datareader として追加します。
```
CREATE USER [SQLUser] FROM LOGIN [SQLUser];
GO

EXEC sp_addrolemember 'db_datareader', [SQLUser]; 
GO
```

Azure Synapse Analytics ワークスペース内のすべての専用 SQL データベースに対して前の手順を繰り返します。

サーバーレス SQL データベースに SQL 認証を使用する

Azure Synapse Analytics ワークスペースに移動します。
[ データ ] セクションに移動し、サーバーレス SQL データベースのいずれかを探します。
データベース名の横にある省略記号 (...) を選択し、新しい SQL スクリプトを開始します。
SQL スクリプトで次のコマンドを実行して、サーバーレス SQL データベースに SQL 認証ログイン名を追加します。
```
CREATE USER [SQLUser] FROM LOGIN [SQLUser];
GO
```
SQL スクリプトで次のコマンドを実行して、スキャンする各サーバーレス SQL データベースにサービスプリンシパル ID を db_datareader として追加します。
```
ALTER ROLE db_datareader ADD MEMBER [SQLUser];
GO
```

Azure Synapse Analytics ワークスペースのファイアウォールアクセスを設定する

Azure portalで、[Azure Synapse Analytics] ワークスペースに移動します。
左側のウィンドウで、[ ネットワーク] を選択します。
[Azure サービスとリソースがこのワークスペースにアクセスできるようにする] で、[オン] を選択します。
[保存] を選択します。

Azure portalで、専用 SQL プール (旧称 SQL DW) に関連付けられているSQL Server リソースに移動します。
左側のウィンドウで、[ ネットワーク] を選択します。
[サービスとリソースAzureこのサーバーへのアクセスを許可する] で、[オン] を選択します。
[保存] を選択します。

重要

Azure Synapse Analytics ワークスペースで [Azure サービスとリソースにこのワークスペースへのアクセスを許可する] を有効にできない場合、Microsoft Purview ガバナンスポータルでスキャンを設定すると、サーバーレスデータベース列挙エラーが発生します。この場合は、[ 手動で入力 ] オプションを選択して、スキャンするデータベース名を指定し、 API を使用してスキャンを続行または設定できます。

スキャンを作成して実行する

Microsoft Purview ガバナンスポータルの左側のウィンドウで、[データマップ] を選択します。
登録したデータソースを選択します。
[ 詳細の表示] を選択し、[ 新しいスキャン] を選択します。または、ソースタイルの [クイックアクションのスキャン ] アイコンを選択することもできます。
[ スキャン の詳細] ウィンドウの [名前 ] ボックスに、スキャンの名前を入力します。

注:

統合ランタイムの場合、 Managed VNet Runtime を使用している場合は、必要なマネージドプライベートエンドポイントを作成してください。

サーバーレスプールをスキャンするには、Synapse ワークスペースの sqlOnDemand サブリソースの種類のマネージドプライベートエンドポイントを作成します。
専用プールをスキャンするには、Synapse ワークスペースの sql サブリソースの種類のマネージドプライベートエンドポイントを作成します。
サーバーレスプールと専用プールの両方をスキャンする場合は、マネージドプライベートエンドポイントの両方を作成する必要があります。ウィザードで 1 つを選択します。

[ 資格情報 ] ドロップダウンリストで、データソース内のリソースに接続する資格情報を選択します。
[ データベースの選択方法] で、[ Synapse ワークスペースから ] または [ 手動で入力] を選択します。既定では、Microsoft Purview はワークスペースの下にあるデータベースの列挙を試み、スキャンするデータベースを選択できます。

Microsoft Purview がサーバーレスデータベースの読み込みに失敗したことを示すエラーが発生した場合は、[Enter] を 手動で 選択して、データベースの種類 (専用またはサーバーレス) と対応するデータベース名を指定できます。
[ 接続のテスト] を選択して、設定を検証します。エラーが発生した場合は、レポートページで接続状態にマウスポインターを合わせて詳細を表示します。
[続行] を選択します。
[SQL Azure Synapse種類のスキャンルールセット] を選択します。スキャンルールセットをインラインで作成することもできます。
スキャントリガーを選択します。スケジュールを設定することも、スキャンを 1 回実行することもできます。
スキャンを確認し、[ 保存 ] を選択してセットアップを完了します。

スキャンとスキャンの実行を表示する

既存のスキャンを表示するには:

Microsoft Purview ポータルに移動します。左側のウィンドウで、[ データマップ] を選択します。
データソースを選択します。 [最近のスキャン] で、そのデータソースの既存の スキャンの一覧を表示したり、[ スキャン ] タブですべてのスキャンを表示したりできます。
表示する結果を含むスキャンを選択します。このウィンドウには、以前のすべてのスキャン実行と、各スキャン実行の状態とメトリックが表示されます。
実行 ID を選択して、スキャン実行の詳細をチェックします。

スキャンを管理する

スキャンを編集、取り消し、または削除するには:

Microsoft Purview ポータルに移動します。左側のウィンドウで、[ データマップ] を選択します。
データソースを選択します。 [最近のスキャン] で、そのデータソースの既存の スキャンの一覧を表示したり、[ スキャン ] タブですべてのスキャンを表示したりできます。
管理するスキャンを選択します。次のことを実行できます。
- [スキャンの編集] を選択して スキャンを編集します。
- [スキャンの実行の取り消し] を選択して、進行中 のスキャンを取り消します。
- [スキャンの削除] を選択して スキャンを削除します。

注:

スキャンを削除しても、以前のスキャンから作成されたカタログ資産は削除されません。

API を使用してスキャンを設定する

Microsoft Purview REST API を使用してサーバーレスデータベースのスキャンを作成する例を次に示します。かっこ ({}) のプレースホルダーを実際の設定に置き換えます。詳細については、「スキャン - 作成または更新」を参照してください。

PUT https://{purview_account_name}.purview.azure.com/scan/datasources/<data_source_name>/scans/{scan_name}?api-version=2022-02-01-preview

次のコードでは、 collection_id はコレクションのフレンドリ名ではありません。これは 5 文字の ID です。ルートコレクションの場合、 collection_id はコレクションの名前です。すべてのサブコレクションについて、次のいずれかの場所で見つけることができる ID です。

Microsoft Purview ガバナンスポータルの URL。コレクションを選択し、URL をチェックして collection=と表示される場所を見つけます。それがあなたの ID です。次の例では、 Investment コレクションの ID は 50h55c です。
ルートコレクションの子コレクション名を一覧表示してコレクションを一覧表示し、フレンドリ名の代わりに名前を使用できます。

{
    "properties":{
        "resourceTypes":{
            "AzureSynapseServerlessSql":{
                "scanRulesetName":"AzureSynapseSQL",
                "scanRulesetType":"System",
                "resourceNameFilter":{
                    "resources":[ "{serverless_database_name_1}", "{serverless_database_name_2}", ...]
                }
            }
        },
        "credential":{
            "referenceName":"{credential_name}",
            "credentialType":"SqlAuth | ServicePrincipal | ManagedIdentity (if UAMI authentication)"
        },
        "collection":{
            "referenceName":"{collection_id}",
            "type":"CollectionReference"
        },
        "connectedVia":{
            "referenceName":"{integration_runtime_name}",
            "integrationRuntimeType":"SelfHosted (if self-hosted IR) | Managed (if VNet IR)"
        }
    },
    "kind":"AzureSynapseWorkspaceCredential | AzureSynapseWorkspaceMsi (if system-assigned managed identity authentication)"
}

スキャンをスケジュールするには、スキャンの作成後にそのトリガーを作成します。詳細については、「トリガー - トリガーの作成」を参照してください。

トラブルシューティング

スキャンに問題がある場合:

すべての前提条件に従っていることを確認します。
リソースの列挙認証を設定したことを確認します。
認証を設定したことを確認します。
ファイアウォールの設定を確認して、ネットワークを確認します。
スキャンのトラブルシューティングに関するドキュメントを確認してください。

次の手順

ソースを登録したら、次のガイドを使用して、Microsoft Purview とデータの詳細を確認します。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-02-25