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

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 ni Netezza.

Parámetros

EtiquetaExplicaciónTipo de datos
Ubicación del archivo de conexión

La ruta de la carpeta donde se guardará el archivo de conexión de la base de datos (.sde).

Folder
Nombre del archivo de conexión

El nombre del archivo de conexión de base de datos. El archivo de salida tendrá la extensión .sde.

String
Plataforma de base de datos

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:

  • DamengConectarse a Dameng.
  • Db2Conectarse a IBM Db2 en Linux, UNIX o Windows.
  • OracleConectarse a Oracle, Amazon Relational Database Service (RDS) for Oracle o Autonomous Transaction Processing database in Oracle Cloud.
  • PostgreSQLConectarse a PostgreSQL, Amazon Aurora PostgreSQL, Amazon Relational Database Service (RDS) for PostgreSQL o Microsoft Azure Database for PostgreSQL.
  • TeradataConectarse a Teradata Data Warehouse Appliance.
  • SAP HANAConectarse a SAP HANA o SAP HANA Cloud.
  • SQL ServerConectarse a Microsoft SQL Server, Microsoft Azure SQL Database, Microsoft Azure SQL Managed Instance o Amazon Relational Database Service (RDS) for SQL Server.
String
Instancia

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

El valor que elija en la lista desplegable de la Plataforma de base de datos indica el tipo de base de datos al que se desea conectar. La información que proporciona para el parámetro Instancia varía en función del tipo de conexión que elija.

Consulte a continuación para obtener más información sobre qué información se debe proporcionar para cada plataforma de base de datos.

  • Dameng: el nombre del servidor donde se instala la base de datos de Dameng
  • Db2: el nombre de la base de datos de Db2 catalogada
  • Oracle: el nombre TNS o cadena de caracteres de Oracle Easy Connection para conectarse a la base de datos o el servicio de base de datos de Oracle
  • PostgreSQL: el nombre del servidor donde se ha instalado PostgreSQL o el nombre de la instancia de servicio de base de datos de PostgreSQL
  • SAP HANA: el nombre de la fuente de datos de la Conectividad abierta de base de datos (ODBC) para la base de datos o el servicio de base de datos de SAP HANA
  • SQL Server: el nombre de la instancia de base de datos de SQL Server o el nombre de la instancia de servicio de la base de datos.
  • Teradata: el nombre de fuente de datos de ODBC para la base de datos Teradata.
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 utilizarán 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 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
Guardar nombre de usuario y contraseña
(Opcional)

Especifica si se guardarán el nombre de usuario y la contraseña.

  • Activado: el nombre de usuario y la contraseña se guardarán 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 geodatabase, deberá guardar el nombre de usuario y la contraseña.
  • Desactivado: ni el nombre de usuario ni la contraseña se guardarán en el archivo de conexión. Cada vez que intente conectarse usando el archivo, se le pedirán un nombre de usuario y una contraseña.
Boolean
Base de datos
(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
Esquema (solo geodatabases del esquema de usuario Oracle)
(Opcional)

La geodatabase del esquema de usuario a la que se realizará la conexión. 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.

String
Tipo de versión
(Opcional)

Especifica el tipo de versión al cual se realizará la conexión. 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 realizará la conexión. 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. Esta opción se utiliza 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
Espacio de trabajo de salida

El archivo de conexión de base de datos de salida (archivo .sde).

workspace

arcpy.management.CreateDatabaseConnection(out_folder_path, out_name, database_platform, instance, {account_authentication}, {username}, {password}, {save_user_pass}, {database}, {schema}, {version_type}, {version}, {date})
NombreExplicació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

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:

  • DAMENGConectarse a Dameng.
  • DB2Conectarse a IBM Db2 en Linux, UNIX o Windows.
  • ORACLEConectarse a Oracle, Amazon Relational Database Service (RDS) for Oracle o Autonomous Transaction Processing database in Oracle Cloud.
  • POSTGRESQLConectarse a PostgreSQL, Amazon Aurora PostgreSQL, Amazon Relational Database Service (RDS) for PostgreSQL o Microsoft Azure Database for PostgreSQL.
  • SAP HANAConectarse a SAP HANA o SAP HANA Cloud.
  • SQL_SERVERConectarse a Microsoft SQL Server, Microsoft Azure SQL Database, Microsoft Azure SQL Managed Instance o Amazon Relational Database Service (RDS) for SQL Server.
  • TERADATAConectarse a Teradata Data Warehouse Appliance.
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.

  • Dameng: el nombre del servidor donde se instala la base de datos de Dameng
  • Db2: el nombre de la base de datos de Db2 catalogada
  • Oracle: el nombre TNS o cadena de caracteres de Oracle Easy Connection para conectarse a la base de datos o el servicio de base de datos de Oracle
  • PostgreSQL: el nombre del servidor donde se ha instalado PostgreSQL o el nombre de la instancia de servicio de base de datos de PostgreSQL
  • SAP HANA: el nombre de la fuente de datos de la Conectividad abierta de base de datos (ODBC) para la base de datos o el servicio de base de datos de SAP HANA
  • SQL Server: el nombre de la instancia de base de datos de SQL Server o el nombre de la instancia de servicio de la base de datos.
  • Teradata: el nombre de fuente de datos de ODBC para la base de datos Teradata.
String
account_authentication
(Opcional)

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

  • DATABASE_AUTHSe utilizará la autenticación de base de datos. Se utilizarán 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 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
save_user_pass
(Opcional)

Especifica si se guardarán el nombre de usuario y la contraseña.

  • SAVE_USERNAMEEl nombre de usuario y la contraseña se guardarán 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, deberá guardar un nombre de usuario y la contraseña.
  • DO_NOT_SAVE_USERNAMEEl nombre de usuario y la contraseña no se guardarán en el archivo de conexión. Cada vez que intente conectarse usando el archivo, se le pedirán un nombre de usuario y una 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.

  • TRANSACTIONALConectarse a una versión transaccional tradicional.
    Nota:

    Esta opción no se aplica a geodatabases de SAP HANA.

  • HISTORICALConectarse a un marcador histórico.
  • POINT_IN_TIMEConectarse a un punto específico en el tiempo. Si se utiliza POINT_IN_TIME, se ignorará el parámetro de version.
  • BRANCHConectarse a la versión en rama predeterminada.

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 realizará la conexión. 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_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)

La siguiente secuencia de comandos 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")

Información de licenciamiento

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

Temas relacionados