Autenticación de tablas externas con identidades administradas

1. Siga los pasos para agregar una identidad asignada por el usuario a su clúster y guarde el identificador de objeto (principal) para usarlo más adelante.

2. Ejecute el comando .alter-merge policy managed_identity . Este comando establece una directiva de identidad administrada en el clúster que permite usar la identidad administrada con tablas externas. Reemplace <objectId> por el Id. de objeto (principal).

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

   Nota:

   Para establecer la directiva en una base de datos específica, use database <DatabaseName> en lugar de cluster.

1. Siga los pasos para agregar una identidad asignada por el sistema al clúster.

2. Ejecute el siguiente comando .alter-merge policy managed_identity. Este comando establece una directiva de identidad administrada en el clúster que permite usar la identidad administrada con tablas externas.

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

   Nota:

   Para establecer la directiva en una base de datos específica, use database <DatabaseName> en lugar de cluster.

En la tabla siguiente se muestran los permisos necesarios por recurso externo. Para importar o consultar datos desde el recurso externo, conceda a la identidad administrada permisos de lectura. Para exportar datos al recurso externo, conceda permisos de escritura a la identidad administrada.

Para importar o consultar datos de la base de datos SQL, conceda a la tabla de identidad administrada permisos SELECT. Para exportar datos a la base de datos SQL, conceda los permisos CREATE, UPDATE e INSERT de la identidad administrada. Para más información, consulte Permisos.

Para importar o consultar datos de la base de datos de Cosmos DB, conceda a la identidad administrada permisos de lectura. Para más información, consulte Permisos.

Para crear una tabla externa de Azure Storage, siga estos pasos:

1. Cree una cadena de conexión a partir de las plantillas de cadenas de conexión de almacenamiento. Esta cadena indica el recurso para acceder a y su información de autenticación. Especifique el método de autenticación de identidad administrada.

2. Ejecute el comando .create or .alter external table para crear la tabla. Use el cadena de conexión del paso anterior como argumento storageConnectionString.

Ejemplo

El comando siguiente crea MyExternalTable que hace referencia a los datos con formato CSV en mycontainer de mystorageaccount en Azure Blob Storage. La tabla tiene dos columnas, una para un entero x y otra para una cadena s. El cadena de conexión termina con ;managed_identity=system, que indica que se usa una identidad administrada asignada por el sistema para la autenticación para acceder al almacén de datos.

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

Para crear una tabla externa de SQL Server, siga estos pasos:

1. Cree una cadena de conexión para SQL Server. Esta cadena indica el recurso para acceder a y su información de autenticación. Especifique el método de autenticación de identidad administrada.

2. Ejecute el comando .create o .alter external table para crear la tabla. Use el cadena de conexión como argumento SqlConnectionString.

Ejemplo

El siguiente comando crea MySqlExternalTable, que hace referencia a la tabla MySqlTable en MyDatabase de SQL Server. La tabla tiene dos columnas, una para un entero x y otra para una cadena s. El cadena de conexión contiene ;Authentication="Active Directory Managed Identity";User Id=123456789, que indica que se usa una identidad administrada asignada por el usuario con el identificador 123456789 de objeto para acceder a la tabla.

.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 crear una tabla externa de Cosmos DB, siga estos pasos:

1. Cree una cadena de conexión de Cosmos DB. Esta cadena indica el recurso para acceder a y su información de autenticación. Especifique el método de autenticación de identidad administrada.

2. Ejecute el comando .create o .alter external table para crear la tabla. Use el cadena de conexión como argumento SqlConnectionString.

Ejemplo

Identidad administrada asignada por el usuario

El siguiente comando crea MyCosmosDbExternalTable, que hace referencia a los datos de MyCollection en la base de datos MyDatabase de la cuenta de Cosmos DB mycosmos.

• El cadena de conexión contiene ;Authentication="Active Directory Managed Identity";User Id=123456789, que indica que se usa una identidad administrada asignada por el usuario con un identificador de objeto de 123456789 para acceder a la tabla.

.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"
)  

Identidad administrada asignada por el sistema

El cadena de conexión contiene solo ;Authentication="Active Directory Managed Identity";, que indica que se usa una identidad administrada asignada por el 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"
)