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, Oracle, PostgreSQL Server e SQLite, bem como ao uso de arquivos CSV, Microsoft Excel e TXT como bancos de dados.

Nota: 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 Não é possível usar o provedor Access ODBC ou OLEDB

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 Connect (Conectar) ação em Banco de dados pacote nesta paleta de Actions (Ações).
  2. Insira um nome para a sessão no campo Session name (Nome da sessão).
  3. Selecione a opção de conexão Default (Padrão) ou User defined (Definido pelo usuário).
    Ao selecionar o modo de conexão Definido pelo usuário e usar açãoLer de com codificação ANSI para guardar os dados recuperados em um arquivo CSV, os registros recuperados a partir da base de dados Oracle exibirão caracteres falsificados.

    Para saber mais sobre este assunto, consulte O hífen de largura total é ilegível ao exportar dados para csv pelo banco de dados: Ler da ação com codificação ANSI (login no A-People necessário)

    • Se você selecionar a opção Padrão é possível inserir diretamente a sequência de conexão para qualquer tipo de banco de dados suportado.

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

      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 usando o driver ODBC

      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 Strings de conexão por tipo de banco de dados.

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

      Para garantir uma automação mais segura, use um Credential Vault variável para a sequência 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 o banco de dados ações.
      • 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 Credential Vault. 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 Credential Vault. 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.
      Microsoft Access, SQLite Selecione o caminho do arquivo de banco de dados de:
      • Pasta Bots
      • dispositivo local
      • variável de arquivo existente
      Oracle
      • Nome do servidor (Opcional): Insira o nome do servidor Oracle ao qual deseja se conectar.
      • Opcional: Selecione uma opção para especificar a instância Oracle que você deseja usar:
        • System id (SID) (ID do sistema (SID)): Insira a ID do sistema.
        • Service name (Nome do serviço): Digite o nome do serviço.
        • TNS Name (Nome TNS): Digite o Nome TNS disponível no tnsname.ora arquivo de configuração.

          Especifique o caminho do arquivo de configuração tnsname.ora se você não tiver definido a propriedade do sistema com a variável ambiente.

        Nota: Você pode se conectar com o Banco de dados Oracle com o Nome do servidor ou Exemplo Oracle. Se você estiver se conectando usando o nome do servidor, você deve especificar a Identificação do sistema (SID) ou Nome do serviço no Exemplo Oracle para identificar o banco de dados Oracle e sua instância. No entanto, se você estiver se conectando usando o Nome TNS não é necessário inserir nenhum valor no campo Nome do servidor. Você só deve digitar o valor do nome do TNS e o caminho do arquivo.
      • Nome de usuário: Insira o nome de usuário que deseja usar para acessar o servidor Oracle. Para garantir um nome de usuário seguro, selecione uma variável Credential Vault. 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 Credential Vault. Caso contrário, insira um valor.
      • Porta: Insira o número da porta. O número padrão da porta é 1521.
      Nota: Se você estabelecer uma conexão usando um driver JDBC, para o Microsoft SQL Server, o pacote do Banco de dados 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.

  4. Selecione um arquivo de driver na pasta meus Bots , no dispositivo local ou em uma variável de arquivo.
  5. Clique em Salvar.

Próximas etapas

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

    Usando a ação Ler a partir de

  • 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