Créer une chaîne de connexion à une base de données (Outils de gestion des données)

Résumé

Crée une chaîne de connexion que les outils de géotraitement peuvent utiliser pour se connecter à une base de données ou à une géodatabase d’entreprise.

Utilisation

Utilisez cet outil à la place des fichiers de connexion lorsque vous disposez d’un processus de géotraitement automatique (script ou modèle) qui utilise les jeux de données d’une base de données ou d’une géodatabase d’entreprise. Vous pouvez générer une chaîne de connexion qui peut être utilisée comme entrée dans n’importe quel outil de géotraitement prenant en charge le type de jeu de données spécifié, plutôt que d’utiliser un chemin vers la base de données via l’espace de travail du fichier de connexion.
Les connexions d’ArcGIS vers Altibase et Netezza ne sont plus prises en charge.

Etiqueter	Explication	Type de données
Plateforme de base de données	Spécifie la plateforme de la base de données avec laquelle la connexion est établie. SQL Server—Se connecter à Microsoft SQL Server ou à la base de données SQL Microsoft Azure. Oracle—Se connecter à Oracle. DB2—Se connecter à IBM DB2 pour Linux, UNIX ou Windows. PostgreSQL—Se connecter à PostgreSQL. Teradata—Se connecter à Teradata Vantage. SAP HANA—Se connecter à SAP HANA. Dameng—Se connecter à Dameng.	String
Instance	Serveur de base de données ou instance avec lesquels la connexion est établie. La valeur de ce paramètre dépend de la valeur sélectionnée pour le paramètre Database Platform (Plateforme de la base de données).	String
Authentification de la base de données (Facultatif)	Spécifie le type d’authentification utilisé. Activé—L’authentification de la base de données est utilisée. Un nom d’utilisateur et un mot de passe de base de données internes sont utilisés pour se connecter à la base de données. Vous n’êtes pas obligé d’entrer votre nom d’utilisateur et votre mot de passe pour créer une connexion ; cependant, si vous ne le faites pas, il vous sera demandé de les saisir lors de l’établissement d’une connexion. Il s’agit de l’option par défaut. Remarque : Si le fichier de connexion que vous créez est destiné à offrir des services ArcGIS avec accès à la base de données ou à la géodatabase, ou si vous souhaitez utiliser la recherche sur le Catalogue pour localiser les données auxquelles ce fichier de connexion accède, vous devez saisir un nom d'utilisateur et un mot de passe. Décoché—L’authentification du système d’exploitation est utilisée. Vous n’avez pas besoin de saisir de nom d’utilisateur et de mot de passe. La connexion est établie avec le nom d’utilisateur et le mot de passe qui ont permis d’ouvrir une session sur le système d’exploitation. Si la connexion utilisée pour le système d'exploitation n'est pas une connexion de géodatabase valide, la connexion échoue.	Boolean
Nom d’utilisateur (Facultatif)	Nom d’utilisateur de la base de données utilisé en cas de recours à l’authentification de la base de données.	String
Mot de passe (Facultatif)	Mot de passe de l’utilisateur de base de données utilisé en cas de recours à l’authentification de la base de données.	Encrypted String
Base de données (Facultatif)	Nom de la base de données à laquelle vous allez vous connecter. Ce paramètre ne s'applique qu'aux plateformes PostgreSQL et SQL Server.	String
Dataset Object Name (Nom d’objet du jeu de données) (Facultatif)	Nom du jeu de données ou de l’objet de la base de données vers lequel la chaîne de connexion pointe. Cette chaîne de connexion peut être utilisée comme chemin vers le jeu de données spécifié.	String
Type de données (Facultatif)	Type de jeu de données ou d’objet auquel le nom d’objet du jeu de données fait référence. Si plusieurs objets de la base de données portent le même nom, vous devrez peut-être spécifier le type de données de l’objet pour lequel vous voulez créer une chaîne de connexion.	String
Jeu de classes d’entités cible (Facultatif)	Nom du jeu de classes d’entités qui contient le jeu de données ou l’objet pour lequel vous voulez créer une chaîne de connexion. Si le jeu de données ne se trouve pas dans un jeu de classes d’entités (par exemple, s’il se trouve à la racine de la base de données), ne spécifiez pas de jeu de classes d’entités cible.	String
Structure (géodatabases de structure utilisateur Oracle uniquement) (Facultatif)	Les géodatabases de structure utilisateur ne sont plus prises en charge.	String
Type de version (Facultatif)	Spécifie le type de version auquel vous allez vous connecter. Ce paramètre s’applique uniquement lors de la connexion à une géodatabase. Remarque : Si vous sélectionnez Historical (Historique) et qu’aucun nom n’est attribué, la version transactionnelle par défaut est utilisée. Si vous sélectionnez Point in time (Moment temporel) et qu’aucune date n’est attribuée au paramètre Date and Time (Date et heure), la version transactionnelle par défaut est utilisée. Transactionnelle—Se connecter à une version transactionnelle. Si vous sélectionnez Transactional (Transactionnel), le paramètre The following version will be used (La version suivante est utilisée) est renseigné avec une liste de versions transactionnelles et le paramètre Date and Time (Date et heure) est inactif. Il s'agit de l'option par défaut. Historique—Se connecter à un repère chronologique. Si vous sélectionnez Historical (Historique), le paramètre The following version will be used (La version suivante est utilisée) est renseigné avec la liste des repères chronologiques et le paramètre Date and Time (Date et heure) est inactif. Moment temporel—Se connecter à un point donné dans le temps. Si vous sélectionnez Point in time (Moment temporel), le paramètre The following version will be used (La version suivante est utilisée) est inactif et le paramètre Date and Time (Date et heur) est actif. Branche—Se connecter à la version de branche par défaut.	String
La version suivante est utilisée (Facultatif)	Version transactionnelle de la géodatabase ou repère chronologique auxquels se connecter. L’option par défaut utilise la version transactionnelle par défaut. Si vous choisissez un type de version de branche, la connexion est toujours établie avec la version de branche par défaut.	String
Date et heure (Facultatif)	Valeur représentant la date et l’heure utilisées pour se connecter à la base de données. Ce paramètre est utilisé avec des données archivables. Utilisez le sélecteur de date/heure pour choisir la date appropriée. Pour saisir une date manuellement, utilisez les formats suivants : 6/9/2011 4:20:15 PM 6/9/2011 16:20:15 6/9/2011 4:20:15 PM 16:20:15 Remarque : – Si une heure est saisie sans date, la date par défaut du 30 décembre 1899 est utilisée. – Si une date est saisie sans heure, l’heure par défaut 12:00:00 AM est utilisée.	Date

Sortie dérivée

Etiqueter	Explication	Type de données
Chaîne de connexion CIMDATA	Chaîne de connexion CIMDATA.	String

arcpy.management.CreateDatabaseConnectionString(database_platform, instance, {account_authentication}, {username}, {password}, {database}, {object_name}, {data_type}, {feature_dataset}, {schema}, {version_type}, {version}, {date})

Nom	Explication	Type de données
database_platform	Spécifie la plateforme de la base de données avec laquelle la connexion est établie. `SQL_SERVER`—Se connecter à Microsoft SQL Server ou à la base de données SQL Microsoft Azure. `ORACLE`—Se connecter à Oracle. `DB2`—Se connecter à IBM DB2 pour Linux, UNIX ou Windows. `POSTGRESQL`—Se connecter à PostgreSQL. `TERADATA`—Se connecter à Teradata Vantage. `SAP HANA`—Se connecter à SAP HANA. `DAMENG`—Se connecter à Dameng.	String
instance	Serveur de base de données ou instance avec lesquels la connexion est établie. La valeur de ce paramètre dépend de la valeur sélectionnée pour le paramètre Database Platform (Plateforme de la base de données).	String
account_authentication (Facultatif)	Spécifie le type d’authentification utilisé. `DATABASE_AUTH`—L’authentification de la base de données est utilisée. Un nom d’utilisateur et un mot de passe de base de données internes sont utilisés pour se connecter à la base de données. Vous n’êtes pas obligé d’entrer votre nom d’utilisateur et votre mot de passe pour créer une connexion ; cependant, si vous ne le faites pas, il vous sera demandé de les saisir lors de l’établissement d’une connexion. Il s’agit de l’option par défaut. Remarque : Si le fichier de connexion que vous créez est destiné à offrir des services ArcGIS avec accès à la base de données ou à la géodatabase, ou si vous souhaitez utiliser la recherche sur le Catalogue pour localiser les données auxquelles ce fichier de connexion accède, vous devez saisir un nom d'utilisateur et un mot de passe. `OPERATING_SYSTEM_AUTH`—L’authentification du système d’exploitation est utilisée. Vous n’avez pas besoin de saisir de nom d’utilisateur et de mot de passe. La connexion est établie avec le nom d’utilisateur et le mot de passe qui ont permis d’ouvrir une session sur le système d’exploitation. Si la connexion utilisée pour le système d'exploitation n'est pas une connexion de géodatabase valide, la connexion échoue.	Boolean
username (Facultatif)	Nom d’utilisateur de la base de données utilisé en cas de recours à l’authentification de la base de données.	String
password (Facultatif)	Mot de passe de l’utilisateur de base de données utilisé en cas de recours à l’authentification de la base de données.	Encrypted String
database (Facultatif)	Nom de la base de données à laquelle vous allez vous connecter. Ce paramètre ne s'applique qu'aux plateformes PostgreSQL et SQL Server.	String
object_name (Facultatif)	Nom du jeu de données ou de l’objet de la base de données vers lequel la chaîne de connexion pointe. Cette chaîne de connexion peut être utilisée comme chemin vers le jeu de données spécifié.	String
data_type (Facultatif)	Type de jeu de données ou d’objet auquel le nom d’objet du jeu de données fait référence. Si plusieurs objets de la base de données portent le même nom, vous devrez peut-être spécifier le type de données de l’objet pour lequel vous voulez créer une chaîne de connexion.	String
feature_dataset (Facultatif)	Nom du jeu de classes d’entités qui contient le jeu de données ou l’objet pour lequel vous voulez créer une chaîne de connexion. Si le jeu de données ne se trouve pas dans un jeu de classes d’entités (par exemple, s’il se trouve à la racine de la base de données), ne spécifiez pas de jeu de classes d’entités cible.	String
schema (Facultatif)	Les géodatabases de structure utilisateur ne sont plus prises en charge.	String
version_type (Facultatif)	Spécifie le type de version auquel vous allez vous connecter. Ce paramètre s’applique uniquement lors de la connexion à une géodatabase. Remarque : Si vous sélectionnez Historical (Historique) et qu’aucun nom n’est attribué, la version transactionnelle par défaut est utilisée. Si vous sélectionnez Point in time (Moment temporel) et qu’aucune date n’est attribuée au paramètre Date and Time (Date et heure), la version transactionnelle par défaut est utilisée. `TRANSACTIONAL`—Se connecter à une version transactionnelle. Si vous sélectionnez Transactional (Transactionnel), le paramètre The following version will be used (La version suivante est utilisée) est renseigné avec une liste de versions transactionnelles et le paramètre Date and Time (Date et heure) est inactif. Il s'agit de l'option par défaut. `HISTORICAL`—Se connecter à un repère chronologique. Si vous sélectionnez Historical (Historique), le paramètre The following version will be used (La version suivante est utilisée) est renseigné avec la liste des repères chronologiques et le paramètre Date and Time (Date et heure) est inactif. `POINT_IN_TIME`—Se connecter à un point donné dans le temps. Si vous sélectionnez Point in time (Moment temporel), le paramètre The following version will be used (La version suivante est utilisée) est inactif et le paramètre Date and Time (Date et heur) est actif. `BRANCH`—Se connecter à la version de branche par défaut.	String
version (Facultatif)	Version transactionnelle de la géodatabase ou repère chronologique auxquels se connecter. L’option par défaut utilise la version transactionnelle par défaut. Si vous choisissez un type de version de branche, la connexion est toujours établie avec la version de branche par défaut.	String
date (Facultatif)	Valeur représentant la date et l’heure utilisées pour se connecter à la base de données lors de l’utilisation de données archivables. Vous pouvez saisir les dates dans les formats suivants : 6/9/2011 4:20:15 PM 6/9/2011 16:20:15 6/9/2011 4:20:15 PM 16:20:15 Remarque : – Si une heure est saisie sans date, la date par défaut du 30 décembre 1899 est utilisée. – Si une date est saisie sans heure, l’heure par défaut 12:00:00 AM est utilisée.	Date

Sortie dérivée

Nom	Explication	Type de données
out_connection_string	Chaîne de connexion CIMDATA.	String

Exemple de code

Exemple d’utilisation de la fonction CreateDatabaseConnectionString (fenêtre Python)

Le script de fenêtre Python ci-après illustre l’utilisation de la fonction CreateDatabaseConnectionString en mode immédiat.

import arcpy
data_conn_str = arcpy.management.CreateDatabaseConnectionString("SQL_SERVER",
                                          "utah",
                                          "DATABASE_AUTH",
                                          "gdb",
                                          "gdb",
                                          "",
                                          "gdb.roads")
arcpy.analysis.Buffer(data_conn_str, r"c:\temp\Buffers.shp", "10 Miles")

Environnements

Espace de travail courant

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Créer une chaîne de connexion à une base de données (Outils de gestion des données)

Résumé

Utilisation

Paramètres

Remarque :

Remarque :

Remarque :

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes