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

Synthèse

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.

Paramètres

ÉtiquetteExplicationType 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 ServerSe connecter à Microsoft SQL Server ou à la base de données SQL Microsoft Azure.
  • OracleSe connecter à Oracle.
  • DB2Se connecter à IBM DB2 pour Linux, UNIX ou Windows.
  • PostgreSQLSe connecter à PostgreSQL.
  • TeradataSe connecter à l’appareil de stockage de données Teradata.
  • SAP HANASe connecter à SAP HANA.
  • DamengSe 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é.

  • Authentification de la base de données.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.

  • Authentification du système d’exploitationL’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
Schéma (géodatabases du schéma utilisateur d'Oracle uniquement)
(Facultatif)

Géodatabase de structure utilisateur à laquelle vous allez vous connecter. L’outil détermine s’il se connecte à une base de données Oracle qui contient une géodatabase de structure utilisateur. Si la base de données Oracle contient une structure utilisateur, cette option est active. Sinon, elle reste inactive. L'option par défaut pour ce paramètre consiste à utiliser la géodatabase de structure sde (principale).

String
Type de version
(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.

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.

  • TransactionnelleSe 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.
  • HistoriqueSe 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.
  • Moment temporelSe 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.
  • BrancheSe connecter à la version de branche par défaut.
String
La version suivante sera autorisé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 d'heures pour choisir la date appropriée.

Pour indiquer 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 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 obtenue

ÉtiquetteExplicationType 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})
NomExplicationType de données
database_platform

Spécifie la plateforme de la base de données avec laquelle la connexion est établie.

  • SQL_SERVERSe connecter à Microsoft SQL Server ou à la base de données SQL Microsoft Azure.
  • ORACLESe connecter à Oracle.
  • DB2Se connecter à IBM DB2 pour Linux, UNIX ou Windows.
  • POSTGRESQLSe connecter à PostgreSQL.
  • TERADATASe connecter à l’appareil de stockage de données Teradata.
  • SAP HANASe connecter à SAP HANA.
  • DAMENGSe 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_AUTHL’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_AUTHL’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.

  • TRANSACTIONALSe 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.
  • HISTORICALSe 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_TIMESe 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.
  • BRANCHSe 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 obtenue

NomExplicationType de données
out_connection_string

Chaîne de connexion CIMDATA.

String

Exemple de code

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

Le script ci-dessous pour la fenêtre Python 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

Cas particuliers

Informations de licence

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

Rubriques connexes