Database package

Os bancos de dados dão suporte às operações internas de uma empresa por armazenarem uma variedade de dados, tais como transações de vendas, catálogos de produtos, inventários e perfis de clientes. Use o pacote Database package para conectar-se a um banco de dados, iniciar uma transação, manipular dados armazenados por meio da recuperação, inserção, atualização, exclusão e exportação de dados para um arquivo CSV.

Antes de começar

Execute as seguintes actions dentro do Database package como parte do uso do conjunto de actions disponíveis:
Nota: Ao usar actions, tais como Ler em, Executar procedimento armazenado ou Exportar para tabela de dados para recuperar registros de uma tabela do Microsoft SQL Server que tem uma coluna de tipo de bit ou uma coluna de Excel (com valores TRUE ou FALSE), os dados recuperados serão mencionados como 0 e 1, e não como TRUE e FALSE.
  1. Estabeleça uma conexão com o servidor de banco de dados por meio de Conectar action.
    Consulte Como usar a action Conectar para banco de dados.
    Nota: Ao criar automações na plataforma macOS, você pode estabelecer uma conexão usando a string de conexão JDBC. No entanto, não é possível usar uma string de conexão ODBC para se conectar ao banco de dados.
  2. Escolha entre as seguintes opções:
    • Use a Read from (Ler de) de action para recuperar registros do banco de dados. Consulte Usando a action Ler de.
    • Se estiver automatizando uma tarefa que envolve fazer alterações no banco de dados, insira aaction Iniciar transação do banco de dados, seguido pelas actions que automatizam as mudanças.

      Esta action 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.

  3. Se você usou a action Iniciar transação do banco de dados nesta sessão, insira Terminar transação do banco de dados para confirmar as mudanças.
  4. Cada conjunto de actions de banco de dados termina com a action Desconectar para encerrar a conexão com o servidor de banco de dados.
Nota: As seguintes funcionalidades não são suportadas quando você cria uma tarefa da API usando o package Database:
  • Ao estabelecer uma conexão com bancos de dados específicos, como MySQL e Oracle, você precisa fornecer um arquivo de driver JDBC da Control Room, dispositivo local ou variável de arquivo. A entrada do tipo de arquivo não é compatível com a Tarefa de API. Portanto, você não conseguirá se conectar aos bancos de dados MySQL e Oracle. No entanto, você pode se conectar ao PostgreSQL, ao MS SQL, ao MS Access e ao SQLite, pois o Database package já inclui o arquivo jar do driver JDBC.
  • Não é possível estabelecer uma conexão usando o driver ODBC.
  • Grave dados em um arquivo CSV usando a action Ler de, pois a action arquivo não é compatível com tarefas da API.

Tipos de dados do banco de dados

Os tipos de dados representam o tipo de valor que pode ser armazenado na tabela do banco de dados. A tabela a seguir fornece informações sobre os tipos de dados amplamente usados no Automation 360. Observe que esta não é uma lista abrangente.
Tipo de dados Valor
Tipos de dados compatíveis Char, Varchar, Nvarchar, Number, Datetime, INT, Float, and Bit
Tipos de dados incompatíveis
  • Tipos de dados binários: Binário, BLOB, CLOB, BFILE e RAW
  • Tipos de dados de ponteiro: Cursor e ponteiros de registro

Actions no Database package

O Database package inclui as seguintes actions:

Action Descrição
Iniciar transação do banco de dados Consulte action Iniciar transação do banco de dados.
Terminar transação do banco de dados Consulte action Terminar transação do banco de dados.
Conectar Consulte Como usar a action Conectar para banco de dados.

O banco de dados Snowflake utilizando o driver ODBC é compatível.
Desconectar Consulte Desconectar action.
Ler de Consulte Usando a action Ler de.

O banco de dados Snowflake utilizando o driver ODBC é compatível.
Executar procedimento armazenado Consulte Como usar a action Executar procedimento armazenado.
Exportar para tabela de dados Consulte Como usar a action Exportar para tabela de dados.

O banco de dados Snowflake utilizando o driver ODBC é compatível.
Gerenciar procedimento armazenado Consulte action Gerenciar procedimento armazenado.
Inserir/Atualizar/Excluir Consulte action Inserir/Atualizar/Excluir.

Mais recursos