Résumé
Crée un fichier que ArcGIS utilise pour établir une connexion à une base de données ou à une géodatabase d’entreprise, de groupe de travail ou de bureau.
Utilisation
Une fois les informations de connexion appropriées saisies dans la boîte de dialogue de l’outil, l’outil se connecte à la base de données pour déterminer si elle contient la structure de géodatabase.
- Pour les bases de données, tous les paramètres de la section Geodatabase Connection Properties (Propriétés de connexion de géodatabase) de la boîte de dialogue de l’outil sont ignorés.
- Pour les géodatabases, l’outil renseigne automatiquement la section Geodatabase Connection Properties (Propriétés de connexion de géodatabase). Le paramètre Structure est définit avec la structure sde (pour les géodatabases de structure utilisateur Oracle uniquement), le type de version par défaut pour la géodatabase et la version Default.
Si vous ne souhaitez pas enregistrer vos informations de connexion dans la fenêtre Results (Résultats) ou si vous ne souhaitez pas les stocker dans les fichiers journaux d’historique de géotraitement, désactivez la consignation dans l’historique et enregistrez le fichier de connexion sans enregistrer les informations de connexion.
Les connexions d’ArcGIS vers Altibase et Netezza ne sont plus prises en charge.
Syntaxe
arcpy.management.CreateDatabaseConnection(out_folder_path, out_name, database_platform, instance, {account_authentication}, {username}, {password}, {save_user_pass}, {database}, {schema}, {version_type}, {version}, {date})| 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 (.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 | Spécifie la plateforme de système de gestion de base de données avec laquelle la connexion est établie. Les options valides sont les suivantes :
| String |
instance | Serveur de base de données ou instance avec lesquels la connexion est établie. 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 plateforme 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) | Spécifie le type d’authentification utilisé.
| Boolean |
username (Facultatif) | Nom d’utilisateur de la base de données utilisé dans le cadre de l’authentification de la base de données. | String |
password (Facultatif) | Mot de passe d’utilisateur de la base de données utilisé dans le cadre de l’authentification de la base de données. | Encrypted String |
save_user_pass (Facultatif) | Indique si le nom d’utilisateur et le mot de passe sont enregistrés.
| Boolean |
database (Facultatif) | Nom de la base de données avec laquelle la connexion est établie. Ce paramètre ne s’applique qu’aux plateformes PostgreSQL et SQL Server. | String |
schema (Facultatif) | Géodatabase du schéma utilisateur avec laquelle la connexion est établie. 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 de ce paramètre consiste à utiliser la géodatabase de structure sde. | String |
version_type (Facultatif) | Spécifie le type de version avec lequel la connexion est établie.
| String |
version (Facultatif) | Version transactionnelle de la géodatabase ou repère chronologique avec laquelle ou lequel la connexion est établie. L’option par défaut utilise la version transactionnelle 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 :
| Date |
Sortie dérivée
| Nom | Explication | Type de données |
| out_workspace | Fichier de connexion à la base de données en sortie (.sde). | workspace |
Exemple de code
Exemple 1 d'utilisation de l'outil CreateDatabaseConnection (fenêtre Python)
Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction CreateDatabaseConnection en mode immédiat.
import arcpy
arcpy.CreateDatabaseConnection_management("C:\\MyProject",
"utah.sde",
"SQL_SERVER",
"utah",
"DATABASE_AUTH",
"gdb",
"gdb",
"SAVE_USERNAME",
"garfield",
"#",
"TRANSACTIONAL",
"sde.DEFAULT")
Exemple 2 d'utilisation de l'outil CreateDatabaseConnection (script autonome)
Le script autonome ci-dessous illustre l’utilisation de la fonction 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("C:\\MyProject",
"zion.sde",
"ORACLE",
"zionserver/ORCL",
"OPERATING_SYSTEM_AUTH")
Exemple 3 d'utilisation de l'outil CreateDatabaseConnection (fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction 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("C:\\MyProject",
"history.sde",
"DB2",
"DB2_DS",
"DATABASE_AUTH",
"butch",
"sundance",
"SAVE_USERNAME",
"#",
"#",
"HISTORICAL",
"June 9, 2010",
"#")
Exemple 4 d'utilisation de l'outil CreateDatabaseConnection (fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction CreateDatabaseConnection pour une connexion à un moment donné.
# 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("C:\\MyProject",
"history.sde",
"POSTGRESQL",
"dbserver",
"DATABASE_AUTH",
"stevie",
"smith",
"SAVE_USERNAME",
"archivedb",
"#",
"POINT_IN_TIME",
"#",
"5/19/2011 8:43:41 AM")
Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui