Crear archivo de conexión de ArcSDE (Administración de datos)

Resumen

Crea un archivo de conexión de ArcSDE para conectarse a las geodatabases de ArcSDE.

Uso

• A pesar de que puede introducir cualquier extensión de archivo para el Nombre del archivo de conexión de ArcSDE, debe utilizar la extensión de archivo estándar .sde para que ArcGIS lo reconozca directamente.

• Cuando se introduce la información de conexión válida, la herramienta se conectará al servidor de ArcSDE para completar la lista de versiones con versiones a las que el usuario tiene permiso para conectarse.

• Consulte Un recorrido rápido por las conexiones a geodatabases de ArcSDE para obtener una explicación más completa de las propiedades de conexión de ArcSDE.

• Si desea evitar que la información de conexión quede guardada en la ventana Resultados o almacenada en los archivos de registro de historial de geoprocesamiento, deberá desactivar el registro de historial y guardar el archivo de conexión de ArcSDE sin guardar la información de conexión que desea ocultar.

• Esta herramienta solo se debe utilizar para crear conexiones de un servidor de aplicaciones a la geodatabase. Si desea crear conexiones directas entonces debe utilizar la herramienta Crear conexión de base de datos.

Sintaxis

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

Parámetro	Explicación	Tipo de datos
out_folder_path	La ruta de la carpeta donde se guardará el archivo .sde.	Folder
out_name	El nombre del archivo de conexión ArcSDE. Utilice la extensión de archivo .sde.	String
server	El nombre del equipo de ArcSDE Server.	String
service	El nombre de ArcSDE Service o el número de puerto TCP.	String
database (Opcional)	Únicamente para bases de datos que no sean Oracle. La base de datos DBMS a la que se conectará.	String
account_authentication (Opcional)	DATABASE_AUTH —Autenticación de base de datos. Utiliza un nombre de usuario y una contraseña de base de datos internos para conectarse al DBMS. No se le requiere que escriba su nombre de usuario y contraseña para crear una conexión; sin embargo, si no lo hace, se le solicitará que los introduzca cuando se establezca una conexión. OPERATING_SYSTEM_AUTH —Utilizar autenticación de sistema operativo. No es necesario que escriba un nombre de usuario y una contraseña. La conexión se realizará con el nombre de usuario y la contraseña utilizados para iniciar sesión en el sistema operativo. Si la identificación de acceso utilizada para el sistema operativo no es una identificación de geodatabase válida, fallará la conexión. Además, tenga en cuenta que si está creando una conexión a una geodatabase almacenada en Oracle, DB2 o Informix, debe utilizar una conexión directa a la base de datos.	Boolean
username (Opcional)	Nombre del usuario de la base de datos con el que se conectará utilizando la Autenticación de base de datos.	String
password (Opcional)	Contraseña del usuario de la base de datos al utilizar Autenticación de base de datos.	Encrypted String
save_username_password (Opcional)	SAVE_USERNAME —Guarda el nombre de usuario y la contraseña en el archivo de conexión. DO_NOT_SAVE_USERNAME —No guarda el nombre de usuario y la contraseña en el archivo de conexión. Cada vez que intente conectarse con el archivo, se le solicitará el nombre de usuario y la contraseña.	Boolean
version (Opcional)	Versión de la geodatabase a la que se conectará.	String
save_version_info (Opcional)	SAVE_VERSION —Guarda el nombre de versión en el archivo de conexión. DO_NOT_SAVE_VERSION —No guarda el nombre de versión en el archivo de conexión. Si no se guarda el nombre de la versión con el archivo, la próxima vez que acceda al archivo de conexión se establecerá una conexión a la versión predeterminada.	Boolean

Ejemplo de código

Ejemplo de CreateArcSDEConnectionFile (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función CreateArcSDEConnectionFile en el modo inmediato.

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

Ejemplo 2 de CreateArcSDEConnectionFile (secuencia de comandos independiente)

La siguiente secuencia de comandos independiente es un ejemplo simple de cómo aplicar la función CreateArcSDEConnectionFile en secuencias de comandos.

# 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)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información sobre licencias

ArcGIS for Desktop Basic: No

ArcGIS for Desktop Standard: Sí

ArcGIS for Desktop Advanced: Sí