Utilisation de l'action Connecter pour la base de données

L'action Connecter vous permet d'établir une connexion avec un serveur de bases de données que vous souhaitez utiliser pour automatiser des tâches liées aux bases de données. Cette action prend en charge les serveurs de bases de données Microsoft Access, Microsoft SQL Server, MySQL, Oracle, serveur PostgreSQL et SQLite, ainsi que l'utilisation de fichiers CSV, Microsoft Excel et TXT en tant que bases de données.

Important : Si votre installation de bureau actuelle est l'une des suivantes :

Microsoft 365 Apps for Enterprise
Office 2016, 2019 ou 2021 (version grand public 2009 ou ultérieure)

Dans ce cas, vous n'avez pas besoin d'installer le moteur de base de données Microsoft Access en tant que composant supplémentaire dans votre système.

Toutefois, si Microsoft 365 Apps et le moteur de base de données Microsoft Access sont installés sur votre système, vous pouvez désinstaller le moteur de base de données Microsoft Access et réparer Microsoft 365 Apps.

Microsoft vous recommande de ne pas installer séparément le pilote du moteur de base de données Microsoft Access, car le moteur de base de données Microsoft Access 2016 et Microsoft 365 Apps utilisent le même identifiant de version majeure (16.0). Pour en savoir plus sur la condition d'installation du pilote du moteur de base de données Microsoft Access, consultez la rubrique Impossible d'utiliser le fournisseur Access ODBC ou OLEDB.

Remarque : Le pilote SQL Server ne dépend pas de l'installation de MS Office. Seule la version du pilote Excel dépend de la version de MS Office.

Spécifiez les détails du serveur de bases de données et associez-le à un nom de session. Utilisez le nom de session indiqué dans cette action dans les autres actions pour éviter d'avoir à fournir à nouveau les détails du serveur de base de données dans ces actions.

Procédure

Pour établir une connexion avec un serveur de bases de données, procédez comme suit :

Double-cliquez sur l'action Connecter ou faites-la glisser à partir du package Base de données dans la palette Actions.

Sélectionnez l'option de connexion Par défaut ou Définie par l'utilisateur.

Lorsque vous sélectionnez le mode de connexion Définie par l'utilisateur et que vous utilisez l'action Lire depuis avec le codage ANSI pour enregistrer les données récupérées dans un fichier CSV, vous constatez que les enregistrements récupérés dans la base de données Oracle affichent des caractères tronqués.

Pour en savoir plus sur ce problème, consultez la rubrique Le trait d'union pleine chasse est tronqué lors de l'exportation de données au format csv par la base de données : Action Lire depuis avec le codage ANSI (connexion à A-people requise).

Si vous sélectionnez l'option Par défaut, vous pouvez saisir directement la chaîne de connexion pour toute base de données prenant en charge les chaînes de connexion JDBC et un pilote 64 bits. Pour obtenir la liste des bases de données prises en charge, consultez la rubrique Matrice de support du serveur de base de données.
Si vous avez configuré votre base de données et votre référentiel partagé sur le site secondaire, utilisez la connexion JDBC pour vous connecter à la base de données réplique. Par exemple : jdbc:sqlserver://AGL-ADDRESS:1433;databaseName=DB_NAME;user=username;password=password;applicationIntent=ReadOnly

Vous pouvez établir une connexion avec la base de données Snowflake à l'aide de pilotes ODBC. Pour plus d'informations sur le téléchargement du pilote ODBC, référez-vous à Snowflake utilisant le pilote ODBC

Vous pouvez saisir la chaîne de connexion pour vous connecter à la base de données. Par exemple : Driver={SnowflakeDSIIDriver};Server={account}.aws.snowflakecomputing.com;Database=DB_NAME;uid=username;pwd=password;

Utilisez cette option pour vous connecter à un fichier Excel, CSV ou TXT. Reportez-vous à la rubrique Chaînes de connexion par type de base de données.

Remarque : Pour accéder à une base de données via ODBC, vous devez d'abord installer un pilote ODBC 32 bits sur votre périphérique.

Paramètre : Vous pouvez utiliser les valeurs d'information d'identification de la consigne dédiée sans exposer les infos d'identification (nom d'utilisateur ou mot de passe) en texte brut dans la chaîne de connexion. Pour ce faire, vous devez mapper les infos d'identification dans le mappeur d'infos d'identification, puis utiliser le nom du paramètre dans la chaîne de connexion entre accolades doubles.
Par exemple, si le nom du paramètre est db_username et que la valeur du paramètre est sélectionnée à partir de la valeur d'information d'identification, la chaîne de connexion avec 3 paramètres est la suivante : “Provider=SQLOLEDB.1;Initial Catalog=master;Password={{db_credentials}};Persist Security Info=True;User ID={{db_username}};Data Source={{db_datasource}}”
Pour utiliser le mot de passe de la consigne d'informations d'identification, procédez comme suit :
1. Cliquez sur Ajouter un paramètre.
2. Renseignez le champ Nom du paramètre.
3. Dans le champ Valeur du paramètre, sélectionnez Information d'identification pour utiliser une valeur disponible dans le coffre d'informations d'identification, Variable pour utiliser une variable d'information d'identification ou Chaîne non sécurisée pour spécifier manuellement la valeur que vous souhaitez utiliser.
4. Cliquez sur Ajouter.
Afin de garantir une automatisation plus sécurisée, utilisez une variable Credential Vault pour la chaîne de connexion.
Sélectionnez l'option Utiliser le pilote ODBC 64 bits pour la connexion pour vous connecter à la base de données.
Remarque :
- Assurez-vous que le pilote ODBC d'accès 64 bits est installé sur votre système pour accéder à n'importe quelle base de données et effectuer des opérations à l'aide des actions de la base de données.
- L'action suivante n'est pas compatible avec les pilotes OBDC 32 bits ou 64 bits, car les actions énumérées concernent des transactions de base de données qui sont effectuées après avoir établi une connexion avec la base de données :
  - Commencer une transaction de base de données
  - Terminer une transaction de base de données
  - Gérer la procédure stockée
- Si vous utilisez Excel comme base de données, vous pouvez traiter plus de lignes avec des pilotes 64 bits qu'avec des pilotes 32 bits.

Si vous sélectionnez l'option Définie par l'utilisateur, sélectionnez le type de base de données parmi les options disponibles et remplissez les champs suivants en fonction de la sélection :


Type de base de données	Options
Microsoft SQL Server, serveur PostgreSQL	Nom du serveur : saisissez le nom du serveur de bases de données auquel vous souhaitez vous connecter. Nom de la base de données : saisissez le nom de la base de données. Nom d'utilisateur : saisissez le nom d'utilisateur que vous souhaitez utiliser pour accéder au serveur de bases de données. Pour garantir l'utilisation d'un nom d'utilisateur sécurisé, sélectionnez une variable Credential Vault. Sinon, saisissez une valeur. Mot de passe : saisissez le mot de passe correspondant au nom d'utilisateur que vous avez spécifié. Pour garantir l'utilisation d'un mot de passe sécurisé, sélectionnez une variable Credential Vault. Sinon, saisissez une valeur. Nom de l'instance : saisissez un nom pour cette instance de connexion. Champ Délai d'expiration en secondes (facultatif) : spécifiez le délai entre 1 et 9999 pendant lequel vous souhaitez que le système attende avant d'annuler un robot. L'automatisation expirera et échouera si la connexion à la base de données n'est pas établie dans le délai spécifié. Si vous ne saisissez pas de valeur dans le champ Délai d'expiration en secondes (facultatif), le délai d'expiration par défaut spécifié dans la bibliothèque du pilote est utilisé. Remarque : Microsoft SQL Server ne prend en charge que cette option. Se connecter à un Microsoft SQL Server avec l'authentification Windows
MySQL	Saisissez les mêmes options que dans le type Microsoft SQL Server de base de données. Saisissez également le numéro de port. Le numéro de port par défaut est 3306.
Microsoft Access, SQLite	Sélectionnez le chemin de fichier de base de données dans : dossier Robots périphérique local variable de fichier existante
Oracle	Nom du serveur (facultatif) : saisissez le nom du serveur Oracle auquel vous souhaitez vous connecter. Facultatif : sélectionnez une option pour spécifier l'instance Oracle que vous souhaitez utiliser : Identifiant de système (SID) : saisissez l'identifiant du système. Nom du service : Saisissez le nom du service. Nom TNS : Saisissez le Nom TNS disponible dans le fichier de configuration tnsname.ora. Indiquez le chemin de fichier de configuration tnsname.ora si vous n'avez pas défini la propriété système avec la variable d'environnement. Remarque : Vous pouvez vous connecter à la Oracle Database avec le nom du serveur ou l'instance Oracle. Si vous vous connectez avec le nom du serveur, vous devez spécifier l'identifiant de système (SID) ou le nom du service dans le champ Instance Oracle pour identifier la base de données Oracle et son instance. Cependant, si vous vous connectez en utilisant le nom TNS, il n'est pas nécessaire de saisir de valeur dans le champ Nom du serveur. Vous devez saisir uniquement la valeur du nom TNS et le chemin de fichier. Nom d'utilisateur : saisissez le nom d'utilisateur que vous souhaitez utiliser pour accéder au serveur Oracle. Pour garantir l'utilisation d'un nom d'utilisateur sécurisé, sélectionnez une variable Credential Vault. Sinon, saisissez une valeur. Mot de passe : saisissez le mot de passe correspondant au nom d'utilisateur que vous avez spécifié. Pour garantir l'utilisation d'un mot de passe sécurisé, sélectionnez une variable Credential Vault. Sinon, saisissez une valeur. Port : entrez le numéro de port. Le numéro de port par défaut est 1521.

Remarque : Si vous établissez une connexion en utilisant un pilote JDBC, pour Microsoft SQL Server, le package Base de données inclut déjà le pilote JDBC. Cependant, pour les autres serveurs de bases de données, vous devez fournir le fichier jar du pilote JDBC correspondant après l'avoir téléchargé depuis les ressources appropriées.

Si vous établissez une connexion en utilisant un pilote ODBC, vous n'avez pas besoin de fournir de fichier jar.

Sélectionnez un fichier pilote dans le dossier Robots, le périphérique local ou une variable de fichier.
Sélectionnez l'un des onglets suivants pour créer une session de base de données :
- Session locale : Spécifiez un nom de session qui ne peut être utilisé que dans le robot en cours.
- Session globale : Spécifiez un nom de session qui peut être utilisé sur plusieurs robots, notamment des robots parents et des robots enfants.
- Variable : Spécifiez ou créez une variable de session du sous-type Session de base de données.
Cliquez sur Enregistrer.

Étapes suivantes

Choisissez l'une des options suivantes :

Utilisez l'action Lire depuis pour récupérer les enregistrements de la base de données.
Utilisation de l'action Lire depuis
Si vous automatisez une tâche qui implique d'apporter des modifications à la base de données, insérez l'action Commencer une transaction de base de données.
Cette action garantit que tous les enregistrements seront mis à jour ou supprimés dans leur intégralité, et empêche les mises à jour ou suppressions accidentelles de données incomplètes si le robot rencontre une erreur pendant le temps d'exécution.

Base de données package