Documentação do Oracle Cloud Infrastructure

Como Trabalhar com Tarefas SQL

Uma tarefa SQL permite executar um objeto SQL em um pipeline do serviço Data Integration.

Atualmente, os únicos objetos SQL que você pode executar são procedimentos armazenados. O procedimento armazenado deve existir em uma origem de dados associada a um ativo de dados de banco de dados no espaço de trabalho. Para obter uma lista de bancos de dados suportados, consulte Origens de Dados Suportadas para Tarefas SQL.

As variáveis definidas no procedimento armazenado são expostas como parâmetros IN (entrada), OUT (saída) e IN-OUT (entrada-saída) na tarefa SQL. Para obter uma lista dos tipos de dados SQL suportados que podem ser usados como parâmetros de tarefa SQL, consulte Tipos de Dados SQL Suportados.

Observação

Se você estiver usando o parâmetro de consulta fields em um procedimento armazenado, consulte Melhorando o Desempenho.

Ao criar uma tarefa SQL, você só pode configurar valores para parâmetros de entrada. Você pode substituir os valores padrão quando configurar a tarefa SQL em um pipeline e quando executar o pipeline que inclui a tarefa SQL. No pipeline, as tarefas e operações que são downstream da tarefa SQL podem usar as saídas da tarefa SQL que é upstream.

As páginas a seguir descrevem como você pode criar, editar e excluir tarefas SQL no Data Integration:

As páginas a seguir descrevem outras tarefas de gerenciamento que podem ser executadas:

Origens de Dados Suportadas para Tarefas SQL

Você pode executar procedimentos armazenados SQL que são salvos em determinados bancos de dados.

Atualmente, os procedimentos armazenados nos seguintes bancos de dados são suportados:

  • Oracle Database (exceto 11g)
  • Oracle Autonomous AI Lakehouse
  • Oracle Autonomous AI Transaction Processing

Para obter as versões suportadas, consulte Origens de dados suportadas e suas versões.

Tipos de Dados SQL Suportados

As variáveis definidas em procedimentos armazenados SQL são expostas como parâmetros nas tarefas SQL que você cria ou executa.

Os seguintes tipos de dados SQL são suportados para parâmetros de entrada e saída quando você usa procedimentos armazenados em tarefas SQL:

SQL JDBC/Java
VARCHAR java.lang.String
CHAR java.lang.String
LONGVARCHAR java.lang.String
BIT booliano
NUMERIC java.math.BigDecimal
TINYINT byte
SMALLINT short
INTEGER int
BIGINT long
REAL float
FLOAT float
DOUBLE double
VARBINARY byte[ ]
BINARY byte[ ]
DATE java.sql.Date
TIME java.sql.Time
TIMESTAMP java.sql.Timestamp

Os seguintes tipos de dados SQL ainda não são suportados:

SQL JDBC/Java
ARRAY java.sql.Array
REF java.sql.Ref
STRUCT java.sql.Struct
CLOB java.sql.Clob
BLOB java.sql.Blob

Melhorando o Desempenho

Especifique o valor metadata no parâmetro de consulta fields para recuperar informações mínimas. Isso usa menos recursos do sistema, levando a tempos de recuperação mais rápidos.

Por exemplo, ao usar a função LIST_PUBLISHED_OBJECTS, especifique o valor metadata no parâmetro de consulta fields para recuperar uma lista de todos os objetos publicados de um aplicativo especificado.