Créer un fichier de connexion à ArcSDE

Récapitulatif

Permet de créer un fichier de connexion à une base de données pour établir une connexion à une géodatabase d'entreprise à l'aide d'un service ArcSDE.

Utilisation

• Le Nom du fichier de connexion ArcSDE doit inclure une extension de fichier .sde.

• Lorsque vous entrez des informations de connexion valides, l'outil indique dans la liste les versions des géodatabases auxquelles l'utilisateur connecté est autorisé à accéder.

• 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, désactivez la consignation dans l'historique et enregistrez le fichier de connexion sans enregistrer les informations de connexion que vous ne souhaitez pas afficher.

• N'utilisez cet outil que pour connecter le serveur d'applications (service ArcSDE) à une géodatabase de version 10.2.2 ou antérieure. Si vous souhaitez établir une connexion à une géodatabase de version 10.3 ou ultérieure, ou si vous souhaitez vous connecter directement à une géodatabase de version 10.2.2 ou antérieure, utilisez plutôt l'outil Créer une connexion à une base de données.

Syntaxe

CreateArcSDEConnectionFile_management (out_folder_path, out_name, server, service, {database}, {account_authentication}, {username}, {password}, {save_username_password}, {version}, {save_version_info})

Paramètre	Explication	Type de données
out_folder_path	Chemin d'accès au dossier dans lequel le fichier .sde sera stocké.	Folder
out_name	Nom du fichier de connexion. Utilisez l'extension de fichier .sde.	String
server	Nom de l'ordinateur sur lequel le serveur d'application ArcSDE est installé.	String
service	Nom du service ArcSDE ou numéro de port TCP.	String
database (Facultatif)	Nom de la base de données à laquelle se connecter. N'indiquez pas de nom de base de données pour une connexion à Oracle.	String
account_authentication (Facultatif)	DATABASE_AUTH —Authentification de la base de données. Utilise un nom d'utilisateur et un mot de passe de base de données internes pour se connecter au SGBD. 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. OPERATING_SYSTEM_AUTH —Utilisez l'authentification du système d'exploitation. Vous n'avez pas besoin de saisir de nom d'utilisateur et de mot de passe. La connexion est établie avec les informations d'identification 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. Notez également que vous ne pouvez pas établir de connexion de service ArcSDE à l'aide de l'authentification du système d'exploitation à une géodatabase stockée dans Oracle, DB2 ou Informix.	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_username_password (Facultatif)	SAVE_USERNAME —Enregistre le nom d'utilisateur et le mot de passe dans le fichier de connexion. DO_NOT_SAVE_USERNAME —N'enregistre pas le nom d'utilisateur et le mot de passe dans le fichier. Chaque fois que vous vous connectez à l'aide du fichier, vous êtes invité à entrer un nom d'utilisateur et un mot de passe.	Boolean
version (Facultatif)	Version de la géodatabase à laquelle se connecter. Par défaut, les connexions sont établies avec la version DEFAULT.	String
save_version_info (Facultatif)	SAVE_VERSION —Le nom de la version est enregistré dans le fichier de connexion. DO_NOT_SAVE_VERSION —Le nom de la version n'est pas enregistré dans le fichier de connexion. Si le nom de la version n'est pas enregistré avec le fichier, une connexion à la version DEFAULT est établie lors de votre prochain accès au fichier de connexion.	Boolean

Exemple de code

1er exemple d'utilisation de l'outil CreateArcSDEConnectionFile (fenêtre Python)

Le script de fenêtre Python suivant illustre l'utilisation de la fonction CreateArcSDEConnectionFile en mode immédiat.

import arcpy
arcpy.CreateArcSDEConnectionFile_management(r'c:\connectionFiles',
                                            'gpserver',
                                            '5151',
                                            '',
                                            'toolbox',
                                            'toolbox',
                                            'SAVE_USERNAME',
                                            'SDE.DEFAULT',
                                            'SAVE_VERSION')

2e exemple d'utilisation de l'outil CreateArcSDEConnectionFile à ArcSDE (script autonome)

Le script autonome suivant est un exemple d'application de la fonction CreateArcSDEConnectionFile dans un environnement de scripts.

# CreateArcSDEConnection.py
# Description: Simple example showing use of CreateArcSDEConnectionFile tool
 
# Import system modules
import arcpy

# Set variables
folderName = r"c:\connectionFiles"
fileName = "Connection to gpserver.sde"
serverName = "gpserver"
serviceName = "5151"
databaseName = ""
authType = "DATABASE_AUTH"
username = "toolbox"
password = "toolbox"
saveUserInfo = "SAVE_USERNAME"
versionName = "SDE.DEFAULT"
saveVersionInfo = "SAVE_VERSION"

# Process: Use the CreateArcSDEConnectionFile function
arcpy.CreateArcSDEConnectionFile_management (folderName,
                                             fileName,
                                             serverName,
                                             serviceName,
                                             databaseName,
                                             authType,
                                             username,
                                             password,
                                             saveUserInfo,
                                             versionName,
                                             saveVersionInfo)

Environnements

• Espace de travail courant

Informations de licence

• ArcGIS for Desktop Basic: Annuler
• ArcGIS for Desktop Standard: Oui
• ArcGIS for Desktop Advanced: Oui

Vous avez un commentaire à formuler concernant cette rubrique ?