ArcGIS for Desktop

  • Documentación
  • Precios
  • Soporte

  • My Profile
  • Ayuda
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

La plataforma de representación cartográfica para tu organización

ArcGIS for Desktop

Un completo SIG profesional

ArcGIS for Server

SIG en tu empresa

ArcGIS for Developers

Herramientas para crear aplicaciones basadas en la ubicación

ArcGIS Solutions

Plantillas de aplicaciones y mapas gratuitas para tu sector

ArcGIS Marketplace

Obtén aplicaciones y datos para tu organización.

  • Documentación
  • Precios
  • Soporte
Esri
  • Iniciar sesión
user
  • Mi perfil
  • Cerrar sesión

Ayuda

  • Inicio
  • Introducción
  • Mapa
  • Analizar
  • Administrar datos
  • Herramientas
  • Más...

Crear conexión de la base de datos

  • Resumen
  • Uso
  • Sintaxis
  • Ejemplo de código
  • Entornos
  • Información sobre licencias

Resumen

Crea un archivo de conexión que se puede utilizar para conectarse a una base de datos o a una geodatabase corporativa, de grupo de trabajo o de escritorio.

Uso

  • Cuando se utiliza el cuadro de diálogo de la herramienta, si se introduce la información de conexión válida, la herramienta se conectará a la base de datos para determinar si la base de datos contiene el esquema de la geodatabase. Si se encuentra el esquema, el servidor rellenará 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 TRANSACTIONAL y el parámetro de nombre de la versión con el nombre de la versión predeterminada.

  • Si desea evitar que la información de conexión se guarde en la ventana Resultados o almacene 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 es 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ámetroExplicaciónTipo 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:

  • SQL_SERVER —Para conectarse a Microsoft SQL Server
  • ORACLE —Para conectarse a Oracle
  • DB2 —Para conectarse a IBM DB2 en Linux, UNIX o Windows
  • DB2ZOS —Para conectarse a IBM DB2 en z/OS
  • INFORMIX —Para conectarse a IBM Informix
  • NETEZZA —Para conectarse a IBM Netezza
  • POSTGRESQL —Para conectarse a PostgreSQL
  • TERADATA —Para conectarse a Teradata
  • SAP_HANA —Para conectarse a SAP HANA
  • ALTIBASE —Para conectarse a ALTIBASE
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.

  • ALTIBASE: el nombre de la fuente de datos ODBC para la base de datos ALTIBASE
  • DB2: el nombre de la base de datos DB2 catalogada
  • DB2 para Z/OS: el nombre de la base de datos DB2 catalogada
  • Informix: el nombre de la fuente de datos de la Conectividad abierta de base de datos (ODBC) para la base de datos Informix
  • Oracle: el nombre TNS o cadena de caracteres de Oracle Easy Connection para conectarse a la base de datos de Oracle
  • Netezza: el nombre de la fuente de datos ODBC para la base de datos Netezza
  • PostgreSQL: el nombre del servidor donde se ha instalado PostgreSQL
  • SAP HANA: el nombre de fuente de datos de ODBC para la base de datos de SAP HANA
  • SQL Server: el nombre de la instancia de SQL Server
  • Teradata: el nombre de la fuente de datos ODBC para la base de datos Teradata
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 a la base de datos. 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.
    Nota:

    Si el archivo de conexión que está creando proporcionará servicios de ArcGIS con acceso a la base de datos o la geodatabase, o si desea usar la búsqueda de catálogo para localizar los datos a los que se accede a través de este archivo de conexión, deberá escribir el nombre de usuario y la contraseña.

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

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)
  • SAVE_USERNAME —Guarda el nombre de usuario y la contraseña en el archivo de conexión. Esta es la opción predeterminada. Si el archivo de conexión que está creando proporcionará servicios de ArcGIS con acceso a la base de datos o la geodatabase, o si desea usar la búsqueda de catálogo para localizar los datos a los que se accede a través de este archivo de conexión, deberá escribir el nombre de usuario y la contraseña.
  • 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
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.

  • TRANSACTIONAL —Se utiliza para conectarse a una versión transaccional.
  • HISTORICAL —Se utiliza para conectarse a un marcador histórico.
  • POINT_IN_TIME —Se utiliza para conectarse a un punto específico en el tiempo. Si se utiliza POINT_IN_TIME, el parámetro Nombre de la versión se ignora.

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 fecha, 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:

  • 6/9/2011 4:20:15 PM
  • 6/9/2011 16:20:15
  • 6/9/2011
  • 4:20:15 PM
  • 16:20:15

Nota:

  • Si se introduce una hora sin una fecha, se utiliza la fecha predeterminada 30 de diciembre de 1899.
  • Si se introduce una fecha sin una hora, se utiliza la hora predeterminada 12:00:00 AM.

Date

Ejemplo 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

  • Espacio de trabajo actual

Información sobre licencias

  • ArcGIS for Desktop Basic: No
  • ArcGIS for Desktop Standard: Sí
  • ArcGIS for Desktop Advanced: Sí
¿Algún comentario sobre este tema?

ArcGIS for Desktop

  • Inicio
  • Documentación
  • Precios
  • Soporte

Plataforma ArcGIS

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

Acerca de Esri

  • Quiénes somos
  • Empleo
  • Blog interno
  • Conferencia de usuarios
  • Cumbre de desarrolladores
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacidad | Legal