Créer une connexion à une base de données (Gestion des données)
Récapitulatif
Permet de créer un fichier de connexion pour établir une connexion à une base de données ou à une géodatabase d'entreprise, de groupe de travail ou de bureau.
Utilisation
Lorsque vous utilisez la boîte de dialogue de l'outil et que vous entrez des informations de connexion valides, l'outil se connecte à la base de données pour déterminer si elle contient la structure de géodatabase. S'il trouve la structure, le serveur attribue automatiquement la structure SDE (pour les géodatabases de structure utilisateur Oracle) au paramètre Structure, le mot-clé TRANSACTIONAL au paramètre Type de version, puis attribue le nom de version Par défaut au paramètre correspondant.
Pour empêcher l'enregistrement de vos informations de connexion dans la fenêtre Résultats ou leur stockage dans les fichiers journaux d'historique de géotraitement, vous devez désactiver la consignation dans l'historique et enregistrer le fichier de connexion sans enregistrer les informations de connexion vous souhaitez masquer.
Tous les paramètres de la section Propriétés de connexion de la géodatabase de la boîte de dialogue de l'outil sont ignorés lors d'une connexion à une base de données qui n'est pas une géodatabase.
Syntaxe
| Paramètre | Explication | Type de données |
out_folder_path |
Chemin d'accès au dossier dans lequel le fichier de connexion à une base de données (fichier .sde) sera stocké. | Folder |
out_name |
Nom du fichier de connexion à une base de données. Le fichier en sortie portera l'extension .sde. | String |
database_platform |
Plateforme de SGBD vers laquelle la connexion est établie. Les options valides sont les suivantes :
| String |
instance | Serveur de base de données ou instance auxquels se connecter. La valeur que vous attribuez au paramètre database_platform indique le type de base de données à laquelle vous souhaitez vous connecter. La valeur du paramètre instance dépend de la plate-forme de base de données que vous spécifiez. Vous trouverez ci-dessous les informations à fournir pour chaque plate-forme de base de données.
| String |
account_authentication (Facultatif) |
| Boolean |
username (Facultatif) |
Nom d'utilisateur de la base de données permettant une connexion via l'authentification de la base de données. | String |
password (Facultatif) |
Mot de passe de l'utilisateur de base de données avec l'option Authentification de la base de données. | Encrypted String |
save_user_pass (Facultatif) |
| Boolean |
database (Facultatif) |
Nom de la base de données à laquelle vous vous connectez. Ce paramètre ne s'applique qu'aux plateformes PostgreSQL et SQL Server. | String |
schema (Facultatif) | Géodatabase de structure utilisateur à laquelle vous vous connectez. 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 version Par défaut. | String |
version_type (Facultatif) | Type de version auquel vous souhaitez vous connecter.
Si TRANSACTIONAL ou HISTORICAL est utilisé, le paramètre date est ignoré. Si vous utilisez HISTORICAL et qu'aucun nom n'est attribué au paramètre version_name, la version transactionnelle Par défaut est utilisée. Si vous utilisez POINT_IN_TIME et qu'aucune date n'est attribuée au paramètre date, 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 consiste à utiliser la version Par défaut. | String |
date (Facultatif) | Valeur représentant la date et l'heure utilisées pour se connecter à la base de données. Pour utiliser des données archivées. Vous pouvez indiquer les dates dans les formats suivants :
 Remarque :
| Date |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil CreateDatabaseConnection en mode immédiat.
import arcpy
arcpy.CreateDatabaseConnection_management("Database Connections",
"utah.sde",
"SQL_SERVER",
"utah",
"DATABASE_AUTH",
"gdb",
"gdb",
"SAVE_USERNAME",
"garfield",
"#",
"TRANSACTIONAL",
"sde.DEFAULT")
Le script autonome ci-dessous illustre l'utilisation de l'outil CreateDatabaseConnection.
# Name: CreateDatabaseConnection2.py
# Description: Connects to a database using Easy Connect string
# and operating system authentication.
# Import system modules
import arcpy
# Run the tool
arcpy.CreateDatabaseConnection_management("Database Connections",
"zion.sde",
"ORACLE",
"zionserver/ORCL",
"OPERATING_SYSTEM_AUTH")
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil CreateDatabaseConnection pour une connexion à un repère chronologique.
# Name: CreateDatabaseConnection3.py
# Description: Connects to a geodatabase historical marker using a
# cataloged DB2 database and database authentication.
# Import system modules
import arcpy
# Run the tool
arcpy.CreateDatabaseConnection_management("Database Connections",
"history.sde",
"DB2",
"DB2_DS",
"DATABASE_AUTH",
"butch",
"sundance",
"SAVE_USERNAME",
"#",
"#",
"HISTORICAL",
"June 9, 2010",
"#")
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil CreateDatabaseConnection pour une connexion à un point dans le temps.
# Name: CreateDatabaseConnection4.py
# Description: Connects to a point in time in the geodatabase in
# PostgreSQL using database authentication.
# Import system modules
import arcpy
# Run the tool
arcpy.CreateDatabaseConnection_management("Database Connections",
"history.sde",
"POSTGRESQL",
"dbserver",
"DATABASE_AUTH",
"stevie",
"smith",
"SAVE_USERNAME",
"archivedb",
"#",
"POINT_IN_TIME",
"#",
"5/19/2011 8:43:41 AM")