

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 à MongoDB dans AWS Glue Studio
<a name="connecting-to-data-mongodb"></a>

 AWS Glue fournit une prise en charge intégrée pour MongoDB. AWS Glue Studio fournit une interface visuelle pour se connecter à MongoDB, 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 MongoDB](creating-mongodb-connection.md)
+ [Création d'un nœud source MongoDB](creating-mongodb-source-node.md)
+ [Création d'un nœud cible MongoDB](creating-mongodb-target-node.md)
+ [Options avancées](#creating-mongodb-connection-advanced-options)

# Création d'une connexion MongoDB
<a name="creating-mongodb-connection"></a>

**Prérequis :**
+ Si votre instance MongoDB se trouve dans un Amazon VPC, configurez Amazon VPC pour permettre à votre AWS Glue tâche de communiquer avec l'instance MongoDB sans que le trafic ne transite par l'Internet public. 

  Dans Amazon VPC, identifiez ou créez un **VPC**, un **sous-réseau** et un **groupe de sécurité** qui AWS Glue seront utilisés lors de l'exécution de la tâche. En outre, vous devez vous assurer qu'Amazon VPC est configuré pour autoriser le trafic réseau entre votre instance MongoDB et cet emplacement. Selon la configuration de votre réseau, cela peut nécessiter des modifications des règles du groupe de sécurité, du réseau ACLs, des passerelles NAT et des connexions d'appairage.

**Pour configurer une connexion à MongoDB :**

1. Vous pouvez éventuellement créer un secret à AWS Secrets Manager l'aide de vos informations d'identification MongoDB. 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é `username` contenant la valeur. *mongodbUser*

     Lorsque vous sélectionnez des **paires clé/valeur**, créez une paire pour la clé `password` contenant la valeur. *mongodbPass*

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 **MongoDB** ou **MongoDB Atlas**.
   + Lorsque vous sélectionnez une **URL MongoDB** ou une **URL MongoDB Atlas**, indiquez le nom d'hôte de votre instance MongoDB.

     Une URL MongoDB est fournie au format `mongodb://mongoHost:mongoPort/mongoDBname`.

     Une URL MongoDB Atlas est fournie au format `mongodb+srv://mongoHost/mongoDBname`.
   + Si vous avez choisi de créer un secret Secrets Manager, choisissez le **type AWS Secrets Manager d'identifiant**.

     Ensuite, dans **AWS Secret**, fournissez*secretName*.
   + Si vous choisissez de fournir un **nom d'utilisateur et un mot de passe**, fournissez *mongodbUser* et*mongodbPass*.

1. Dans les situations suivantes, vous pouvez avoir besoin d'une configuration supplémentaire :
   + 

     Pour les instances MongoDB hébergées AWS dans un Amazon VPC
     + Vous devrez fournir les informations de connexion Amazon VPC à la AWS Glue connexion qui définit vos informations d'identification de sécurité MongoDB. Lorsque vous créez ou mettez à jour votre connexion, définissez le **VPC**, le **sous-réseau** et les **groupes de sécurité** dans les **options réseau**.

Après avoir créé une connexion AWS Glue MongoDB, vous devez effectuer les étapes suivantes avant d'exécuter votre AWS Glue tâche :
+ Lorsque vous travaillez avec des AWS Glue tâches dans l'éditeur visuel, vous devez fournir les informations de connexion Amazon VPC pour que votre tâche se connecte à MongoDB. Identifiez un emplacement approprié dans Amazon VPC et fournissez-le à votre connexion AWS Glue MongoDB.
+ Si vous avez choisi de créer un secret Secrets Manager, accordez au rôle IAM associé à votre AWS Glue tâche l'autorisation de lecture*secretName*.

# Création d'un nœud source MongoDB
<a name="creating-mongodb-source-node"></a>

## Prérequis
<a name="creating-mongodb-source-node-prerequisites"></a>
+ Une connexion AWS Glue MongoDB, comme décrit dans la section précédente,. [Création d'une connexion MongoDB](creating-mongodb-connection.md)
+ Si vous choisissez de créer un secret Secrets Manager, allouez des autorisations pour votre tâche pour lire le secret utilisé par la connexion.
+ Une collection MongoDB à partir de laquelle vous souhaitez lire. Vous aurez besoin des informations d'identification pour la collection.

  Une collection MongoDB est identifiée par un nom de base de données et un nom de collection,,*mongodbName*. *mongodbCollection*

## Ajout d'une source de données MongoDB
<a name="creating-mongodb-source-node-add"></a>

**Pour ajouter un nœud **Source de données – MongoDB** :**

1.  Choisissez la connexion pour votre source de données MongoDB. 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 MongoDB**. Pour de plus amples informations, veuillez consulter la section précédente [Création d'une connexion MongoDB](creating-mongodb-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 une **Base de données**. Saisissez *mongodbName*.

1. Choisissez une **Collection**. Saisissez *mongodbCollection*.

1. Choisissez votre **Partitionneur**, la **Taille de partition (Mo)** et la **Clé de partition**. Pour plus d'informations sur les paramètres de partition, consultez [« connectionType »: « mongodb » comme source](aws-glue-programming-etl-connect-mongodb-home.md#etl-connect-mongodb-as-source).

1.  Dans les **Propriétés MongoDB personnalisées**, saisissez les paramètres et les valeurs nécessaires. 

# Création d'un nœud cible MongoDB
<a name="creating-mongodb-target-node"></a>

## Prérequis
<a name="creating-mongodb-target-node-prerequisites"></a>
+ Une connexion AWS Glue MongoDB, configurée avec un AWS Secrets Manager secret, comme décrit dans la section précédente,. [Création d'une connexion MongoDB](creating-mongodb-connection.md)
+ Les autorisations appropriées sur votre tâche pour lire le secret utilisé par la connexion.
+ Une table MongoDB dans laquelle vous souhaitez écrire,. *tableName*

## Ajout d'une cible de données MongoDB
<a name="creating-mongodb-target-node-add"></a>

**Pour ajouter un nœud **Cible de données – MongoDB** :**

1.  Choisissez la connexion pour votre source de données MongoDB. 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 MongoDB**. Pour de plus amples informations, veuillez consulter la section précédente [Création d'une connexion MongoDB](creating-mongodb-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 une **Base de données**. Saisissez *mongodbName*.

1. Choisissez une **Collection**. Saisissez *mongodbCollection*.

1. Choisissez votre **Partitionneur**, la **Taille de partition (Mo)** et la **Clé de partition**. Pour plus d'informations sur les paramètres de partition, consultez [« connectionType »: « mongodb » comme source](aws-glue-programming-etl-connect-mongodb-home.md#etl-connect-mongodb-as-source).

1. Choisissez **Réessayer les écritures** si vous le souhaitez.

1.  Dans les **Propriétés MongoDB personnalisées**, saisissez les paramètres et les valeurs nécessaires. 

## Options avancées
<a name="creating-mongodb-connection-advanced-options"></a>

Vous pouvez fournir des options avancées lors de la création d'un nœud MongoDB. Ces options sont les mêmes que celles disponibles lors de la programmation AWS Glue de scripts Spark.

Consultez [Référence des options de connexion MongoDB](aws-glue-programming-etl-connect-mongodb-home.md#aws-glue-programming-etl-connect-mongodb). 