Resumen
Crea un archivo que ArcGIS utiliza para conectarse a una base de datos o a una geodatabase corporativa.
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.
Ya no se admiten las conexiones desde ArcGIS a Altibase y 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 administración de bases de datos a la cual se conectará. Estas son las opciones válidas:
| String |
instance | Instancia o servidor de base de datos al que se conectará. 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 conectará. Este parámetro solo se aplica a las plataformas de SQL Server y PostgreSQL. | String |
schema (Opcional) | La geodatabase de esquema del usuario a la que se conectará. 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 (maestra). | String |
version_type (Opcional) | Especifica el tipo de versión a la que se conectará.
Nota:Si se utiliza TRANSACTIONAL o HISTORICAL, se ignorará el parámetro date. Si se utiliza HISTORICAL y no se proporciona un nombre en el parámetro version, se utilizará la versión transaccional predeterminada. Si se utiliza POINT_IN_TIME y no se proporciona una fecha en el parámetro date, se utilizará la versión transaccional predeterminada. | String |
version (Opcional) | La versión transaccional de la geodatabase o marcador histórico al que se conectará. Para la opción predeterminada se utiliza la versión transaccional predeterminada. Si elige un tipo de versión en rama, la conexión se realiza siempre a la versión de rama 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:
Nota:
| Date |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_workspace | El archivo de conexión de base de datos de salida (archivo .sde). | espacio de trabajo |
Muestra de código
El script de la ventana de Python muestra cómo utilizar la herramienta CreateDatabaseConnection en el modo inmediato.
import arcpy
arcpy.CreateDatabaseConnection_management("C:\\MyProject",
"utah.sde",
"SQL_SERVER",
"utah",
"DATABASE_AUTH",
"gdb",
"gdb",
"SAVE_USERNAME",
"garfield",
"#",
"TRANSACTIONAL",
"sde.DEFAULT")
El siguiente script independiente muestra cómo utilizar la herramienta 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")
El siguiente script de la ventana de Python muestra cómo utilizar la herramienta 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",
"#")
El siguiente script de la ventana de Python muestra cómo utilizar la herramienta 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í