Durante o tempo de execução, a atividade Executar
Consulta executa uma instrução SQL select.
A atividade Executar Consulta suporta
consultas parametrizadas - uma consulta que contém parâmetros de entrada
ou parâmetros de entrada e saída. Quando parâmetros de entrada são
especificados em uma consulta, o valor do parâmetro é fornecido no tempo
de execução. O caractere ? na instrução select de exemplo
a seguir especifica que há um parâmetro de entrada:
select *
from myUserSchema.mySourceTable where
myUserSchema.mySourceTable.myColumn=?
Na
instrução select precedente, o caractere
*, especifica
que a consulta retorna a(s) coluna(s) localizada(s) na tabela
mySourceTable como o(s) parâmetro(s) de saída. Por
exemplo, se a
tabela mySource contiver duas colunas,
uma do tipo CHAR e uma do tipo VARCHAR, a atividade
Executar
Consulta retornará dois parâmetros de saída, um do tipo CHAR e
o outro do tipo VARCHAR.
Nota: Apenas a instrução SQL select é suportada na
atividade Executar Consulta.
A instrução SQL insert não é suportada na atividade Executar
Consulta.
As etapas para incluir e configurar uma
atividade
Executar Consulta em uma orquestração são
descritas nos procedimentos a seguir:
Incluir uma Atividade Executar
Consulta na Orquestração
- Criar ou
abrir uma orquestração. Uma representação gráfica da orquestração
é exibida.
- Selecione a guia Atividades e expanda a pasta
Banco de Dados.
- Arraste a atividade Executar Consulta para a
orquestração.
- Selecione a atividade Executar Consulta
Criar, Selecionar ou Editar
um Terminal de Banco de Dados
- Clique na tarefa Selecionar Terminal na Lista de Verificação e
escolha a partir de uma das seguintes ações:
- Selecione um terminal existente:
- Selecione Procurar. O Explorador de
Projetos é aberto.
- Selecione um terminal existente e clique em OK.
Vá para o procedimento Especificar a Instrução SQL Query.
- Selecione um terminal existente e edite o terminal:
- Selecione Procurar. O Explorador de
Projetos é aberto.
- Selecione um terminal existente e clique em OK
- Clique em Editar. A área de janela
Editar Terminal é aberta.
- Crie um terminal: Selecione Novo. A área de janela
Criar Terminal é aberta.
- Crie ou edite um terminal do banco de dados
Especificar a Instrução SQL Query
- Selecione a tarefa Inserir Consulta na Lista de
Verificação.
A área de janela Inserir Consulta é aberta.
- Insira a consulta no espaço em branco exibido na área de janela. Não
coloque ponto e vírgula no final de sua consulta.
- Clique em
Visualizar
Colunas para revisar detalhes da coluna para uma tabela selecionada
para ajudá-lo na construção de sua instrução SQL inserindo nomes e colunas
da tabela válidos.
- Selecione uma configuração de
codificação de caracteres
alternativa para os parâmetros de entrada e de saída se a codificação
desejada diferir da codificação padrão para o banco de dados usando uma
das opções a seguir:
- Na lista Codificação, selecione um dos tipos de
codificação padrão.
- Insira seu tipo de codificação diretamente clicando no campo
Codificação e digitando seu tipo de codificação.
Nota: Alguns caracteres de byte duplo não são convertidos com o
uso da codificação SHIFT-JIS. Para obter informações adicionais, consulte
Usando a Codificação Shift-JIS.
- Clique em Validar Consulta. Esta ação verifica
se sua consulta é válida e preenche parâmetros de entrada e de saída nas
tarefas Mapear Entradas e Mapear
Saídas.
- Insira um valor no campo MaxRows. O campo
MaxRows especifica o número máximo de linhas para
retornar da consulta durante o tempo de execução.
Nota: Se a
mesma consulta for iniciada diversas vezes nos mesmos dados, o mesmo
conjunto de linhas será retornado. Por exemplo se
MaxRows for igual a 1, a mesma linha (a primeira
linha) será sempre retornada toda vez que a consulta for iniciada - não há
iteração através do conjunto de linhas.
Especificar Opções de Nova
Tentativa para a Consulta
Para especificar as opções de nova
tentativa para a consulta:
- Configure as
Opções
de Nova Tentativa.
Nota: Para a atividade Executar Consulta do
Banco de Dados, se você configurar a opção de nova tentativa como
zero, o Integration Appliance tentará novamente a conexão de maneira
indefinida.
Mapear a Saída da Atividade
- Selecione a tarefa Mapear Saídas na Lista de Verificação.
As colunas retornadas pela instrução select são os elementos exibidos sob
o elemento rows/row na área de janela Da Atividade.
- Não é necessário mapear os parâmetros de saída da atividade.
Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.