Resumen
La herramienta Crear conexión de la base de datos 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
Si introduce información de conexión válida al utilizar el cuadro de diálogo de la herramienta, la herramienta se conecta a la base de datos para determinar si esta contiene el esquema de la geodatabase. Si se encuentra el esquema, la herramienta rellena automáticamente el parámetro Esquema con el esquema sde (para geodatabases de esquema de usuario de Oracle solamente), el parámetro Tipo de versión con la palabra clave Transaccional y el parámetro de la versión con el nombre de 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.
Todos los parámetros en la sección Propiedades de conexión de la geodatabase del cuadro de diálogo de la herramienta se ignoran cuando se conecta a una base de datos que no contiene una geodatabase.
Sintaxis
CreateDatabaseConnection_management (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 | La plataforma del sistema de administración de bases de datos al 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 variará según 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) |
| Boolean |
username (Opcional) | El nombre de usuario de base de datos al utilizar 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_user_pass (Opcional) |
| 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 desea conectarse. 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) | El tipo de versión a la que desea conectarse.
Si se utiliza TRANSACTIONAL o HISTORICAL, se ignorará el parámetro de fecha. Si se utiliza HISTORICAL y no se proporciona un nombre en el parámetro version_name, 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. | String |
date (Opcional) | El valor que representa la fecha y la hora que se utilizan para conectarse a la base de datos. Para trabajar con datos con archivado habilitado. Las fechas se pueden introducir en los siguientes formatos:
| Date |
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 herramienta CreateDatabaseConnection en el modo inmediato.
import arcpy
arcpy.CreateDatabaseConnection_management("Database Connections",
"utah.sde",
"SQL_SERVER",
"utah",
"DATABASE_AUTH",
"gdb",
"gdb",
"SAVE_USERNAME",
"garfield",
"#",
"TRANSACTIONAL",
"sde.DEFAULT")
Ejemplo 2 de CreateDatabaseConnection (secuencia de comandos independiente)
La siguiente secuencia de comandos 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("Database Connections",
"zion.sde",
"ORACLE",
"zionserver/ORCL",
"OPERATING_SYSTEM_AUTH")
Ejemplo 3 de CreateDatabaseConnection (ventana de Python)
La siguiente secuencia de comandos 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("Database Connections",
"history.sde",
"DB2",
"DB2_DS",
"DATABASE_AUTH",
"butch",
"sundance",
"SAVE_USERNAME",
"#",
"#",
"HISTORICAL",
"June 9, 2010",
"#")
Ejemplo 4 de CreateDatabaseConnection (ventana de Python)
La siguiente secuencia de comandos 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("Database Connections",
"history.sde",
"POSTGRESQL",
"dbserver",
"DATABASE_AUTH",
"stevie",
"smith",
"SAVE_USERNAME",
"archivedb",
"#",
"POINT_IN_TIME",
"#",
"5/19/2011 8:43:41 AM")
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: No
- ArcGIS Desktop Standard: Sí
- ArcGIS Desktop Advanced: Sí