Crear cadena de conexión de base de datos (Administración de datos)

Resumen

Crea una cadena de conexión que las herramientas de geoprocesamiento pueden utilizar para conectarse a una base de datos o a una geodatabase corporativa.

Uso

  • Utilice esta herramienta, en lugar de archivos de conexión, si tiene un flujo de trabajo de geoprocesamiento automático (script o modelo) que utiliza datasets de base de datos o de geodatabase corporativa. Puede generar una cadena de conexión que se puede utilizar como entrada en cualquier herramienta de geoprocesamiento que admita el tipo de dataset especificado, en lugar de utilizar una ruta a la base de datos mediante el espacio de trabajo del archivo de conexión.

  • Ya no se admiten las conexiones desde ArcGIS a Altibase ni Netezza.

Parámetros

EtiquetaExplicaciónTipo de datos
Plataforma de base de datos

Especifica la plataforma de base de datos a la cual se realizará la conexión.

  • SQL ServerConectarse a Microsoft SQL Server o Microsoft Azure SQL Database.
  • OracleConectarse a Oracle.
  • DB2Conectarse a IBM DB2 en Linux, UNIX o Windows.
  • PostgreSQLConectarse a PostgreSQL.
  • TeradataConectarse a Teradata Data Warehouse Appliance.
  • SAP HANAConectarse a SAP HANA.
  • DamengConectarse a Dameng.
String
Instancia

El servidor de base de datos o instancia al cual se realizará la conexión.

El valor de este parámetro depende del valor elegido para el parámetro Plataforma de base de datos.

String
Autenticación de base de datos
(Opcional)

Especifica el tipo de autenticación que se utilizará.

  • Autenticación de la base de datosSe utilizará la autenticación de base de datos. Se utilizan 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. Esta es la opción predeterminada.
    Nota:

    Si el archivo de conexión que está creando va a 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.

  • Autenticación del sistema operativoSe utilizará la autenticación de sistema operativo. No es necesario que escriba un nombre de usuario y contraseña. La conexión se realizará con el nombre de usuario y la contraseña que se utilizaron 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.
Boolean
Nombre de usuario
(Opcional)

El nombre de usuario de la base de datos que se utilizará para la autenticación de base de datos.

String
Contraseña
(Opcional)

La contraseña de la base de datos que se utilizará para la autenticación de base de datos.

Encrypted String
Base de datos
(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
Nombre de objeto de dataset
(Opcional)

El nombre del dataset u objeto de la base de datos al que apuntará la cadena de conexión. Esta cadena de conexión se puede utilizar como ruta al dataset especificado.

String
Tipo de datos
(Opcional)

El tipo de dataset u objeto al que se hace referencia en el nombre de objeto de dataset. Si hay varios objetos con el mismo nombre en la base de datos, puede que tenga que especificar el tipo de datos del objeto para el que desea crear una cadena de conexión.

String
Dataset de entidades de destino
(Opcional)

El nombre del dataset de entidades que contiene el dataset u objeto para el que desea crear una cadena de conexión. Si el dataset no se encuentra en un dataset de entidades (por ejemplo, si está en la raíz de la base de datos), no especifique ningún dataset de entidades de destino.

String
Esquema (solo geodatabases del esquema de usuario Oracle)
(Opcional)

La geodatabase de esquema del usuario a la que se conectará. La herramienta determinará si se está conectando a una base de datos de Oracle que contiene una geodatabase de esquema de usuario. Si la base de datos de Oracle contiene un esquema de usuario, esta opción estará activa; de lo contrario, seguirá inactiva. La opción predeterminada para este parámetro es utilizar la geodatabase de esquema de sde (maestra).

String
Tipo de versión
(Opcional)

Especifica el tipo de versión a la que se conectará. Este parámetro solo se aplica al conectarse a una geodatabase.

Nota:

Si se selecciona Histórica y no se proporciona un nombre, se utilizará la versión transaccional predeterminada. Si se selecciona Punto en el tiempo y no se proporciona una fecha en el parámetro Fecha y hora, se utilizará la versión transaccional predeterminada.

  • TransaccionalConectarse a una versión transaccional. Si se selecciona Transaccional, el parámetro Se utilizará la siguiente versión se rellenará con una lista de versiones transaccionales, y el parámetro Fecha y hora estará inactivo. Esta es la opción predeterminada.
  • HistóricoConectarse a un marcador histórico. Si se selecciona Histórico, el parámetro Se utilizará la siguiente versión se rellenará con una lista de marcadores históricos, y el parámetro Fecha y hora estará inactivo.
  • Punto en el tiempoConectarse a un punto específico en el tiempo. Si se selecciona Punto en el tiempo, el parámetro Se utilizará la siguiente versión estará inactivo, y el parámetro Fecha y hora se activará.
  • BifurcaciónConectarse a la versión en rama predeterminada.
String
Se utilizará la siguiente versión
(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
Fecha y hora
(Opcional)

El valor que representa la fecha y la hora que se utilizarán para conectarse a la base de datos. Este parámetro se usa con datos habilitados para el archivado. Utilice el Selector de hora para elegir la fecha adecuada.

Si introduce manualmente una fecha se pueden utilizar 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

Salida derivada

EtiquetaExplicaciónTipo de datos
Cadena de conexión CIMDATA

La cadena de conexión CIMDATA.

String

arcpy.management.CreateDatabaseConnectionString(database_platform, instance, {account_authentication}, {username}, {password}, {database}, {object_name}, {data_type}, {feature_dataset}, {schema}, {version_type}, {version}, {date})
NombreExplicaciónTipo de datos
database_platform

Especifica la plataforma de base de datos a la cual se realizará la conexión.

  • SQL_SERVERConectarse a Microsoft SQL Server o Microsoft Azure SQL Database.
  • ORACLEConectarse a Oracle.
  • DB2Conectarse a IBM DB2 en Linux, UNIX o Windows.
  • POSTGRESQLConectarse a PostgreSQL.
  • TERADATAConectarse a Teradata Data Warehouse Appliance.
  • SAP HANAConectarse a SAP HANA.
  • DAMENGConectarse a Dameng.
String
instance

El servidor de base de datos o instancia al cual se realizará la conexión.

El valor de este parámetro depende del valor elegido para el parámetro Plataforma de base de datos.

String
account_authentication
(Opcional)

Especifica el tipo de autenticación que se utilizará.

  • DATABASE_AUTHSe utilizará la autenticación de base de datos. Se utilizan 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. Esta es la opción predeterminada.
    Nota:

    Si el archivo de conexión que está creando va a 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_AUTHSe utilizará la autenticación de sistema operativo. No es necesario que escriba un nombre de usuario y contraseña. La conexión se realizará con el nombre de usuario y la contraseña que se utilizaron 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.
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
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
object_name
(Opcional)

El nombre del dataset u objeto de la base de datos al que apuntará la cadena de conexión. Esta cadena de conexión se puede utilizar como ruta al dataset especificado.

String
data_type
(Opcional)

El tipo de dataset u objeto al que se hace referencia en el nombre de objeto de dataset. Si hay varios objetos con el mismo nombre en la base de datos, puede que tenga que especificar el tipo de datos del objeto para el que desea crear una cadena de conexión.

String
feature_dataset
(Opcional)

El nombre del dataset de entidades que contiene el dataset u objeto para el que desea crear una cadena de conexión. Si el dataset no se encuentra en un dataset de entidades (por ejemplo, si está en la raíz de la base de datos), no especifique ningún dataset de entidades de destino.

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á. Este parámetro solo se aplica al conectarse a una geodatabase.

  • TRANSACTIONALConectarse a una versión transaccional. Si se selecciona Transaccional, el parámetro Se utilizará la siguiente versión se rellenará con una lista de versiones transaccionales, y el parámetro Fecha y hora estará inactivo. Esta es la opción predeterminada.
  • HISTORICALConectarse a un marcador histórico. Si se selecciona Histórico, el parámetro Se utilizará la siguiente versión se rellenará con una lista de marcadores históricos, y el parámetro Fecha y hora estará inactivo.
  • POINT_IN_TIMEConectarse a un punto específico en el tiempo. Si se selecciona Punto en el tiempo, el parámetro Se utilizará la siguiente versión estará inactivo, y el parámetro Fecha y hora se activará.
  • BRANCHConectarse a la versión en rama predeterminada.

Nota:

Si se selecciona Histórica y no se proporciona un nombre, se utilizará la versión transaccional predeterminada. Si se selecciona Punto en el tiempo y no se proporciona una fecha en el parámetro Fecha y hora, 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:

  • 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

Salida derivada

NombreExplicaciónTipo de datos
out_connection_string

La cadena de conexión CIMDATA.

String

Muestra de código

Ejemplo de CreateDatabaseConnectionString (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función CreateDatabaseConnectionString de modo inmediato.

import arcpy
data_conn_str = arcpy.CreateDatabaseConnectionString_management("SQL_SERVER",
                                          "utah",
                                          "DATABASE_AUTH",
                                          "gdb",
                                          "gdb", 
                                          "",
                                          "gdb.roads")
arcpy.Buffer_analysis(data_conn_str, r"c:\temp\Buffers.shp", "10 Miles")

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados