Atividade Executar Consulta

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.

Incluir uma Atividade Executar Consulta na Orquestração

  1. Criar ou abrir uma orquestração. Uma representação gráfica da orquestração é exibida.
  2. Selecione a guia Atividades e expanda a pasta Banco de Dados.
  3. Arraste a atividade Executar Consulta para a orquestração.
  4. Selecione a atividade Executar Consulta

Criar, Selecionar ou Editar um Terminal de Banco de Dados

  1. Clique na tarefa Selecionar Terminal na Lista de Verificação e escolha a partir de uma das seguintes ações:
    • Selecione um terminal existente:
      1. Selecione Procurar. O Explorador de Projetos é aberto.
      2. 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:
      1. Selecione Procurar. O Explorador de Projetos é aberto.
      2. Selecione um terminal existente e clique em OK
      3. Clique em Editar. A área de janela Editar Terminal é aberta.
    • Crie um terminal: Selecione Novo. A área de janela Criar Terminal é aberta.
  2. Crie ou edite um terminal do banco de dados

Especificar a Instrução SQL Query

  1. Selecione a tarefa Inserir Consulta na Lista de Verificação. A área de janela Inserir Consulta é aberta.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.

Configurar os Parâmetros de Entrada para a Consulta

  1. Selecione a tarefa Configurar Parâmetros de Entrada na Lista de Verificação. A área de janela Configurar Parâmetros de Entrada mostra o(s) parâmetro(s) de entrada da consulta.
  2. 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.
  3. Clique no título da coluna para classificar as linhas pelo valor da coluna. Por exemplo, para classificar as linhas por seus nomes de coluna, clique no título Nome da Coluna da coluna. Uma seta é exibida à direita do nome do cabeçalho da coluna. Uma seta para cima indica que a coluna é classificada em ordem alfabética iniciando com a e continuando até z. Um seta para baixo indica que a coluna é classificada em ordem alfabética reversa iniciando com z e continuando até a. Clique na seta para a reverter a ordem alfabética.
  4. Se necessário, altere as configurações dos valores Tipo de Dado, Codificação, ou Anulável para cada parâmetro de entrada de consulta. Clique no campo para fazer uma nova seleção:
    • Nome do Parâmetro - É possível alterar o nome padrão para um nome mais significativo. Os parâmetros são listados na ordem em que eles são especificados na consulta.
    • Tipo de Dado - Selecione um tipo de dado para este parâmetro.
      Nota: (Para tipos de dados MONEY e XMLTYPE) Para o tipo de dado XMLTYPE em um banco de dados Oracle e os tipos de dados MONEY em um banco de dados SQL Server, o Studio não associa automaticamente o tipo de dado correto, portanto, você deve selecionar manualmente o tipo de dado apropriado.
    • Codificação - Selecione uma configuração de codificação de caracteres alternativa para o parâmetro se a codificação necessária diferir da codificação padrão para o banco de dados.
    • Size - Tamanho da coluna definida na tabela. Este tamanho é recuperado da tabela de banco de dados e não é configurável.
  5. Clique em Reconfigurar Valores para interrogar o banco de dados e obter os tipos de dados e o tamanho do banco de dados. Isto substitui o tipo de dado e o tamanho configurados manualmente na área de janela.

Configurar Parâmetros de Saída

  1. Selecione a tarefa Configurar Conjunto de Resultados na Lista de Verificação. A área de janela Configurar Conjunto de Resultados é aberta e os padrões para o(s) parâmetro(s) de saída da consulta são listados.
  2. 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.
  3. Se necessário, altere as configurações dos valores de Tipo de Dado, Codificação ou Anulável para cada parâmetro de saída de consulta:
    • Nome do Parâmetro - É possível alterar o nome padrão para um nome mais significativo. Os parâmetros são listados na ordem em que eles são especificados na consulta.
    • Tipo de Dado - Selecione um tipo de dado para este parâmetro.
    • Codificação - Selecione uma configuração de codificação de caracteres alternativa para o parâmetro se a configuração necessária diferir da codificação padrão para o banco de dados.
    • Size - Tamanho da coluna definida na tabela. Este tamanho é recuperado da tabela de banco de dados e não é configurável.
  4. Clique em Reconfigurar Valores para interrogar o banco de dados e obter os tipos de dados e o tamanho do banco de dados. Isto substitui o tipo de dado e o tamanho configurados manualmente na área de janela.

Especificar Opções de Nova Tentativa para a Consulta

Para especificar as opções de nova tentativa para a consulta:
  1. 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 Entrada da Atividade

  1. Selecione a tarefa Mapear Entradas na Lista de Verificação. Os parâmetros de entrada especificados para a consulta são os parâmetros de entrada para a atividade. Os parâmetros de entrada da atividade são exibidos sob o elemento parameters na área de janela Para Atividade.
  2. Você deve mapear todos os parâmetros de entrada da atividade. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.

Mapear a Saída da Atividade

  1. 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.
  2. Não é necessário mapear os parâmetros de saída da atividade. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.