Como usar a ação Conectar para banco de dados

Use a Connect (Conectar) ação para estabelecer uma conexão com um servidor de banco de dados que você deseja usar para automatizar tarefas relacionadas ao banco de dados. Essa ação é compatível com servidores de banco de dados Microsoft Access, Microsoft SQL Server, MySQL, PostgreSQL Server e SQLite, bem como ao uso de arquivos CSV, Microsoft Excel e TXT como bancos de dados.

Importante: Se a instalação atual do Office for qualquer uma das seguintes:
  • Microsoft 365 Apps para Empresas
  • Office 2016, 2019 ou 2021 (versão para o consumidor 2009 ou posterior)

Então, não é necessário instalar o Microsoft Access Database Engine como um componente adicional no sistema.

No entanto, o Microsoft 365 Apps e o Microsoft Access Database Engine estiverem instalados no sistema, desinstale o Microsoft Access Database Engine e repare o Microsoft 365 Apps.

A Microsoft recomenda que não é necessário instalar o driver Microsoft Access Database Engine separadamente porque o Microsoft Access Database Engine 2016 e o Microsoft 365 Apps utilizam o mesmo identificador de versão principal (16.0). Para saber mais sobre os requisitos de instalação do Microsoft Access Database Engine, consulte Unable to use the Access ODBC or OLEDB provider
Nota: O driver do SQL Server não depende da instalação do Microsoft Office. Somente a versão do driver do Excel depende da versão do Microsoft Office. No entanto, se você quiser usar um driver diferente, como o Notepad ou CSV, então você precisará instalar o driver ODBC compatível correspondente.

Especifique os detalhes de um servidor de banco de dados e associe-o com um nome de sessão. Use o nome da sessão fornecido nessa ação em outras ações para que você não tenha que fornecer os detalhes do servidor nessas ações.

Procedimento

Para estabelecer uma conexão com um servidor de banco de dados, execute as etapas abaixo:

  1. Clique duas vezes ou arraste a ação Conectar no pacote Banco de dados na paleta Ações.
  2. Selecione a opção de conexão Default (Padrão) ou User defined (Definido pelo usuário).
    Quando você seleciona o modo de conexão Definido pelo usuário e usa a ação Ler de com a codificação ANSI para gravar os dados recuperados em um arquivo CSV, você verá que os registros recuperados do banco de dados Oracle exibem caracteres corrompidos.

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

    • Se você selecionar a opção Padrão, poderá inserir diretamente a string de conexão para qualquer banco de dados que suporte strings de conexão JDBC e um driver de 64 bits. Para ver a lista de bancos de dados compatíveis, consulte Matriz de suporte do servidor de banco de dados.
      Nota: Ao selecionar a opção Padrão para conectar-se a um Excel e usar caracteres diferentes do inglês em um arquivo do Excel, você precisa usar a codificação UTF-8 para oferecer suporte aos caracteres Unicode.

      Se você configurou seu banco de dados e repositório compartilhado no site secundário,use a conexão JDBC para se conectar ao banco de dados de réplica. Por exemplo, jdbc:sqlserver://AGL-ADDRESS:1433;databaseName=DB_NAME;user=username;password=password;applicationIntent=Read-only

      Você pode estabelecer uma conexão com o banco de dados Snowflake usando drivers ODBC. Para mais informações sobre o download do driver ODBC, veja Snowflake using ODBC Driver

      Você pode entrar na string de conexão para se conectar ao banco de dados. Por exemplo, Driver={SnowflakeDSIIDriver};Server={account}.aws.snowflakecomputing.com;Database=DB_NAME;uid=username;pwd=password;

      Use esta opção para se conectar a um arquivo Excel, CSV ou TXT. Consulte Connection Strings by database type.

      Nota: Para acessar qualquer banco de dados por meio do ODBC, você deve primeiro instalar um driver ODBC de 32 bits em seu dispositivo.

      Parâmetro: Você pode usar os valores das credenciais do cofre de credenciais sem expor as credenciais (nome de usuário ou senha) em texto sem formatação na string de conexão. Para isso, é necessário primeiro mapear a credencial no mapeador de credenciais e usar o nome do parâmetro na string de conexão entre chaves.

      Por exemplo, se o nome do parâmetro for db_username e o valor do parâmetro for escolhido a partir do valor da credencial, o conjunto de dados de conexão com 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 usar a senha do cofre de credenciais, execute os seguintes passos:
      1. Clique em Adicionar parâmetro.
      2. Insira o Nome do parâmetro.
      3. No Valor do parâmetro, selecione Credencial para usar um valor disponível no cofre de credenciais ou selecione Variável para usar uma variável de credencial ou, String insegura para especificar manualmente o valor que deseja usar.
      4. Clique em Adicionar.

      Para garantir uma automação mais segura, use uma variável Cofre de credenciais para o conjunto de dados de conexão.

      Selecione a opção Usar driver ODBC de 64 bits para conexão para se conectar ao banco de dados.
      Nota:
      • O driver ODBC de acesso de 64 bits deve estar instalado no sistema para acessar qualquer banco de dados e executar operações usando ações de banco de dados.
      • A ação a seguir não é compatível com drivers OBDC de 32 ou 64 bits porque as ações listadas são para transações de banco de dados executadas após a conexão com o banco de dados:
        • Iniciar transação do banco de dados
        • Terminar transação do banco de dados
        • Gerenciar procedimento armazenado
      • Usando o Excel como banco de dados, você pode processar mais linhas com drivers de 64 bits em comparação com os de 32 bits.
    • Se você selecionar a opção Definido pelo usuário selecione o tipo de banco de dados das opções disponíveis e preencha os seguintes campos com base na seleção:
      Tipo de banco de dados Opções
      Microsoft SQL Server, PostgreSQL Server
      • Server name (Nome do servidor): Insira o nome do servidor do banco de dados ao qual deseja se conectar.
      • Database name (Nome do banco de dados): Insira o nome para o banco de dados.
      • Nome de usuário: Insira o nome de usuário que deseja usar para acessar o servidor do banco de dados. Para garantir um nome de usuário seguro, selecione uma variável Cofre de credenciais. Caso contrário, insira um valor.
      • Senha: insira a senha para o nome de usuário que você forneceu. Para garantir uma senha segura, selecione uma variável Cofre de credenciais. Caso contrário, insira um valor.
      • Instance name (Nome da instância): Insira um nome para esta instância de conexão.
      • Campo Tempo limite em segundos (opcional): Especifique a quantidade de tempo entre 1 e 9999 que você deseja que o sistema aguarde antes de cancelar um bot.

        A automação atingirá o tempo limite e falhará se a conexão com o banco de dados não for estabelecida no tempo especificado. Se você não inserir um valor no campo Tempo limite em segundos (opcional), será usado o tempo limite padrão especificado na biblioteca do driver.

        Nota: Microsoft SQL Server é compatível apenas com esta opção.
      Conectar-se a um Microsoft SQL Server com autenticação do Windows
      MySQL Insira as mesmas opções que a do tipo de banco de dados Microsoft SQL Server. Insira também o número da porta. O número padrão da porta é 3306.
      Nota: Recomendamos não usar o driver MySQL versão 8.0.40 porque, se você executar procedimentos armazenados parametrizados usando essa versão, poderá enfrentar alguns problemas. Contate seu Gerente de Sucesso do Cliente (CSM) da Automation Anywhere para assistência.
      Microsoft Access, SQLite Selecione o caminho do arquivo de banco de dados de:
      • Pasta Bots
      • dispositivo local
      • variável de arquivo existente
      Nota: Se você estabelecer uma conexão usando um driver JDBC, para o Microsoft SQL Server, o Banco de dados do pacote já inclui o driver do JDBC. Entretanto, para outros servidores de banco de dados, você deve fornecer o arquivo de driver JDBC correspondente após baixá-lo dos recursos apropriados.

      Se você estabelecer uma conexão usando um driver ODBC, você não precisa fornecer um arquivo jar.

  3. Selecione um arquivo de driver na pasta meus Bots , no dispositivo local ou em uma variável de arquivo.
  4. Selecione qualquer uma das guias a seguir para criar uma sessão de banco de dados:
    • Sessão local: Especifique um nome de sessão que possa ser usado apenas no bot atual.
    • Sessão global: Especifique um nome de sessão que possa ser usado em múltiplos bots, como bots principais e bots secundários.
      Recommendation: Os bots principal e secundário devem ter a mesma versão do pacote.
    • Variável: Especifique ou crie uma variável de sessão do subtipo Sessão de banco de dados.
  5. Clique em Salvar.

Próximas etapas

Escolha entre as seguintes opções:
  • Use a ação Ler de para recuperar registros do banco de dados.

    Using the Read from ação

  • Se você estiver automatizando uma tarefa que envolve fazer alterações no banco de dados, insira a Begin database transaction (Iniciar transação de banco de dados) ação .

    Esta ação garante que todos os registros sejam atualizados ou excluídos em sua totalidade e impede atualizações acidentais ou exclusões de dados incompletos se o bot encontrar um erro ao executar uma consulta.

    Banco de dados pacote