Crear archivo de conexión de ArcSDE

Resumen

Crea un archivo de conexión de base de datos para conectarse a una geodatabase corporativa mediante un servicio ArcSDE.

Uso

• El Nombre del archivo de conexión de ArcSDE debe incluir una extensión de archivo .sde.

• Cuando se introduce información de conexión válida, la herramienta rellena la lista de versiones con las versiones de la geodatabase para las que el usuario conectado tiene permiso de acceso.

• Si desea evitar que la información de conexión quede guardada en la ventana Resultados o almacenada en los archivos de registro del historial de geoprocesamiento, desactive el registro de historial y guarde el archivo de conexión sin guardar la información de conexión que no desee mostrar.

• Esta herramienta solo se debe utilizar para crear conexiones de un servidor de aplicaciones (servicio ArcSDE) a una geodatabase de la versión 10.2.2 o de una versión anterior. Si desea conectarse a una geodatabase de la versión 10.3 o de una versión posterior o conectarse directamente a una geodatabase de la versión 10.2.2 o de una versión anterior, use la herramienta Crear conexión 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	Nombre del archivo de conexión. Utilice la extensión de archivo .sde.	String
server	Nombre del equipo en el que está instalado el servidor de aplicaciones ArcSDE.	String
service	Nombre del servicio ArcSDE o número de puerto TCP.	String
database (Opcional)	El nombre de la base de datos con la que desea establecer conexión. No proporcione un nombre de base de datos si va a conectarse a Oracle.	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 es necesario 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 las credenciales utilizadas 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. Recuerde también que no puede establecer una conexión de servicio ArcSDE con autenticación de sistema operativo a una geodatabase almacenada en Oracle, DB2 o Informix.	Boolean
username (Opcional)	Nombre de usuario de base de datos con el que se debe conectar cuando se utiliza 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 usando el archivo, se le pedirán un nombre de usuario y una contraseña.	Boolean
version (Opcional)	Versión de la geodatabase con la que se va a establecer conexión. De manera predeterminada, las conexiones se realizan con la versión DEFAULT.	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 DEFAULT.	Boolean

Muestra de código

Ejemplo 1 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 de cómo aplicar la función CreateArcSDEConnectionFile en las 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

• Espacio de trabajo actual

Información sobre licencias

• ArcGIS Desktop Basic: No
• ArcGIS Desktop Standard: Sí
• ArcGIS Desktop Advanced: Sí