Autenticar tabelas externas com identidades gerenciadas

1. Siga os passos para adicionar uma identidade atribuída pelo utilizador ao seu cluster e guarde o ID do Objeto (principal) para uso posterior.

2. Execute o comando .alter-merge policy managed_identity. Este comando define uma política de identidade gerida no cluster que permite que a identidade gerida seja usada com tabelas externas. Substitui <objectId> pelo ID do Objeto (principal).

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

   Note

   Para definir a política numa base de dados específica, use database <DatabaseName> em vez de cluster.

1. Siga os passos para adicionar uma identidade atribuída pelo sistema ao seu cluster.

2. Execute o seguinte comando de política .alter-merge managed_identity. Este comando define uma política de identidade gerida no cluster que permite que a identidade gerida seja usada com tabelas externas.

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

   Note

   Para definir a política numa base de dados específica, use database <DatabaseName> em vez de cluster.

A tabela seguinte mostra as permissões necessárias por recurso externo. Para importar ou consultar dados do recurso externo, conceda permissões de leitura à identidade gerida. Para exportar dados para o recurso externo, conceda permissões de escrita à identidade gerida.

Para importar ou consultar dados da base de dados SQL, conceda permissões SELECT à tabela de identidade gerida. Para exportar dados para a base de dados SQL, conceda à identidade gerida permissões CREATE, UPDATE e INSERT. Para saber mais, consulte Permissions.

Para importar ou consultar dados da base de dados Cosmos DB, conceda permissões de leitura à identidade gerida. Para saber mais, consulte Permissions.

Para criar uma tabela externa do Armazenamento do Azure, faça os seguintes passos:

1. Crie uma cadeia de ligação com base nos modelos de cadeias de ligação de armazenamento. Essa cadeia de caracteres indica o recurso a ser acessado e suas informações de autenticação. Especifique o método de autenticação de identidade gerida.

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

Exemplo

O comando seguinte 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 ligação termina em ;managed_identity=system, o que indica usar uma identidade gerida atribuída pelo sistema para autenticação e aceder ao armazenamento de dados.

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

Para criar uma tabela externa do SQL Server, faça os seguintes passos:

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. Especifique o método de autenticação de identidade gerida.

2. Execute o comando tabela externa .create ou .alter para criar a tabela. Use a cadeia de ligação como argumento SqlConnectionString.

Exemplo

O comando seguinte cria MySqlExternalTable, que faz referência à tabela MySqlTable na 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 ligação contém ;Authentication="Active Directory Managed Identity";User Id=123456789, que indica que deve usar uma identidade gerida atribuída pelo utilizador com ID 123456789 de objeto para aceder à tabela.

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

Para criar uma tabela externa da Cosmos DB, faça os seguintes passos:

1. Criar uma cadeia de ligação do Cosmos DB. Essa cadeia de caracteres indica o recurso a ser acessado e suas informações de autenticação. Especifique o método de autenticação de identidade gerida.

2. Execute o comando tabela externa .create ou .alter para criar a tabela. Utilize a cadeia de ligação como argumento SqlConnectionString.

Exemplo

Identidade gerenciada atribuída pelo usuário

O comando seguinte cria MyCosmosDbExternalTable, que se refere a dados em MyCollection na base de dados MyDatabase da conta do Cosmos DB mycosmos.

• A cadeia de ligação contém ;Authentication="Active Directory Managed Identity";User Id=123456789, o que indica que deve ser utilizada uma identidade gerida atribuída pelo utilizador com um ID de objeto de 123456789 para aceder à tabela.

.create external table MyCosmosDbExternalTable (x:int, s:string) kind=sql
( 
    h@'AccountEndpoint=https://mycosmos.documents.azure.com:443/;Database=MyDatabase;Collection=MyCollection;Authentication="Active Directory Managed Identity";User Id=123456789;'
)
with 
(
   sqlDialect = "CosmosDbSQL"
)  

Identidade gerenciada atribuída ao sistema

A cadeia de ligação contém apenas ;Authentication="Active Directory Managed Identity";, o que indica que deve ser utilizada uma identidade gerida atribuída pelo sistema

.create external table MyCosmosDbExternalTable (x:int, s:string) kind=sql
( 
    h@'AccountEndpoint=https://mycosmos.documents.azure.com:443/;Database=MyDatabase;Collection=MyCollection;Authentication="Active Directory Managed Identity";'
)
with 
(
   sqlDialect = "CosmosDbSQL"
)