Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Connexion à Azure Cosmos DB dans AWS Glue Studio
AWS Glue fournit une prise en charge intégrée pour Azure Cosmos DB. AWS Glue Studio fournit une interface visuelle pour se connecter à Azure Cosmos DB pour NoSQL, créer des tâches d'intégration de données et les exécuter sur l'exécution Spark AWS Glue Studio sans serveur.
**Topics**
+ [Création d'une connexion Azure Cosmos DB](creating-azurecosmos-connection.md)
+ [Création d'un nœud source Azure Cosmos DB](creating-azurecosmos-source-node.md)
+ [Création d'un nœud cible Azure Cosmos DB](creating-azurecosmos-target-node.md)
+ [Options avancées](#creating-azurecosmos-connection-advanced-options)
# Création d'une connexion Azure Cosmos DB
**Prérequis :**
+ Dans Azure, vous devez identifier ou générer une clé de base de données Azure Cosmos à utiliser par AWS Glue,`cosmosKey`. Pour plus d'informations, consultez la section [Accès sécurisé aux données dans Azure Cosmos DB](https://learn.microsoft.com/en-us/azure/cosmos-db/secure-access-to-data?tabs=using-primary-key) dans la documentation Azure.
**Pour configurer une connexion à Azure Cosmos DB :**
1. Dans AWS Secrets Manager, créez un secret à l'aide de votre clé de base de données Azure Cosmos. Pour créer un secret dans Secrets Manager, suivez le didacticiel disponible dans la [section Créer un AWS Secrets Manager secret](https://docs.aws.amazon.com//secretsmanager/latest/userguide/create_secret.html) dans la AWS Secrets Manager documentation. Après avoir créé le secret, conservez le nom du secret *secretName* pour l'étape suivante.
+ Lorsque vous sélectionnez des **paires clé/valeur**, créez une paire pour la clé `spark.cosmos.accountKey` contenant la valeur. *cosmosKey*
1. Dans la AWS Glue console, créez une connexion en suivant les étapes décrites dans[Ajouter une AWS Glue connexion](console-connections.md). Après avoir créé la connexion, conservez le nom de la connexion pour une utilisation future dans AWS Glue. *connectionName*
+ Lorsque vous sélectionnez un **type de connexion**, sélectionnez Azure Cosmos DB.
+ Lorsque vous sélectionnez un **AWS secret**, fournissez*secretName*.
# Création d'un nœud source Azure Cosmos DB
## Prérequis
+ Une connexion AWS Glue Azure Cosmos DB, configurée avec un AWS Secrets Manager secret, comme décrit dans la section précédente,[Création d'une connexion Azure Cosmos DB](creating-azurecosmos-connection.md).
+ Les autorisations appropriées sur votre tâche pour lire le secret utilisé par la connexion.
+ Un conteneur Azure Cosmos DB pour NoSQL à partir duquel vous souhaitez lire. Vous aurez besoin des informations d'identification du conteneur.
Un conteneur Azure Cosmos pour NoSQL est identifié par sa base de données et son conteneur. Vous devez fournir les noms de base de données et de conteneur lorsque vous vous connectez à l'API Azure Cosmos pour NoSQL. *cosmosDBName* *cosmosContainerName*
## Ajout d'une source de données Azure Cosmos DB
**Pour ajouter un nœud **Source de données – Azure Cosmos DB** :**
1. Choisissez la connexion pour votre source de données Azure Cosmos DB. Puisque vous l'avez créé, il devrait être disponible dans le menu déroulant. Si vous devez créer une connexion, choisissez **Créer une connexion Azure Cosmos DB**. Pour de plus amples informations, veuillez consulter la section précédente [Création d'une connexion Azure Cosmos DB](creating-azurecosmos-connection.md).
Une fois que vous avez choisi une connexion, vous pouvez afficher ses propriétés en cliquant sur **Afficher les propriétés**.
1. Choisissez **le nom de la base de données Cosmos DB** : indiquez le nom de la base de données à partir de laquelle vous souhaitez lire*cosmosDBName*.
1. Choisissez **Azure Cosmos DB Container** : indiquez le nom du conteneur à partir duquel vous souhaitez lire*cosmosContainerName*.
1. Choisissez éventuellement la **Requête personnalisé Azure Cosmos DB** : fournissez une requête SQL SELECT pour récupérer des informations spécifiques à partir d'Azure Cosmos DB.
1. Dans les **Propriétés Azure Cosmos personnalisées**, saisissez les paramètres et les valeurs nécessaires.
# Création d'un nœud cible Azure Cosmos DB
## Prérequis
+ Une connexion AWS Glue Azure Cosmos DB, configurée avec un AWS Secrets Manager secret, comme décrit dans la section précédente,[Création d'une connexion Azure Cosmos DB](creating-azurecosmos-connection.md).
+ Les autorisations appropriées sur votre tâche pour lire le secret utilisé par la connexion.
+ Une table Azure Cosmos DB dans laquelle vous souhaitez écrire. Vous aurez besoin des informations d'identification du conteneur. **Vous devez créer le conteneur avant d'appeler la méthode de connexion.**
Un conteneur Azure Cosmos pour NoSQL est identifié par sa base de données et son conteneur. Vous devez fournir les noms de base de données et de conteneur lorsque vous vous connectez à l'API Azure Cosmos pour NoSQL. *cosmosDBName* *cosmosContainerName*
## Ajout d'une cible de données Azure Cosmos DB
**Pour ajouter un nœud **Cible de données – Azure Cosmos DB** :**
1. Choisissez la connexion pour votre source de données Azure Cosmos DB. Puisque vous l'avez créé, il devrait être disponible dans le menu déroulant. Si vous devez créer une connexion, choisissez **Créer une connexion Azure Cosmos DB**. Pour de plus amples informations, veuillez consulter la section précédente [Création d'une connexion Azure Cosmos DB](creating-azurecosmos-connection.md).
Une fois que vous avez choisi une connexion, vous pouvez afficher ses propriétés en cliquant sur **Afficher les propriétés**.
1. Choisissez **le nom de la base de données Cosmos DB** : indiquez le nom de la base de données à partir de laquelle vous souhaitez lire*cosmosDBName*.
1. Choisissez **Azure Cosmos DB Container** : indiquez le nom du conteneur à partir duquel vous souhaitez lire*cosmosContainerName*.
1. Dans les **Propriétés Azure Cosmos personnalisées**, saisissez les paramètres et les valeurs nécessaires.
## Options avancées
Vous pouvez fournir des options avancées lors de la création d'un nœud Azure Cosmos DB. Ces options sont les mêmes que celles disponibles lors de la programmation AWS Glue de scripts Spark.
Consultez [Connexions Azure Cosmos DB](aws-glue-programming-etl-connect-azurecosmos-home.md).