Azure SQL Database と Azure Synapse Analytics からのデータの共有と受信

適用対象: Azure SQL Database Azure Synapse Analytics (旧称 Azure SQL DW) Azure Synapse Analytics (ワークスペース) SQL プール

Azure Data Share では、Azure SQL Database や Azure Synapse Analytics リソースからのデータ スナップショットを、他の Azure サブスクリプションに安全に共有することができます。 テナントの外部に Azure サブスクリプションを含める。

この記事では、Azure SQL Database および Azure Synapse Analytics らのデータの共有について説明します。

この記事では、以下について説明します。

• 共有できるデータの種類
• 環境を準備する方法
• 共有を作成する方法
• 共有データを受信する方法

目次から必要な項目にジャンプすることもできます、また、この記事を読み進めて最初から最後までプロセスを追うこともできます。

サポートされている機能

データの共有

Azure Data Share は、Azure の複数の SQL リソースからの完全なデータ スナップショットの共有をサポートしています。 これらのリソースでは、増分スナップショットは現在サポートされていません。

データの受信

データ コンシューマーは、共有データをいくつかの Azure リソースに受け入れることを選択できます。

• Azure Data Lake Storage Gen2
• Azure Blob Storage
• Azure SQL データベース
• Azure Synapse Analytics

Azure Data Lake Storage Gen 2 や Azure Blob Storage の共有データは、csv ファイルや parquet ファイルとして保存できます。 完全なデータのスナップショットでは、対象のファイルがすでに存在する場合、その内容が上書きされます。

Azure SQL Database と Azure Synapse Analytics の共有データはテーブルに格納されます。 ターゲット テーブルがまだ存在していない場合、Azure Data Share はソース スキーマで SQL テーブルを作成します。 同じ名前のターゲット テーブルがすでに存在する場合は、そのテーブルは削除され、最新の完全なスナップショットで上書きされます。

サポートされるデータ型

SQL ソースからデータを共有するとき、スナップショットの処理時には、SQL Server のデータ型から Azure Data Share の中間データ型への、以下のマッピングが使用されます。

データを共有するための前提条件

Azure SQL リソースからデータ スナップショットを共有するには、まず環境を整える必要があります。 次が必要です。

• Azure サブスクリプション: Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
• 共有したいテーブルやビューを持つAzure SQL Database または Azure Synapse Analytics (旧 Azure SQL DW)。
• Azure Data Share アカウント
• データ受信者の Azureサインイン情報のメール アドレス (メール エイリアスは無効です)。
• Azure SQL リソースが Azure Data Share アカウントと異なる Azure サブスクリプションにある場合は、ソースの Azure SQL リソースがあるサブスクリプションに Microsoft.DataShare リソースプロバイダ を登録します。

ソース固有の前提条件

データの取得場所に応じて共有するための前提条件もあります。 データ共有のソースを選択し、手順に従ってください。

• Azure SQL Database または Azure Synapse Analytics (旧称 Azure SQL DW)
• Azure Synapse Analytics (ワークスペース) SQL プール

Azure SQL Database または Azure Synapse Analytics (旧称 Azure SQL DW) から共有するための前提条件

Azure SQL Database または Azure Synapse Analytics (旧 Azure SQL DW) での認証には、これらの方法のいずれかを使用できます。

• Microsoft Entra 認証
• SQL 認証

Microsoft Entra 認証

これらの前提条件は、Azure Data Share が Azure SQL Database と接続するために必要な認証について説明しています。

• SQL サーバー上のデータベースへの書き込み権限が必要になります。Microsoft.Sql/servers/databases/write このアクセス許可は、共同作成者ロール内に存在します。
• SQL Server Microsoft Entra 管理者 のアクセス許可。
• SQL Server ファイアウォール アクセス:
  1. Azure portal で、SQL サーバーにナビゲートします。 左側のナビゲーションから [ファイアウォールと仮想ネットワーク] を選択します。
  2. [Azure サービスおよびリソースにこのサーバーへのアクセスを許可する] で [はい] を選択します。
  3. [+クライアント IP の追加] を選びます。 クライアントの IP アドレスは変更される可能性があるため、次回ポータルからデータを共有する際には、再度クライアント IP を追加する必要が生じることがあります。
  4. [保存] を選択します。

SQL 認証

ステップバイステップのデモビデオ に沿って認証を設定するか、それぞれの前提条件を満たすことができます。

• SQL サーバー Microsoft.Sql/servers/databases/write 上のデータベースへの書き込みを許可します。 このアクセス許可は、共同作成者ロール内に存在します。

• Azure Data Share リソースのマネージド ID がデータベースにアクセスするためのアクセス許可:

  1. Azure portalで SQL サーバーに移動し、自分を Microsoft Entra 管理者として設定します。

  2. クエリ エディター、または Microsoft Entra 認証を使用する SQL Server Management Studio を使用して Azure SQL Database/Data Warehouse に接続します。

  3. 次のスクリプトを実行し、Data Share リソースのマネージド ID を db_datareader として追加します。 SQL Server 認証ではなく Active Directory を使用して接続します。

     create user "<share_acct_name>" from external provider;     
     exec sp_addrolemember db_datareader, "<share_acct_name>"; 
     

     Note

     <share_acc_name> は、ご自分の Data Share リソースの名前です。

• 共有するテーブルやビューに移動して選択するための ’db_datareader’ アクセス権を持つ Azure SQL Database ユーザー。

• SQL Server ファイアウォール アクセス:

  1. Azure portal で SQL サーバーに移動します。 左側のナビゲーションから [ファイアウォールと仮想ネットワーク] を選択します。
  2. [Azure サービスおよびリソースにこのサーバーへのアクセスを許可する] で [はい] を選択します。
  3. [+クライアント IP の追加] を選びます。 クライアントの IP アドレスは変更される可能性があるため、次回ポータルからデータを共有する際には、再度クライアント IP を追加する必要が生じることがあります。
  4. [保存] を選択します。

Azure Synapse Analytics (ワークスペース) の SQL プールから共有するための前提条件

• Synapse ワークスペースの SQL プールに対する書き込みアクセス許可: Microsoft.Synapse/workspaces/sqlPools/write このアクセス許可は、共同作成者ロール内に存在します。

• Data Share リソースのマネージド ID が Synapse ワークスペースの SQL プールにアクセスするためのアクセス許可:

  1. Azure portal で、Synapse のワークスペースに移動します。 左側のナビゲーションから SQL Active Directory 管理者を選択し、自分自身を Microsoft Entra 管理者に設定します。

  2. Synapse Studio を開き、左側のナビゲーションから [管理] を選択します。 [セキュリティ] で [アクセス制御] を選択します。 SQL 管理者またはワークスペース管理者ロールを自分に割り当てます。

  3. Synapse Studio で、左側のナビゲーションから [開発] を選択します。 SQL プールで次のスクリプトを実行して、Data Share リソースのマネージド ID を db_datareader として追加します。

     create user "<share_acct_name>" from external provider;     
     exec sp_addrolemember db_datareader, "<share_acct_name>"; 
     

     Note

     <share_acc_name> は、ご自分の Data Share リソースの名前です。

• Synapse ワークスペースのファイアウォール アクセス:

  1. Azure portal で Synapse ワークスペースに移動します。 左側のナビゲーションから [ファイアウォール] を選択します。
  2. [Azure サービスおよびリソースに、このワークスペースへのアクセスを許可する] で [オン] を選びます。
  3. [+クライアント IP の追加] を選びます。 クライアントの IP アドレスは変更される可能性があるため、次回ポータルからデータを共有する際には、再度クライアント IP を追加する必要が生じることがあります。
  4. [保存] を選択します。

共有を作成する

1. Data Share の [概要] ページに移動します。

   

2. [Start sharing your data](データの共有の開始する) を選択します。

3. ［作成］ を選択します

4. 共有の詳細を入力します。 名前、共有の種類、共有の内容の説明、利用規約 (省略可能) を指定します。

   

5. [続行] をクリックします。

6. 共有にデータセットを追加するには、 [データセットの追加] を選択します。

   

7. 追加するデータセットの種類を選択します。 前のステップで選択した共有タイプ (スナップショットまたはインプレース) に応じて、データセット タイプのリストが異なります。

   

8. SQL サーバーまたは Synapse ワークスペースを選択します。 Microsoft Entra 認証を使用していて [Allow Data Share to run the above 'create user' SQL script on my behalf]\(Data Share が上記の 'ユーザーの作成' SQL スクリプトを実行することを許可する\) チェックボックスが表示される場合は、このチェックボックスをオンにします。 SQL 認証を使用している場合は、資格情報を提供し、前提条件に従っていることを確認して、権限を得られるようにしてください。

   [次へ] を選択して共有するオブジェクトに移動し、[データセットの追加] を選択します。 Azure SQL Database と Azure Synapse Analytics (旧称 Azure SQL DW) からのテーブルとビュー、または Azure Synapse Analytics (ワークスペース) 専用 SQL プールからのテーブルを選択できます。

   

9. [Recipients](受信者) タブで、[+ Add Recipient](+ 受信者の追加) を選択して、データ コンシューマーのメール アドレスを入力します。 このメール アドレスは、受信者の Azure サインイン メールである必要があります。

   

10. [続行] をクリックします。

11. スナップショット共有タイプを選択した場合は、データの更新をデータ コンシューマーに提供するスナップショット スケジュールを構成できます。

    

12. 開始時刻と繰り返しの間隔を選択します。

13. [続行] をクリックします。

14. [Review + Create](レビュー + 作成) タブで、パッケージの内容、設定、受信者、および同期の設定を確認します。 [作成] を選択します。

ご自分の Azure Data Share が作成され、データ共有の受信者が招待を受け取れる状態になりました。

データを受信するための前提条件

データ共有の招待を受ける前に、環境を整える必要があります。

データ共有の招待を受け入れる前に、すべての前提条件を満たしていることを確認します。

• Azure サブスクリプション:Azure サブスクリプションをお持ちでない場合は、開始する前に 無料アカウント を作成してください。
• Data Share の招待:" yourdataprovider@domain.com からの Azure Data Share の招待" という件名の Microsoft Azure からの招待。
• Data Share リソースの作成先となる Azure サブスクリプションとターゲット Azure データ ストアがある Azure サブスクリプションで Microsoft.DataShare リソース プロバイダーを登録します。
• 共有データを保存するためには、Azure のリソースが必要です。 次の種類のリソースを使用できます。
  • Azure ストレージ
  • Azure SQL Database
  • Azure Synapse Analytics (以前の Azure SQL DW)
  • Azure Synapse Analytics (ワークスペース) の専用 SQL プール

また、受信したデータが保存されるリソースにも前提条件があります。 リソースの種類を選択し、手順に従ってください。

• Azure Storage 前提条件
• Azure SQL Database または Azure Synapse Analytics (旧称 Azure SQL DW) 前提条件
• Azure Synapse Analytics (ワークスペース) SQL プールの前提条件

ターゲット ストレージ アカウントの前提条件

Azure Storage にデータを受信することを選択した場合は、データ共有を受け入れる前に、以下の前提条件を満たしてください。

• Azure ストレージ アカウント。
• ストレージ アカウントに書き込む権限: これは、Microsoft.Storage/storageAccounts/write に含まれています。 このアクセス許可は、共同作成者ロール内に存在します。
• Data Share リソースのマネージド ID のロール割り当てをストレージ アカウントに追加する権限。これは、Microsoft.Authorization/role assignments/write に含まれています。 このアクセス許可は、所有者ロール内に存在します。

Azure SQL Database または Azure Synapse Analytics (旧称 Azure SQL DW) にデータを受信するための前提条件

SQL サーバーの Microsoft Entra 管理者 である SQL サーバーの場合は、データ共有を受け入れる前に次の前提条件を満たしてください。

• Azure SQL Database または Azure Synapse Analytics (旧称 Azure SQL DW)。
• SQL サーバー Microsoft.Sql/servers/databases/write 上のデータベースへの書き込みを許可します。 このアクセス許可は、共同作成者ロール内に存在します。
• SQL Server ファイアウォール アクセス:
  1. Azure portal で、SQL サーバーにナビゲートします。 左側のナビゲーションから [ファイアウォールと仮想ネットワーク] を選択します。
  2. [Azure サービスおよびリソースにこのサーバーへのアクセスを許可する] で [はい] を選択します。
  3. [+クライアント IP の追加] を選びます。 クライアントの IP アドレスは変更される可能性があるため、次回ポータルからデータを共有する際には、再度クライアント IP を追加する必要が生じることがあります。
  4. [保存] を選択します。

Microsoft Entra 管理者ではない SQL サーバーの場合、データ共有を受け入れる前に以下の前提条件を満たしてください。

前提条件の設定は、ステップバイステップのデモ動画、または以下の手順で行うことができます。

• Azure SQL Database または Azure Synapse Analytics (旧称 Azure SQL DW)。

• SQL サーバー Microsoft.Sql/servers/databases/write 上のデータベースへの書き込みを許可します。 このアクセス許可は、共同作成者ロール内に存在します。

• Data Share リソースのマネージド ID が Azure SQL Database または Azure Synapse Analytics にアクセスするためのアクセス許可:

  1. Azure portalで SQL サーバーに移動し、自分を Microsoft Entra 管理者として設定します。

  2. クエリ エディター、または Microsoft Entra 認証を使用する SQL Server Management Studio を使用して Azure SQL Database/Data Warehouse に接続します。

  3. 次のスクリプトを実行し、Data Share のマネージド ID を "db_datareader、db_datawriter、db_ddladmin" として追加します。

     create user "<share_acc_name>" from external provider; 
     exec sp_addrolemember db_datareader, "<share_acc_name>"; 
     exec sp_addrolemember db_datawriter, "<share_acc_name>"; 
     exec sp_addrolemember db_ddladmin, "<share_acc_name>";
     

     Note

     <share_acc_name> は、ご自分の Data Share リソースの名前です。

• SQL Server ファイアウォール アクセス:

  1. Azure portal で、SQL サーバーに移動し、[ファイアウォールと仮想ネットワーク] を選択します。
  2. [Azure サービスおよびリソースにこのサーバーへのアクセスを許可する] で [はい] を選択します。
  3. [+クライアント IP の追加] を選びます。 クライアントの IP アドレスは変更される可能性があるため、次回ポータルからデータを共有する際には、再度クライアント IP を追加する必要が生じることがあります。
  4. [保存] を選択します。

Azure Synapse Analytics (ワークスペース) の SQL プールにデータを受信するための前提条件

• Azure Synapse Analytics (ワークスペース) の専用 SQL プール。 サーバーレス SQL プールへのデータの受信は、現在サポートされていません。

• Synapse ワークスペースの SQL プールに対する書き込みアクセス許可: Microsoft.Synapse/workspaces/sqlPools/write このアクセス許可は、共同作成者ロール内に存在します。

• Data Share リソースのマネージド ID が Synapse ワークスペースの SQL プールにアクセスするためのアクセス許可:

  1. Azure portal で Synapse ワークスペースに移動します。

  2. 左側のナビゲーションから SQL Active Directory 管理者を選択し、自分自身を Microsoft Entra 管理者に設定します。

  3. Synapse Studio を開き、左側のナビゲーションから [管理] を選択します。 [セキュリティ] で [アクセス制御] を選択します。 SQL 管理者またはワークスペース管理者ロールを自分に割り当てます。

  4. Synapse Studio で、左側のナビゲーションから [開発] を選択します。 SQL プールで次のスクリプトを実行して、Data Share リソースのマネージド ID を "db_datareader、db_datawriter、db_ddladmin" として追加します。

     create user "<share_acc_name>" from external provider; 
     exec sp_addrolemember db_datareader, "<share_acc_name>"; 
     exec sp_addrolemember db_datawriter, "<share_acc_name>"; 
     exec sp_addrolemember db_ddladmin, "<share_acc_name>";
     

     Note

     <share_acc_name> は、ご自分の Data Share リソースの名前です。

• Synapse ワークスペースのファイアウォール アクセス:

  1. Azure portal で Synapse ワークスペースに移動します。 左側のナビゲーションから [ファイアウォール] を選択します。
  2. [Azure サービスおよびリソースに、このワークスペースへのアクセスを許可する] で [オン] を選びます。
  3. [+クライアント IP の追加] を選びます。 クライアントの IP アドレスは変わることがあります。 次回 Azure portal から SQL データを共有するときにも、このプロセスを繰り返すことが必要になる場合もあります。
  4. [保存] を選択します。

共有データの受信

招待を開く

招待は、メールから開くことができるほか、Azure portal から直接開くこともできます。

招待をメールから開くには、受信トレイでデータ プロバイダーからの招待を確認します。 招待は Microsoft Azure からで、件名は " yourdataprovider@domain.com からの Azure Data Share の招待" になっています。 [招待を表示] を選択して、Azure で招待を確認します。

Azure portal から直接招待を開く場合は、Azure portal で Data Share の 招待を検索します。Data Share 招待の一覧が表示されます。

テナントのゲスト ユーザーの場合は、Data Share の招待状を初めて見る前に、テナントのメールアドレスを確認する必要があります。 確認が完了すると、電子メールは 12 か月間有効になります。

次に、表示する共有を選択します。

招待を受け入れる

1. [使用条件] を含む、すべてのフィールドを確認してください。 使用条件に同意する場合は、同意を示すボックスをオンにする必要があります。

   

2. [Target Data Share Account](ターゲット データ共有アカウント) の下で、ご自分のデータ共有のデプロイ先となるサブスクリプションとリソース グループを選択します。

3. [Data Share Account](データ共有アカウント) フィールドには、既存のデータ共有アカウントがない場合には、 [新規作成] を選択します。 それ以外の場合は、自分のデータ共有を受け入れる既存のデータ共有アカウントを選択します。

4. [受信した共有名] フィールドは、用意したデータに指定されている既定値のままにするか、受信した共有のために新しい名前を指定することができます。

5. 利用規約に同意し、受信した共有を管理するための Data Share アカウントを指定したら、 [Accept and configure](受け入れと構成) を選択します。 共有サブスクリプションが作成されます。

   

招待を受け入れたくない場合は、[拒否] を選択します。

受信した共有を構成する

データを受信する場所を構成するには、次の手順に従います。

1. [データセット] タブを選択します。ターゲット先を割り当てるデータセットの横にあるチェックボックスをオンにします。 [+ ターゲットへのマップ] を選択し、ターゲット データ ストアを選択します。

   

2. 共有データを格納するターゲット リソースを選択します。 パスと名前が同じターゲット データ ストア内のすべてのデータ ファイルまたはデータ テーブルが上書きされます。 データを SQL ストアに受け取っていて [Allow Data Share to run the above 'create user' SQL script on my behalf](Data Share が上記の 'ユーザーの作成' SQL スクリプトを実行することを許可する) チェックボックスが表示される場合は、このチェックボックスをオンにします。 それ以外の場合は、前提条件の指示に従って画面に表示されるスクリプトを実行します。 これにより、Data Share リソースの書き込みアクセス許可が対象の SQL DB に付与されます。

   

3. スナップショットベースの共有の場合、データに定期的な更新を提供するためのスナップショット スケジュールがデータ プロバイダーによって作成されていれば、[スナップショット スケジュール] タブを選択して、スナップショット スケジュールを有効にすることもできます。スナップショット スケジュールの横にあるチェック ボックスをオンにし、[+ Enable](+ 有効) を選択します。

   Note

   スケジュールされた最初のスナップショットは、スケジュール時刻から 1 分以内に開始され、次のスナップショットはスケジュール時刻から数秒以内に開始されます。

   

スナップショットをトリガーする

これらの手順は、スナップショットベースの共有にのみ適用されます。

1. スナップショットをトリガーするには、 [詳細] タブ、 [スナップショットのトリガー] の順に選択します。 ここでは、データの完全なスナップショットをトリガーすることができます。 データ プロバイダーから初めてデータを受信する場合は、完全なコピーを選択します。 スナップショットの実行中は、前のスナップショットが完了するまで次のスナップショットが開始されません。

   

2. 最終実行状態が "成功" の場合、ターゲット データ ストアに移動して、受信したデータを表示します。 [データセット] を選んで、ターゲット パスのリンクをクリックします。

   

履歴を表示する

この手順は、スナップショットベースの共有にのみ適用されます。 スナップショットの履歴を表示するには、 [履歴] タブを選択します。ここには、過去 30 日間に生成されたすべてのスナップショットの履歴があります。

スナップショットのパフォーマンス

SQL スナップショットのパフォーマンスは、さまざまな要因の影響を受けます。 常に、独自のパフォーマンス テストを実施することをお勧めします。 パフォーマンスに影響するいくつかの要因の例を下に示します。

• ソースまたはコピー先のデータ ストアの 1 秒あたりの入出力操作数 (IOPS) と帯域幅。
• ソースとターゲットの SQL データ ストアのハードウェア構成 (例: vCores、メモリ、DWU)。
• ソースとターゲットのデータ ストアへの同時アクセス。 同じ SQL データ ストアから複数のテーブルとビューを共有している場合、または複数のテーブルとビューを同じ SQL データ ストアに受信する場合、パフォーマンスに影響します。
• ソースとコピー先のデータ ストア間のネットワーク帯域幅と、ソースとターゲットのデータ ストアの場所。
• 共有するテーブルとビューのサイズ。 SQL スナップショット共有では、テーブル全体の完全なコピーが行われます。 テーブルのサイズが時間の経過と共に増加すると、スナップショットの処理時間が長くなります。

増分更新が必要な大きなテーブルでは、ストレージ アカウントに更新をエクスポートし、ストレージ アカウントの増分共有機能を利用してパフォーマンスを向上させることができます。

スナップショット エラーのトラブルシューティング

スナップショット エラーの最も一般的な原因は、Data Share にソースまたはターゲットのデータ ストアへのアクセス許可がないことです。 ソースまたはターゲットの Azure SQL Database または Azure Synapse Analytics (旧称 Azure SQL DW) へのアクセス許可を Data Share に付与するには、Microsoft Entra 認証を使用して SQL データベースに接続するときに、提供された SQL スクリプトを実行する必要があります。 その他の SQL スナップショット エラーをトラブルシューティングするには、スナップショット エラーのトラブルシューティングに関する記事を参照してください。

次のステップ

Azure Data Share サービスを使用して SQL ソースからデータを共有および受信する方法について学習しました。 他のデータ ソースからの共有の詳細については、サポートされているデータ ストアに関するページに進んでください。