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.
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
Não é possível usar o provedor Access ODBC ou OLEDBNota: O driver do SQL Server não depende da instalação do MS Office. Somente a versão do driver do Excel depende da versão do MS Office.
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:
-
Clique duas vezes ou arraste a Connect (Conectar) ação em Banco de dados pacote nesta paleta de Actions (Ações).
-
Selecione a opção de conexão Default (Padrão) ou User defined (Definido pelo usuário).
- 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.
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 de 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 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, a string 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:
- Clique em Adicionar parâmetro.
- Insira o Nome do parâmetro.
- 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.
- Clique em Adicionar.
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:
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.
-
Selecione um arquivo de driver na pasta meus Bots , no dispositivo local ou em uma variável de arquivo.
-
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.
- Variável: Especifique ou crie uma variável de sessão do subtipo Sessão de banco de dados.
-
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