Oracle Database

Visão Geral

O componente Oracle realiza operações de leitura e escrita em tabelas de uma base de dados Oracle.

Configuração

Aqui estão os parâmetros gerais para a configuração do componente. Todos os parâmetros de campos de texto aceitam o uso de variáveis. Parâmetros que suportam expressões de template estão marcados com (Tmpl).

Informação adicional

O uso de variáveis em parâmetros de campos de texto é feito utilizando a expressão {{var.nome_da_variavel}}. Para saber mais sobre o uso de variáveis na criação de integrações, acesse a seção Canvas de integrações.

Alguns parâmetros suportam expressões de template para utilização de valores dinâmicos. Para saber mais sobre o funcionamento dessa linguagem e como utilizar expressões de template para referenciar dados para valores dinâmicos, acesse a seção Go Template de integrações.

Parâmetros

• ID do Componente: Obrigatório. Identificador do componente no fluxo de integração.

Informação adicional

Os IDs são únicos por fluxo. Não é possível ter mais de um componente com o mesmo ID.

O ID do Componente não pode conter espaços, deve iniciar com número e pode conter apenas letras sem acentos, números e o caractere _.

• Nome: Rótulo opcional para identificar o componente visualmente no canvas.
• Secret autenticação: Obrigatório. Secret do tipo "Autenticação" que será usada para conexão com Oracle. Deve ser cadastrada no Dhuo, na seção "Secrets"
• Nome do banco de dados: Obrigatório. Nome do bando de dados
• Endereço: Obrigatório. IP ou hostname do banco de dados
• Porta: Obrigatório. Porta do banco de dados
• Timeout de conexão: Obrigatório. Tempo limite para tentativa de conexão com banco de dados
• Timeout de leitura: Obrigatório. Tempo limite aguardando um comando sql com banco de dados
• Esquema: Obrigatório. Esquema do banco de dados
• Declaração SQL (Tmpl): Obrigatório. Pode ser utilizado para executar Select, Insert, Update, Delete e executar procedures com "Call".
• Parâmetros SQL: Caso a "Declaração SQl" contenha parâmetros indicados com "?", os valores que serão passados na query, em ordem, estão neste campo
• Resultado do SQL: Escolha "Sim" caso sua execução SQL tenha retorno, como em um Select
• Procedure: Escolha "Sim" caso sua execução SQL seja para executar uma procedure
• Mapeamento da procedure: Quando a "Declaração SQL" é um "Call" para procedure, aqui é onde mapeamos os campos IN/OUT/INOUT. Este campo aceita os parãmetros da seguinte forma:

[
  {
    "index": 1,
    "type": "VARCHAR",
    "mode": "IN"
  },
  {
    "index": 2,
    "type": "VARCHAR",
    "mode": "OUT"
  }
]

As opções para o campo "type" são: VARCHAR, NUMERIC, CLOB, DATE, REFCURSOR

Saída

Após a execução do componente, uma estrutura chave-valor será gerada com os dados de saída. Os dados podem ser acessados pelo contexto de execução em outros componentes em etapas posteriores do fluxo a partir da sintaxe .id_do_componenteOut.atributo_da_estrutura, onde:

• id_do_componente: valor configurado do parâmetro ID do Componente
• Out: sufixo padrão obrigatório
• atributo_da_estrutura: atributo retornado na estrutura chave-valor de saída da execução do componente

Atenção!

Caso ocorra algum erro durante a execução do componente, a estrutura chave-valor de saída não é gerada.

Aqui estão os atributos gerais da estrutura de saída do componente:

• affectedRows: Quantidade de registros afetados pela operação. Disponível quando a instrução SQL for INSERT, UPDATE ou DELETE.
• Quando a instrução SQL for um SELECT, caso existam registros correspondentes aos filtros, uma lista (array) será retornada diretamente na estrutura de saída com todos os registros correspondentes.
• Quando a instrução SQL for uma procedure, os campos cadastrados no "Mapeamento de procedure" com o campo "mode" "OUT" serão retornados diretamente na estrutura de saída.

Exemplo - query INSERT, UPDATE ou DELETE:

// ID do Componente: oracleStep
{
  "oracleStepOut": {
    "affectedRows": 1
  }
}

Exemplo - query SELECT:

// ID do Componente: oracleStep
{
  "oracleStepOut": [
    {
      "id": 1,
      "user": "John Doe",
      "email": "john.doe@dhuo.io"
    }
  ]
}

Exemplo - procedure:

// ID do Componente: oracleStep
// Parâmetros SQL: status
// Mapeamento da procedure: "index": 1, "type": "VARCHAR", "mode": "OUT"
{
  "oracleStepOut": {
    "status": "SUCCESS"
  }
}