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

Use la acción Conectarpara 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, Servidor PostgreSQL y SQLite, así como el uso de archivos CSV, Microsoft Excel y TXT como bases de datos.

Importante: 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
Nota: El controlador de SQL Server no depende de la instalación de Microsoft Office. Solo la versión del controlador de Excel depende de la versión de Microsoft Office. Sin embargo, si desea utilizar un controlador diferente, como el bloc de notas o CSV, entonces debe instalar el controlador de conectividad de la base de datos (ODBC) compatible correspondiente.

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. Seleccione la opción de conexión Predeterminada o Definida por el usuario.
    Cuando selecciona el modo de conexión Definida por el usuario y usa la acción Leer desde 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 distorsionados.

    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 directamente la cadena de conexión para cualquier base de datos que soporte las cadenas de conexión JDBC y un controlador de 64 bits. Para ver la lista de bases de datos compatibles, consulte Matriz de soporte de servidores de base de datos.
      Nota: Cuando selecciona la opción Predeterminada para conectarse a Excel y usar caracteres que no están en inglés en un archivo de Excel, debe usar la codificación UTF-8 para admitir los caracteres Unicode.

      Si ha configurado la base de datos y el repositorio compartido en un sitiosecundario, 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.

      Parámetro: Puede utilizar los valores de las credenciales del casillero de credenciales sin exponer las credenciales (nombre de usuario o contraseña) en texto sin formato en la string de conexión. Para ello, primero debe asignar la credencial en el asignador de credenciales y utilizar el nombre del parámetro en la string de conexión entre corchetes.

      Por ejemplo, si el nombre del parámetro es db_username y el valor del parámetro se elige del valor de credencial, la string de conexión con 3 parámetros será “Provider=SQLOLEDB.1;Initial Catalog=master;Password={{db_credentials}};Persist Security Info=True;User ID={{db_username}};Data Source={{db_datasource}}”

      Para utilizar la contraseña del casillero de credenciales, realice los siguientes pasos:
      1. Haga clic en Agregar parámetro.
      2. Introduzca el Nombre del parámetro.
      3. En el Valor del parámetro, seleccione Credencial para usar un valor disponible en la bóveda de credenciales, seleccione Variable para usar una variable de credencial o String insegura para especificar manualmente el valor que desea usar.
      4. Haga clic en Agregar.

      Para garantizar una automatización más segura, utilice una variable de Credential Vault para la string 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.
      • 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.
      • 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.
      Nota: Recomendamos no utilizar la versión 8.0.40 del controlador My SQL porque si ejecuta procedimientos almacenados parametrizados con esta versión, podría sufrir algunos problemas. Comuníquese con su administrador de éxito del cliente (CSM) de Automation Anywhere para obtener ayuda.
      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
      Nota: Si establece una conexión con un controlador JDBC para Microsoft SQL Server, el Base de datos paquete 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.

  3. Seleccione un archivo de controlador de la carpeta de Bots, el dispositivo local o una variable de archivo.
  4. Seleccione cualquiera de las siguientes pestañas para crear una sesión de base de datos:
    • Sesión local: Especifique un nombre de sesión que solo pueda ser utilizado en el bot actual.
    • Sesión global: Especifique un nombre de sesión que se pueda utilizar en múltiples bots, como bots principales y bots secundarios.
      Recommendation: Los bots principales y secundarios deben tener la misma versión de paquete.
    • Variable: Especifique o cree una variable de sesión del subtipo sesión de base de datos.
  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