Créer une chaîne de connexion à une base de données (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 depuis ArcGIS vers Altibase et Netezza ne sont plus prises en charge.

Syntaxe

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

Paramètre	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 à l’appareil de stockage de données Teradata. SAP HANA —Se connecter à SAP HANA. DAMENG —Se connecter à Dameng. INFORMIX —Se connecter à IBM Informix.	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)	Géodatabase de structure utilisateur à laquelle vous allez vous connecter. Cette option ne s'applique qu'aux bases de données Oracle qui contiennent au moins une géodatabase de structure utilisateur. La valeur par défaut pour ce paramètre consiste à utiliser la géodatabase de structure sde (principale).	String
version_type (Facultatif)	Spécifie le type de version auquel vous allez vous connecter. Ce paramètre s’applique uniquement lorsque vous vous connectez à une géodatabase. TRANSACTIONAL —Se connecter à une version transactionnelle. Si vous sélectionnez Transactional (Transactionnel), le paramètre The following version will be used (La version suivante sera utilisée) est complété 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 sera utilisée) est complété avec une liste de 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 sera utilisée) est inactif et le paramètre Date and Time (Date et heure) est actif. BRANCH —Se connecter à la version de branche par défaut. 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.	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 indiquer 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 spécifiée sans date, la date par défaut du 30 décembre 1899 est utilisée. Si une date n'est associée à aucune heure, l'heure par défaut est utilisée, à savoir 12:00:00 AM.	Date

Sortie dérivée

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

Exemple de code

Exemple d’utilisation de l’outil CreateDatabaseConnectionString (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction CreateDatabaseConnectionString en mode immédiat.

import arcpy
data_conn_str = arcpy.CreateDatabaseConnectionString_management("SQL_SERVER",
                                          "utah",
                                          "DATABASE_AUTH",
                                          "gdb",
                                          "gdb", 
                                          "",
                                          "gdb.roads")
arcpy.Buffer_analysis(data_conn_str, r"c:\temp\Buffers.shp", "10 Miles")

Environnements

Espace de travail courant

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui