Resumen
Crea un archivo que ArcGIS utiliza para conectarse a una base de datos o a una geodatabase corporativa, de grupo de trabajo o de escritorio.
Uso
Cuando se introduce una información de conexión válida para establecer una conexión en el cuadro de diálogo de la herramienta, la herramienta se conecta a la base de datos para determinar si contiene el esquema de la geodatabase.
- En el caso de las bases de datos, todos los parámetros de la sección Propiedades de conexión a geodatabase del cuadro de diálogo de la herramienta se ignoran.
- En el caso de las geodatabases, la herramienta completa automáticamente la sección Propiedades de conexión a geodatabase. El parámetro Esquema se configura con el esquema sde (solo para geodatabases de esquema de usuario de Oracle), el Tipo de versión predeterminado para la geodatabase y la versión predeterminada.
Si no desea guardar la información de conexión en la ventana Resultados o si no desea almacenarla 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.
Ya no se admiten las conexiones desde ArcGIS a Altibase ni Netezza.
Sintaxis
arcpy.management.CreateDatabaseConnection(out_folder_path, out_name, database_platform, instance, {account_authentication}, {username}, {password}, {save_user_pass}, {database}, {schema}, {version_type}, {version}, {date})
Parámetro | Explicación | Tipo de datos |
out_folder_path | La ruta de la carpeta donde se guardará el archivo de conexión de la base de datos (.sde). | Folder |
out_name | El nombre del archivo de conexión de base de datos. El archivo de salida tendrá la extensión .sde. | String |
database_platform | Especifica la plataforma de sistema de gestión de bases de datos a la cual se realizará la conexión. Estas son las opciones válidas:
| String |
instance | El servidor de base de datos o instancia al cual se realizará la conexión. El valor que especifique para el parámetro database_platform indica el tipo de base de datos al que desea conectarse. La información que proporciona para el parámetro instance varía en función de la plataforma de base de datos que especifique. Consulte a continuación para obtener más información sobre qué información se debe proporcionar para cada plataforma de base de datos.
| String |
account_authentication (Opcional) | Especifica el tipo de autenticación que se utilizará.
| Boolean |
username (Opcional) | El nombre de usuario de la base de datos que se utilizará para la autenticación de base de datos. | String |
password (Opcional) | La contraseña de la base de datos que se utilizará para la autenticación de base de datos. | Encrypted String |
save_user_pass (Opcional) | Especifica si se guardarán el nombre de usuario y la contraseña.
| Boolean |
database (Opcional) | El nombre de la base de datos a la cual se realizará la conexión. Este parámetro solo se aplica a las plataformas de PostgreSQL y SQL Server. | String |
schema (Opcional) | La geodatabase del esquema de usuario a la que se realizará la conexión. Esta opción solo se aplica a las bases de datos de Oracle que contienen al menos una geodatabase de esquema de usuario. El valor predeterminado para este parámetro es utilizar la geodatabase de esquema de sde. | String |
version_type (Opcional) | Especifica el tipo de versión al cual se realizará la conexión.
| String |
version (Opcional) | La versión transaccional de la geodatabase o marcador histórico al que se realizará la conexión. Para la opción predeterminada se utiliza la versión transaccional predeterminada. | String |
date (Opcional) | El valor que representa la fecha y la hora que se utilizarán para conectarse a la base de datos al trabajar con datos habilitados para el archivado. Las fechas se pueden introducir en los siguientes formatos:
| Date |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_workspace | El archivo de conexión de base de datos de salida (archivo .sde). | workspace |
Muestra de código
Ejemplo 1 de CreateDatabaseConnection (ventana de Python)
La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función CreateDatabaseConnection de modo inmediato.
import arcpy
arcpy.CreateDatabaseConnection_management("C:\\MyProject",
"utah.sde",
"SQL_SERVER",
"utah",
"DATABASE_AUTH",
"gdb",
"gdb",
"SAVE_USERNAME",
"garfield",
"#",
"TRANSACTIONAL",
"sde.DEFAULT")
Ejemplo 2 de CreateDatabaseConnection (script independiente)
El siguiente script independiente muestra cómo utilizar la función 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")
Ejemplo 3 de CreateDatabaseConnection (ventana de Python)
El siguiente script de la ventana de Python muestra cómo utilizar la función CreateDatabaseConnection para conectarse a un marcador histórico.
# 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",
"#")
Ejemplo 4 de CreateDatabaseConnection (ventana de Python)
El siguiente script de la ventana de Python muestra cómo utilizar la función CreateDatabaseConnection para conectarse a un punto en el tiempo.
# 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")
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí