Authentifier des tables externes à l’aide d’identités managées

1. Suivez les étapes pour ajouter une identité affectée par l’utilisateur à votre cluster, puis enregistrez l’IDd’objet (principal) pour une utilisation ultérieure.

2. Exécutez la commande .alter-merge policy managed_identity. Cette commande définit une stratégie d’identité managée sur le cluster qui permet l’utilisation de l’identité managée avec des tables externes. Remplacez <objectId> par l’ID d’objet (principal).

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

   Remarque

   Pour définir la stratégie pour une base de données spécifique, utilisez database <DatabaseName> plutôt que cluster.

1. Suivez les étapes pour ajouter une identité affectée par le système à votre cluster.

2. Exécutez la commande .alter-merge policy managed_identity suivante. Cette commande définit une stratégie d’identité managée sur le cluster qui permet l’utilisation de l’identité managée avec des tables externes.

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

   Remarque

   Pour définir la politique pour une base de données spécifique, utilisez database <DatabaseName> au lieu de cluster.

Le tableau suivant présente les autorisations requises par la ressource externe. Pour importer ou interroger des données à partir de la ressource externe, accordez les autorisations de lecture d’identité managée. Pour exporter des données vers la ressource externe, accordez à l’identité managée des autorisations d’écriture.

Pour importer ou interroger des données à partir de la base de données SQL, accordez les autorisations SELECT de la table d’identité managée. Pour exporter des données vers la base de données SQL, accordez les autorisations CREATE, UPDATE et INSERT d’identité managée. Pour en savoir plus, consultez Autorisations.

Pour importer ou interroger des données à partir de la base de données Cosmos DB, accordez les autorisations de lecture d’identité managée. Pour en savoir plus, consultez Autorisations.

Pour créer une table externe Stockage Azure, procédez comme suit :

1. Créez une chaîne de connexion à partir des modèles de chaînes de connexion de stockage. Cette chaîne indique la ressource à accéder et ses informations d’authentification. Spécifiez la méthode d’authentification d’identité managée.

2. Exécutez la commande .create or .alter external table pour créer la table. Utilisez le chaîne de connexion de l’étape précédente comme argument storageConnectionString.

Exemple

La commande suivante crée MyExternalTable qui fait référence à des données au format CSV dans mycontainer de mystorageaccount dans le stockage Blob Azure. La table comporte deux colonnes, une pour un entier x et une pour une chaîne s. Le chaîne de connexion se termine par ;managed_identity=system, ce qui indique d’utiliser une identité managée affectée par le système pour l’authentification pour accéder au magasin de données.

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

Pour créer une table externe SQL Server, procédez comme suit :

1. Créez une chaîne de connexion SQL Server. Cette chaîne indique la ressource à accéder et ses informations d’authentification. Spécifiez la méthode d’authentification d’identité managée.

2. Exécutez la commande .create ou .alter external table pour créer la table. Utilisez la chaîne de connexion comme argument SqlConnectionString.

Exemple

La commande suivante crée MySqlExternalTable qui fait référence à la table MySqlTable dans MyDatabase de SQL Server. La table comporte deux colonnes, une pour un entier x et une pour une chaîne s. Le chaîne de connexion contient ;Authentication="Active Directory Managed Identity";User Id=123456789, ce qui indique d’utiliser une identité managée affectée par l’utilisateur avec l’ID d’objet 123456789 pour accéder à la table.

.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;'
)

Pour créer une table externe Cosmos DB, procédez comme suit :

1. Créez une chaîne de connexion Cosmos DB. Cette chaîne indique la ressource à accéder et ses informations d’authentification. Spécifiez la méthode d’authentification d’identité managée.

2. Exécutez la commande .create ou .alter external table pour créer la table. Utilisez la chaîne de connexion en tant qu’argument SqlConnectionString.

Exemple

Identité gérée attribuée par l’utilisateur

La commande suivante crée MyCosmosDbExternalTable qui fait référence aux données dans MyCollection la base de données MyDatabase du compte mycosmosCosmos DB .

• La chaîne de connexion contient ;Authentication="Active Directory Managed Identity";User Id=123456789, ce qui indique qu’il faut utiliser une identité managée affectée par l’utilisateur avec un ID d’objet de 123456789 pour accéder à la table.

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

Identité managée attribuée par le système

Le chaîne de connexion contient uniquement ;Authentication="Active Directory Managed Identity";, ce qui indique d’utiliser une identité managée affectée par le système

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