Usar uma identidade gerenciada para executar um trabalho de exportação contínua

1. Siga as etapas para Adicionar uma identidade atribuída pelo usuário.

2. No portal do Azure, no menu esquerdo do seu recurso de identidade gerenciado, selecione Propriedades. Copie e salve o de Id do Locatário do e de ID Principal para uso nas etapas a seguir.

   

3. Execute o seguinte comando .alter-merge policy managed_identity, substituindo-<objectId> pelo ID do objeto de identidade gerenciado da etapa anterior. Este comando define uma de política de identidade gerenciada no cluster que permite que a identidade gerenciada seja usada com exportação contínua.

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

   Observação

   Para definir a política em um banco de dados específico, use database <DatabaseName> em vez de cluster.

4. Execute o seguinte comando para conceder à identidade gerenciada permissões do Visualizador de Banco de Dados sobre todos os bancos de dados usados para a exportação contínua, como o banco de dados que contém a tabela externa.

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

   Substitua <DatabaseName> pelo banco de dados relevante, <objectId> pela identidade gerenciada de ID Principal da etapa 2 e <tenantId> pela ID do Microsoft Entra de ID do Locatário da etapa 2.

1. Siga as etapas para Adicionar uma identidade atribuída pelo sistema.

2. Copie e salve o de ID do objeto (principal) para uso em uma etapa posterior.

3. Execute o seguinte comando managed_identity de política .alter-merge . Este comando define uma de política de identidade gerenciada no cluster que permite que a identidade gerenciada seja usada com exportação contínua.

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

   Observação

   Para definir a política em um banco de dados específico, use database <DatabaseName> em vez de cluster.

4. Execute o seguinte comando para conceder à identidade gerenciada permissões do Visualizador de Banco de Dados sobre todos os bancos de dados usados para a exportação contínua, como o banco de dados que contém a tabela externa.

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

   Substitua <DatabaseName> pelo banco de dados relevante e <objectId> pela identidade gerenciada ID do objeto (principal) da etapa 2.

1. Crie uma cadeia de conexão com base nos modelos de cadeia de conexão de armazenamento . Essa cadeia de caracteres indica o recurso a ser acessado e suas informações de autenticação. Para fluxos de exportação contínuos, recomendamos autenticação de representação.

2. Execute o comando tabela externa .create ou .alter para criar a tabela. Use a cadeia de conexão da etapa anterior como o argumento storageConnectionString.

   Por exemplo, o comando a seguir cria MyExternalTable que se refere a dados formatados em CSV em mycontainer de mystorageaccount no Armazenamento de Blobs do Azure. A tabela tem duas colunas, uma para um x inteiro e outra para uma cadeia de caracteres s. A cadeia de conexão termina com ;impersonate, que indica usar a autenticação de representação para acessar o armazenamento de dados.

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

3. Conceda permissões de gravação de identidade gerenciada sobre o armazenamento de dados externo relevante. A identidade gerenciada precisa de permissões de gravação porque o trabalho de exportação contínua exporta dados para o armazenamento de dados em nome da identidade gerenciada.

   Armazenamento de dados externo	Permissões necessárias	Conceder as permissões
   Armazenamento de Blobs do Azure	Contribuidor de dados de Blob de armazenamento	Atribuir uma função do Azure
   Armazenamento Data Lake Gen2	Contribuidor de dados de Blob de armazenamento	Atribuir uma função do Azure
   Armazenamento Data Lake Gen1	Contribuidor	Atribuir uma função do Azure

1. Crie uma cadeia de conexão do SQL Server. Essa cadeia de caracteres indica o recurso a ser acessado e suas informações de autenticação. Para fluxos de exportação contínuos, recomendamos de autenticação integrada do Microsoft Entra , que é a autenticação de representação.

2. Execute o comando tabela externa .create ou .alter para criar a tabela. Use a cadeia de conexão da etapa anterior como o argumento de sqlServerConnectionString.

   Por exemplo, o comando a seguir cria MySqlExternalTable que se refere a MySqlTable tabela em MyDatabase do SQL Server. A tabela tem duas colunas, uma para um x inteiro e outra para uma cadeia de caracteres s. A cadeia de conexão contém ;Authentication=Active Directory Integrated, que indica usar a autenticação de representação para acessar a tabela.

   .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. Conceda a identidade gerenciada CREATE, UPDATE e INSERT permissões sobre o banco de dados do SQL Server. A identidade gerenciada precisa de permissões de gravação porque o trabalho de exportação contínua exporta dados para o banco de dados em nome da identidade gerenciada. Para saber mais, consulte Permissions.

Execute o comando de exportação contínua .create-or-alter com a propriedade managedIdentity definida como a ID do objeto de identidade gerenciado.

Por exemplo, o comando a seguir cria um trabalho de exportação contínuo chamado MyExport para exportar os dados em MyTable para MyExternalTable em nome de uma identidade gerenciada atribuída pelo usuário. <objectId> deve ser um ID de objeto de identidade gerenciado.

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

Execute o comando de exportação contínua .create-or-alter com a propriedade managedIdentity definida como system.

Por exemplo, o comando a seguir cria um trabalho de exportação contínuo chamado MyExport para exportar os dados em MyTable para MyExternalTable em nome de sua identidade gerenciada atribuída ao sistema.

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