ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • Aide
  • Sign Out
ArcGIS Desktop

ArcGIS Online

La plateforme cartographique de votre organisation

ArcGIS Desktop

Un SIG professionnel complet

ArcGIS Enterprise

SIG dans votre entreprise

ArcGIS for Developers

Outils de création d'applications de localisation

ArcGIS Solutions

Modèles d'applications et de cartes gratuits pour votre secteur d'activité

ArcGIS Marketplace

Téléchargez des applications et des données pour votre organisation.

  • Documentation
  • Support
Esri
  • Se connecter
user
  • Mon profil
  • Déconnexion

ArcMap

  • Accueil
  • Commencer
  • Carte
  • Analyser
  • Gérer les données
  • Outils
  • Extensions

Créer une connexion à une base de données

  • Résumé
  • Utilisation
  • Syntaxe
  • Exemple de code
  • Environnements
  • Informations de licence

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 Schema (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.

  • L’utilisation d’Altibase avec ArcGIS est obsolète. Cette option est toujours présente dans cette version, mais elle sera supprimée dans une future version de ArcGIS.

Syntaxe

CreateDatabaseConnection(out_folder_path, out_name, database_platform, instance, {account_authentication}, {username}, {password}, {save_user_pass}, {database}, {schema}, {version_type}, {version}, {date})
ParamètreExplicationType 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

Spécifie la plateforme du système de gestion de bases de données à laquelle vous allez vous connecter. Les options valides sont les suivantes :

  • DAMENG —Se connecter à Dameng
  • DB2 —Se connecter à IBM DB2 pour Linux, UNIX ou Windows
  • DB2ZOS —Se connecter à IBM DB2 pour le système d'exploitation z
  • INFORMIX —Se connecter à IBM Informix
  • NETEZZA —Se connecter à IBM Netezza
  • ORACLE —Se connecter à Oracle
  • POSTGRESQL —Se connecter à PostgreSQL
  • SAP HANA —Se connecter à SAP HANA
  • SQL_SERVER —Se connecter à Microsoft SQL Server ou à la base de données SQL Microsoft Azure
  • TERADATA —Se connecter à l'appareil de stockage de données Teradata
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 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.

  • Dameng : nom du serveur sur lequel la base de données Dameng est installée
  • DB2 : nom de la base de données Db2 cataloguée
  • DB2 pour Z/OS : nom de la base de données Db2 cataloguée
  • Informix : nom de la source de données ODBC (Open Database Connectivity) de la base de données Informix
  • Oracle : nom TNS ou chaîne Easy Connection d'Oracle pour vous connecter à la base de données Oracle
  • Netezza : source de données ODBC pour la base de données Netezza
  • PostgreSQL : nom du serveur sur lequel PostgreSQL est installé
  • SAP HANA : nom de la source de données ODBC pour la base de données SAP HANA
  • SQL Server : nom de l'instance SQL Server ou SQL Database
  • Teradata : source de données ODBC pour la base de données Teradata
String
account_authentication
(Facultatif)

Précise le type d’authentification qui sera utilisé.

  • DATABASE_AUTH —L’authentification de la base de données est utilisée. Nom d’utilisateur et mot de passe de base de données internes 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, ils vous sera demandé de les saisir lors de l'établissement d'une connexion.
    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é dans le cadre de l’authentification de la base de données.

String
password
(Facultatif)

Mot de passe de l’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.

  • SAVE_USERNAME —Le nom d’utilisateur et le mot de passe sont enregistrés dans le fichier de connexion. Il s’agit de l'option par défaut. 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 enregistrer un nom d'utilisateur et un mot de passe.
  • DO_NOT_SAVE_USERNAME —Le nom d’utilisateur et le mot de passe ne sont pas enregistrés dans le fichier. Chaque fois que vous essayez de vous connecter à l'aide du fichier, vous êtes invité à entrer le nom d'utilisateur et le mot de passe.
Boolean
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
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)

Indique le type de version auquel vous souhaitez vous connecter.

  • TRANSACTIONAL —Connexion à version transactionnelle.
  • HISTORICAL —Connexion à un repère chronologique.
  • POINT_IN_TIME —Connexion à un point donné dans le temps. Si vous utilisez POINT_IN_TIME ou version, le paramètre date est ignoré.
  • BRANCH —Connexion à la version de branche par défaut.

Remarque :

Si vous utilisez TRANSACTIONAL ou HISTORICAL, le paramètre date est ignoré. Si vous utilisez HISTORICAL et qu’aucun nom n’est attribué au paramètre version, 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 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 lorsque vous utilisez des 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

NomExplicationType de données
out_workspace

Fichier de connexion à la base de données en sortie (fichier .sde).

espace de travail

Exemple de code

Exemple 1 d'utilisation de l'outil CreateDatabaseConnection (fenêtre Python)

Le script de fenêtre Python suivant montre comment utiliser l'outil 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 suivant 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("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 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("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 l'outil 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

  • Espace de travail courant

Informations de licence

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

Rubriques connexes

  • Vue d'ensemble du jeu d'outils Espace de travail

ArcGIS Desktop

  • Accueil
  • Documentation
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

A propos d'Esri

  • A propos de la société
  • Carrières
  • Blog d’Esri
  • Conférence des utilisateurs
  • Sommet des développeurs
Esri
Donnez-nous votre avis.
Copyright © 2019 Esri. | Confidentialité | Légal