マネージド ID を使用して連続エクスポート ジョブを実行する

1. ユーザー割り当て IDを追加する手順に従います。

2. Azure portal のマネージド ID リソースの左側のメニューで、[プロパティ]選択します。 次の手順で使用するために、テナント ID と プリンシパル ID をコピーして保存します。

   

3. 次の .alter-merge policy managed_identity コマンド 実行し、 を前の手順のマネージド ID オブジェクト ID に置き換えます。 このコマンドは、クラスターで マネージド ID ポリシー を設定します。これにより、マネージド ID を連続エクスポートで使用できるようになります。

   .alter-merge cluster policy managed_identity ```[
       {
         "ObjectId": "<objectId>",
         "AllowedUsages": "AutomatedFlows"
       }
   ]```
   

   手記

   特定のデータベースにポリシーを設定するには、clusterの代わりに database <DatabaseName> を使用します。

4. 次のコマンドを実行して、外部テーブルを含むデータベースなど、連続エクスポートに使用されるすべてのデータベースに対して、マネージド ID データベース ビューアー アクセス許可を付与します。

   .add database <DatabaseName> viewers ('aadapp=<objectId>;<tenantId>')
   

   <DatabaseName> を関連するデータベースに置き換え、<objectId> 手順 2 のマネージド ID プリンシパル ID に置き換え、手順 2 の Microsoft Entra ID テナント ID に <tenantId> します。

1. システム割り当て IDを追加する手順に従います。

2. 後の手順で使用するために、オブジェクト (プリンシパル) ID をコピーして保存します。

3. 次の .alter-merge policy managed_identity コマンドを実行します。 このコマンドは、クラスターで マネージド ID ポリシー を設定します。これにより、マネージド ID を連続エクスポートで使用できるようになります。

   .alter-merge cluster policy managed_identity ```[
       {
         "ObjectId": "system",
         "AllowedUsages": "AutomatedFlows"
       }
   ]```
   

   手記

   特定のデータベースにポリシーを設定するには、clusterの代わりに database <DatabaseName> を使用します。

4. 次のコマンドを実行して、外部テーブルを含むデータベースなど、連続エクスポートに使用されるすべてのデータベースに対して、マネージド ID データベース ビューアー アクセス許可を付与します。

   .add database <DatabaseName> viewers ('aadapp=<objectId>')
   

   <DatabaseName> を関連するデータベースに置き換え、<objectId> を、手順 2 のマネージド ID オブジェクト (プリンシパル) ID に置き換えます。

1. ストレージ接続文字列テンプレートに基づいて接続文字列を作成します。 この文字列は、アクセスするリソースとその認証情報を示します。 連続エクスポート フローの場合は、偽装認証することをお勧めします。

2. .create または .alter external table コマンドを実行してテーブルを作成します。 前の手順の接続文字列を、storageConnectionString 引数として使用します。

   たとえば、次のコマンドは、Azure Blob Storage の mystorageaccount の mycontainer で CSV 形式のデータを参照する MyExternalTable を作成します。 テーブルには 2 つの列があり、1 つは整数 x 用、1 つは文字列 s用です。 接続文字列は ;impersonateで終わります。これは、偽装認証を使用してデータ ストアにアクセスすることを示します。

   .create external table MyExternalTable (x:int, s:string) kind=storage dataformat=csv 
   ( 
       h@'https://mystorageaccount.blob.core.windows.net/mycontainer;impersonate' 
   )
   

3. 関連する外部データ ストアに対するマネージド ID の書き込みアクセス許可を付与します。 継続的エクスポート ジョブはマネージド ID に代わってデータ ストアにデータをエクスポートするため、マネージド ID には書き込みアクセス許可が必要です。

   外部データ ストア	必要なアクセス許可	アクセス許可を付与する
   Azure Blob Storage	ストレージ BLOB データ共同作成者	azure ロール を割り当てる
   Data Lake Storage Gen2	ストレージ BLOB データ共同作成者	azure ロール を割り当てる
   Data Lake Storage Gen1	投稿者	azure ロール を割り当てる

1. SQL Server 接続文字列を作成します。 この文字列は、アクセスするリソースとその認証情報を示します。 連続エクスポート フローの場合は、偽装認証である Microsoft Entra 統合認証を することをお勧めします。

2. .create または .alter external table コマンドを実行してテーブルを作成します。 前の手順の接続文字列を、sqlServerConnectionString 引数として使用します。

   たとえば、次のコマンドでは、SQL Server の MyDatabase でテーブル MySqlTable 参照する MySqlExternalTable を作成します。 テーブルには 2 つの列があり、1 つは整数 x 用、1 つは文字列 s用です。 接続文字列には ;Authentication=Active Directory Integratedが含まれています。これは、偽装認証を使用してテーブルにアクセスすることを示します。

   .create external table MySqlExternalTable (x:int, s:string) kind=sql table=MySqlTable
   ( 
      h@'Server=tcp:myserver.database.windows.net,1433;Authentication=Active Directory Integrated;Initial Catalog=MyDatabase;'
   )
   

3. SQL Server データベースに対するマネージド ID の CREATE、UPDATE、INSERT のアクセス許可を付与します。 継続的エクスポート ジョブはマネージド ID の代わりにデータをデータベースにエクスポートするため、マネージド ID には書き込みアクセス許可が必要です。 詳細については、「アクセス許可の」を参照してください。

managedIdentity プロパティをマネージド ID オブジェクト ID に設定して、.create-or-alter continuous-export コマンドを実行します。

たとえば、次のコマンドは、MyExport という名前の連続エクスポート ジョブを作成し、ユーザー割り当てマネージド ID の代わりに MyTable のデータを MyExternalTable にエクスポートします。 <objectId> はマネージド ID オブジェクト ID である必要があります。

.create-or-alter continuous-export MyExport over (MyTable) to table MyExternalTable with (managedIdentity=<objectId>, intervalBetweenRuns=5m) <| MyTable

managedIdentity プロパティを systemに設定して、.create-or-alter continuous-export コマンドを実行します。

たとえば、次のコマンドは、MyExport という名前の連続エクスポート ジョブを作成し、システム割り当てマネージド ID の代わりに MyTable 内のデータを MyExternalTable にエクスポートします。

.create-or-alter continuous-export MyExport over (MyTable) to table MyExternalTable with (managedIdentity="system", intervalBetweenRuns=5m) <| MyTable