Se connecter à MongoDB
Information de concept
MongoDB est un service de données cloud. Vous pouvez utiliser le connecteur de données MongoDB afin d'importer les données MongoDB de votre organisation.
Remarque
Analytics fournit MongoDB comme connecteur optionnel. S'il n'est pas disponible dans votre fenêtre Accès aux données, il est probable que le connecteur n'ait pas été sélectionné lors de l'installation. Pour plus d'informations, consultez la section Installer des connecteurs de données Analytics et un moteur Python optionnels.
Avant de commencer
Pour vous connecter à MongoDB, munissez-vous des éléments suivants :
-
nom du serveur ou adresse IP du serveur hébergeant la base de données MongoDB ;
- port de connexion qui convient ;
- nom de la base de données MongoDB
Pour obtenir de l'aide concernant la réunion des conditions préalables à la connexion, contactez l'administrateur MongoDB de votre organisation. Si votre administrateur ne peut pas vous aider, vous ou votre administrateur devez contacter le support MongoDB.
Créer une connexion à MongoDB
- Dans le menu principal Analytics, sélectionnez Importer > Base de données et application.
- Depuis l'onglet Nouvelles connexions, sous la section Connecteurs ACL, sélectionnez MongoDB.
Astuce
Vous pouvez filtrer la liste des connecteurs disponibles en indiquant une chaîne de recherche dans la zone Filtrer les connexions. Les connecteurs sont indiqués par ordre alphabétique.
- Dans le panneau Paramètres de connexion aux données entrez les paramètres de connexion, et en bas du panneau, cliquez sur Enregistrer et connecter.
Vous pouvez accepter le nom de connexion proposé par défaut ou en saisir un nouveau.
La connexion correspondant à MongoDB est enregistrée dans l'onglet Connexions existantes. À l'avenir, vous pourrez vous reconnecter à MongoDB à partir de la connexion enregistrée.
Une fois la connexion établie, la fenêtre Accès aux données s'ouvre sur la Zone de transit et vous pouvez commencer l'importation des données. Pour obtenir de l'aide concernant l'importation de données à partir de MongoDB, consultez la rubrique Utilisation de la fenêtre Accès aux données.
Paramètres de connexion
Paramètres de base
| Paramètre | Description | Exemple |
|---|---|---|
| Serveur | Nom d'hôte ou adresse IP du serveur hébergeant la base de données MongoDB. | |
| Port |
Numéro du port TCP que le serveur MongoDB utilise pour écouter les connexions des clients. La valeur par défaut est 27017. |
27017 |
| Base de données | Le nom de la base de données MongoDB. | |
| Se connecter au jeu de réplicas |
Spécifie si le pilote peut accéder aux jeux de répliques dans votre implémentation MongoDB :
|
Désactivé |
| Nom du jeu de réplicas | Nom de la réplique à laquelle le conducteur peut accéder. | |
| Serveurs secondaires |
Liste, séparée par des virgules, des serveurs à utiliser lors de la connexion à un ensemble de répliques. Pour indiquer le port TCP que le serveur utilise pour écouter les connexions des clients, ajoutez deux points (:) et le numéro de port au nom du serveur ou à l'adresse IP. |
|
| Mécanisme d'authentification |
Le mécanisme d'authentification que MongoDB utilisera pour authentifier la connexion :
|
Aucune authentification |
| Nom du service | Le nom principal du service Kerberos du serveur MongoDB. | mongodb |
| Source d'authentification |
Le nom de la base de données MongoDB pour l'authentification. Cette valeur n'est nécessaire que si la base de données d'authentification est différente de la base de données pour la récupération des données. |
admin |
| Nom d'utilisateur | Nom d'utilisateur utilisé pour s'authentifier auprès de MongoDB. | |
| Mot de passe | Mot de passe utilisé pour s'authentifier auprès de MongoDB. |
Paramètres avancés
| Paramètre | Description | Exemple |
|---|---|---|
| Activer SSL | Indique si le pilote utilise le protocole SSL pour se connecter au serveur. | Désactivé |
| Activer un certificat auto-signé | Indique si le pilote autorise les certificats SSL auto-signés du serveur. | Désactivé |
| Fichier clé PEM | Chemin d'accès complet du fichier .pem contenant le certificat de vérification du client. | |
| Mot de passe de la clé PEM | Mot de passe du fichier de certificat client spécifié dans le champ Fichier de clé PEM. | |
| Fichier d'autorité de certification | Chemin d'accès complet au fichier .pem que vous utilisez pour vérifier le serveur. | |
| Répertoire d'autorité de certification | Chemin complet du répertoire contenant les fichiers .pem pour vérifier le serveur. Ce paramètre permet au pilote d'accéder à plusieurs fichiers .pem pour la vérification SSL. | |
| Fichier de liste de révocation de certificats | Chemin d'accès complet au fichier .pem contenant la liste des certificats révoqués. | |
| Activer la double mise en mémoire tampon |
Spécifie si le pilote récupère les données en utilisant la double mise en mémoire tampon. Le pilote MongoDB est capable d'utiliser la double mise en mémoire tampon pour améliorer les performances du pilote pendant les opérations SELECT. |
Activé |
| Exposer les chaînes sous SQL_WVARCHAR |
Spécifie si le type de données de la chaîne est mappé à SQL_WVARCHAR ou SQL_VARCHAR. |
Activé |
| Exposer le binaire sous SQL_LONGVARBINARY | Spécifie si le pilote renvoie des colonnes binaires sous forme de données de type SQL_LONGVARBINARY ou SQL_VARBINARY. | Activé |
| Activer la transmission | Spécifie si le pilote optimise les jointures entre les tables virtuelles et transmet les optimisations de filtrage et d'agrégation à la base de données MongoDB pour traitement. | Activé |
| Documents à extraire par bloc |
Nombre maximum de documents renvoyés à la fois par une requête. Ce paramètre détermine également la taille de la mémoire tampon utilisée lorsque la double mise en mémoire tampon est activée. La valeur par défaut est 4096. |
4096 |
| Taille des colonnes des chaînes |
Nombre maximum de caractères pouvant être contenus dans les colonnes STRING. La valeur par défaut est 255. |
255 |
| Taille des colonnes binaires |
Longueur maximale des données pour les colonnes binaires. La valeur par défaut est 32767. |
32767 |
| Mécanisme des métadonnées |
Spécifie l'endroit où le pilote cherche la définition du schéma :
|
Base de données |
| Fichier local | Chemin complet d'un fichier JSON local contenant la définition de schéma que vous voulez que le pilote utilise lors de la connexion à MongoDB. | |
| Méthode d'échantillonnage |
Spécifie comment le pilote échantillonne les données lorsqu'il génère une définition de schéma temporaire :
|
Suivante |
| Documents à échantillonner (0 pour tous les documents) |
Nombre maximum d'enregistrements que le pilote peut échantillonner pour générer une définition de schéma temporaire. Lorsque cette option est définie sur 0, le pilote échantillonne chaque document de la base de données. La valeur par défaut est 100. |
100 |
| Taille de l'incrément de l'échantillonnage |
Intervalle auquel le pilote échantillonne les enregistrements lors de l'analyse de la base de données pour générer une définition de schéma temporaire. Par exemple, si vous définissez cette option sur 2, le pilote échantillonne un enregistrement sur deux dans la base de données. La valeur par défaut est 1. |
1 |
| Taille du lot à écriture différée (1-1000) |
Nombre maximum de documents que le pilote peut traiter en même temps lors d'une opération d'écriture. La valeur par défaut est 500. |
500 |
| Write Concern |
Nombre total de serveurs principaux et secondaires qui doivent reconnaître une opération d'écriture pour que le pilote puisse signaler une opération d'écriture réussie. Lorsque cette option est définie sur 0, le pilote n'a pas besoin de reconnaître des opérations d'écriture. La valeur par défaut est 1. |
1 |
| Délai d'attente Write Concern |
Nombre maximum de secondes pendant lesquelles le pilote attend qu'un serveur secondaire reconnaisse une opération d'écriture avant de signaler l'échec de l'opération. Lorsque cette option est définie sur 0, le pilote n'expire pas. Au lieu de cela, le pilote attend que tous les serveurs secondaires reconnaissent l'opération d'écriture, puis signale la réussite de l'opération. La valeur par défaut est 0. |
0 |
| Ecritures de journal Write Concern | Spécifie si le pilote a besoin que les données d'une opération d'écriture soient consignées dans le journal avant que l'opération d'écriture puisse être reconnue. | Désactivé |
Mises à jour du connecteur de données
Lorsque vous mettez à niveau Analytics ou Agent Robots, vous devez tester tous vos scripts qui importent des données à l'aide de l'un des connecteurs de données Analytics (commande ACCESSDATA).
Il est possible que des modifications apportées par des sources de données tierces ou des fournisseurs de pilotes ODBC aient nécessité la mise à jour d'un ou plusieurs connecteurs de données. Les connexions de données écrites sous forme de scripts peuvent avoir besoin d'être mises à jour afin de continuer à fonctionner correctement.
- Ré-exécuter l'importation La façon la plus simple de mettre à jour une connexion est d'effectuer manuellement une importation à l'aide de la fenêtre Accès aux données de la version mise à niveau d'Analytics. Copiez la commande ACCESSDATA du journal et utilisez-la pour mettre à jour votre script.
Remarque
Avant de vous connecter à une source de données et de réexécuter l'importation, effacez le cache du connecteur pour vider le jeu existant de noms de tables.
Dans l'onglet Connexions existantes de la fenêtre Accès aux données, à côté du nom du connecteur, sélectionnez
> Effacer le cache. - Mettre à jour les spécifications des champs Vous pouvez également avoir besoin de mettre à jour les spécifications des champs dans le corps du script pour les aligner avec les modifications du schéma de table dans la source de données ou le pilote ODBC. Les modifications possibles comprennent les noms des champs, les types de données des champs et les longueurs de champ et d'enregistrement.
- Vérifier les résultats des filtrages Vous devez également vérifier les résultats des filtrages que vous appliquez dans le cadre de l'importation de données. Confirmez que le filtrage des importations inclut et exclut correctement les enregistrements.
Changements concernant le connecteur de données MongoDB
Les modifications spécifiques apportées au connecteur de données MongoDB sont indiquées ci-dessous.
| Analytics Version | Modification |
|---|---|
|
14.2 |
Le connecteur ne permet plus de se connecter à MongoDB 3.0 et 3.2. Des connexions peuvent être établies avec MongoDB 3.4, 3.6 et 4.0. |
