Uso de la acción Conectar para la base de datos

Use la acción Conectar para establecer una conexión con el servidor de base de datos que quiera usar para automatizar las tareas relacionadas con la base de datos. Esta acción es compatible con los servidores de bases de datos Microsoft Access, Microsoft SQL Server, MySQL, Oracle, Servidor PostgreSQL y SQLite, así como el uso de archivos CSV, Microsoft Excel y TXT como bases de datos.

Nota: Si su instalación de oficina actual es cualquiera de las siguientes:
  • Microsoft 365 Apps para Enterprise
  • Office 2016, 2019 o 2021 (Consumer Version 2009 o posterior)

En ese caso, no es necesario instalar Microsoft Access Database Engine como componente adicional en el sistema.

Sin embargo, si tiene tanto Microsoft 365 Apps como Microsoft Access Database Engine instalados en el sistema, puede desinstalar Microsoft Access Database Engine y reparar Microsoft 365 Apps.

Microsoft recomienda no instalar el controlador de Microsoft Access Database Engine por separado porque tanto Microsoft Access Database Engine 2016 como Microsoft 365 Apps utilizan el mismo identificador de versión principal (16.0). Para obtener más información sobre los requisitos de instalación del controlador del motor de Microsoft Access Database Engine, consulte Unable to use the Access ODBC or OLEDB provider

Especifique los detalles de un servidor de base de datos y asócielo a un nombre de sesión. Utilice el nombre de sesión proporcionado en esta acción en las demás acciones, para no tener que volver a proporcionar los detalles del servidor de base de datos en esas acciones.

Procedimiento

Para establecer una conexión con un servidor de base de datos, siga estos pasos:

  1. Haga doble clic o arrastre la acción Conectar del paquete de Base de datos en la paleta Acciones.
  2. Ingrese un nombre único para la sesión en el campo Nombre de sesión.
  3. Seleccione la opción de conexión Predeterminada o Definida por el usuario.
    Cuando seleccione el modo de conexión Definida por el usuario y utilice acción Leer de con codificación ANSI para guardar los datos recuperados en un archivo CSV, verá que los registros recuperados de la base de datos Oracle muestran caracteres confusos.

    Para saber más sobre este problema, consulte Fullwidth hyphen is garbled when exporting data to csv by Database: Read from action with encoding ANSI (A-people login required)

    • Si selecciona la opción Predeterminada, puede ingresar la cadena de conexión directamente para cualquiera de los tipos de base de datos admitidos.

      Si ha configurado la base de datos y el repositorio compartido en el sitio secundario, utilice la conexión JDBC para conectarse a la base de datos replicada. Por ejemplo, jdbc:sqlserver://AGL-ADDRESS:1433;databaseName=DB_NAME;user=username;password=password;applicationIntent=ReadOnly

      Puede establecer una conexión con la base de datos Snowflake utilizando los controladores ODBC. Para obtener más información sobre la descarga del controlador ODBC, consulte Snowflake using ODBC Driver

      Puede ingresar la cadena de conexión para conectarse a la base de datos. Por ejemplo, Driver={SnowflakeDSIIDriver};Server={account}.aws.snowflakecomputing.com;Database=DB_NAME;uid=username;pwd=password;

      Utilice esta opción para conectarse a un archivo Excel, CSV o TXT. Consulte Connection Strings by database type.

      Nota: Para acceder a cualquier base de datos a través de ODBC, primero debe instalar un controlador ODBC de 32 bits en su dispositivo.

      Para garantizar una automatización más segura, utilice una variable de Credential Vault para la cadena de conexión.

    • Seleccione la opción Utilizar el controlador ODBC de 64 bits para conectarse para conectarse a la base de datos.
      Nota:
      • Asegúrese de que el controlador ODBC de acceso de 64 bits está instalado en su sistema para acceder a cualquier base de datos y realizar operaciones utilizando acciones de bases de datos.
      • La siguiente acción no es compatible con los controladores OBDC de 32 o 64 bits porque las acciones enumeradas son para transacciones de base de datos que se llevan a cabo después de establecer una conexión con la base de datos:
        • Iniciar transacción de base de datos
        • Finalizar transacción de base de datos
        • Administrar procedimiento administrado
      • Utilizando Excel como base de datos, puede procesar más filas con los controladores de 64 bits que con los de 32 bits.
    • Si selecciona la opción Definida por el usuario, seleccione el tipo de base de datos entre las opciones disponibles y complete los siguientes campos en función de la selección:
      Tipo de base de datos Opciones
      Microsoft SQL Server, Servidor PostgreSQL
      • Nombre del servidor: Escriba el nombre del servidor de base de datos al cual quiera conectarse.
      • Nombre de la base de datos: Escriba el nombre de la base de datos.
      • Username (Nombre de usuario): Escriba el nombre de usuario que quiera utilizar para acceder al servidor de base de datos. Para garantizar un nombre de usuario seguro, seleccione una variable de Credential Vault. De lo contrario, escriba un valor.
      • Password (Contraseña): Escriba la contraseña correspondiente al nombre de usuario que proporcionó. Para garantizar una contraseña segura, seleccione una variable de Credential Vault. De lo contrario, escriba un valor.
      • Nombre de la instancia: Escriba un nombre para esta instancia de conexión.
      • Campo Tiempo de espera en segundos (opcional): Especifique la cantidad de tiempo entre 1 y 9999 que desea que el sistema espere antes de cancelar un bot.

        La automatización expirará y fallará si la conexión a la base de datos no se establece en el tiempo especificado. Si no introduce un valor en el campo Tiempo de espera en segundos (opcional), se utilizará el tiempo de espera por defecto especificado en la biblioteca de controladores.

        Nota: Microsoft SQL Server sólo admite esta opción.
      Conectarse a un Microsoft SQL Server con autenticación de Windows
      MySQL Introduzca las mismas opciones que en el tipo de base de datos Microsoft SQL Server. Además, escriba el número del puerto. El número de puerto predeterminado es 3306.
      Microsoft Access, SQLite Seleccione la ruta del archivo de la base de datos entre las siguientes opciones;
      • Carpeta de Bots
      • Dispositivo local
      • Variable de archivo existente
      Oracle
      • Nombre del servidor (opcional): Escriba el nombre del servidor de Oracle al cual quiera conectarse.
      • Opcional: Seleccione una opción para especificar la instancia de Oracle que desea utilizar:
        • ID del sistema (SID): Escriba el ID del sistema.
        • Nombre del servicio: Escriba el nombre del servicio.
        • Nombre del TNS: Ingrese el Nombre de TNS disponible en el archivo de configuración tnsname.ora.

          Especifique la ruta del archivo del archivo de configuración tnsname.ora si no ha establecido la propiedad del sistema con la variable de entorno.

        Nota: Puede conectarse a la Base de datos de Oracle con el Nombre del servidor o con la Instancia de Oracle. Si se conecta utilizando el nombre del servidor, debe especificar el ID del sistema (SID) o el Nombre del servicio en el campo Instancia de Oracle para identificar la base de datos de Oracle y su instancia. Sin embargo, si se conecta utilizando el nombre de TNS, no es necesario introducir ningún valor en el campo Nombre del servidor. Solo debe introducir el valor del nombre de TNS y la ruta del archivo.
      • Username (Nombre de usuario): Escriba el nombre de usuario que quiera utilizar para acceder al servidor de Oracle. Para garantizar un nombre de usuario seguro, seleccione una variable de Credential Vault. De lo contrario, escriba un valor.
      • Password (Contraseña): Escriba la contraseña correspondiente al nombre de usuario que proporcionó. Para garantizar una contraseña segura, seleccione una variable de Credential Vault. De lo contrario, escriba un valor.
      • Puerto: Escriba el número del puerto. El número de puerto predeterminado es 1521.
      Nota: Si establece una conexión con un controlador JDBC para Microsoft SQL Server, el paquete Base de datos ya incluye el controlador JDBC. Sin embargo, para otros servidores de bases de datos, debe proporcionar el archivo jar del controlador JDBC correspondiente tras descargarlo de los recursos adecuados.

      Si se establece una conexión mediante un controlador ODBC, no es necesario proporcionar un archivo jar.

  4. Seleccione un archivo de controlador de la carpeta de Bots, el dispositivo local o una variable de archivo.
  5. Haga clic en Guardar.

Qué hacer a continuación

Elija una de las siguientes opciones:
  • Utilice la acción Leer desde para recuperar registros de la base de datos.

    Uso de la acción Leer desde

  • Si está automatizando una tarea que implica realizar cambios en la base de datos, inserte la acción Iniciar transacción de base de datos.

    Esta acción asegura que todos los registros sean actualizados o eliminados en su totalidad y evita actualizaciones accidentales o la eliminación de datos incompletos si el bot encuentra un error mientras ejecuta una consulta.

    Base de datos paquete