Atividade Sondar Tabela

A atividade Pesquisar Tabela verifica se uma operação do banco de dados (inserir ou atualizar) ocorreu em qualquer linha de uma tabela de banco de dados verificando o status de uma coluna do sinalizador especial no intervalo de tempo especificado.

Durante o tempo de execução, para as operações de inserção e de atualização, a atividade Pesquisar Tabela retorna os dados que foram alterados em sua tabela de banco de dados e mapeia diretamente esses dados para as variáveis na orquestração enquanto as atividades Obter Linhas Inseridas e Obter Linhas Atualizadas retornam os dados alterados para uma tabela de buffers e essa tabela de buffers é mapeada para uma variável na orquestração.
Nota: Use a atividade Pesquisar Tabela em vez das atividades Obter Linhas Inseridas, Obter Linhas Excluídas e Obter Linhas Atualizadas apenas quando precisar evitar a inclusão de acionadores em seu banco de dados.
Antes de configurar a atividade Pesquisar Tabela no Studio, você deve primeiro criar duas colunas de banco de dados adicionais em sua tabela de banco de dados de origem ou usar duas colunas de banco de dados existentes apropriadas a partir de sua tabela de banco de dados. As colunas de banco de dados a seguir são necessárias em sua tabela de banco de dados de origem:
  • Uma coluna de sequência do tipo INTEGER - Esta coluna contém as chaves primárias (uma sequência de números exclusivos: 1, 2, 3 ...)
  • Uma coluna de sinalizador do tipo CHAR(1) - Esta coluna contém um sinalizador que o Integration Appliance usa durante o tempo de execução para determinar se o Integration Appliance deve processar a linha.

Antes de uma orquestração com uma atividade Pesquisar Tabela ser executada no Integration Appliance, você também deve preencher estas colunas em sua tabela de banco de dados. Configure a coluna do sinalizador como P se não desejar que o Integration Appliance processe a linha durante o tempo de execução. Configure a coluna do sinalizador como null se desejar que o Integration Appliance processe a linha durante o tempo de execução.

Na tabela de banco de dados de exemplo a seguir, todos os valores na coluna Sinalizador são configurados inicialmente como P, conforme mostrado na figura a seguir:
Pesquisa Customizada
Atenção: Você deve gerenciar o estado da coluna do sinalizador. Após processar uma linha, o Integration Appliance altera a coluna do sinalizador para P para processada, conforme descrito no cenário de exemplo a seguir:
  1. Uma linha é inserida no banco de dados. A coluna do sinalizador é configurada como null para a linha.
  2. A atividade Pesquisar Tabela é executada pela primeira vez e configura o valor do sinalizador como P para esta linha.
  3. A mesma linha é atualizada e a atividade Pesquisar Tabela é executada novamente. A linha não é retornada nos dados de retorno da atividade porque o Integration Appliance verificou a coluna do sinalizador e o sinalizador indicou que esta linha já foi processada.

Para uma linha ser processada novamente pelo Integration Appliance, você deve reconfigurar a coluna do sinalizador de volta para null antes de uma tarefa de orquestração com uma atividade Pesquisar Tabela que acessa a mesma tabela de banco de dados de origem ser executada.

As etapas para incluir e configurar uma atividade Pesquisar Tabela para uma orquestração são descritas nos procedimentos a seguir:

Incluir uma Atividade Pesquisar Tabela na Orquestração

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

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 as Colunas da Tabela de Origem para Pesquisar Operações do Banco de Dados.
    • 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 é mostrada.
    • Crie um novo terminal:
      1. Selecione Novo. A área de janela Criar Terminal é aberta.
  2. Crie ou edite um terminal de banco de dados.

Especificar as Colunas da Tabela de Origem para Pesquisar Operações do Banco de Dados

  1. Clique em Selecionar Terminal na Lista de Verificação. A área de janela Selecionar Terminal é aberta.
  2. Clique em Procurar. A caixa de diálogo Selecionar uma Única Tabela de Origem é aberta.
  3. Selecione uma tabela que, durante o tempo de execução, a atividade Pesquisar Tabela pesquisa em busca de operações do banco de dados.
  4. Selecione um esquema de usuário na lista Filtrar por Esquema do Usuário.
  5. Selecione Ocultar Buffer e Tabelas de Controle para filtrar qualquer buffer ou tabelas de controle usadas pelo Integration Appliance.
    Nota: Este filtro oculta apenas buffers e tabelas de controle que usam os nomes padrão gerados em scripts a partir do Studio.
  6. Selecione uma única tabela na lista:
    • Clique em >> para incluir uma tabela.
    • Clique em << para remover uma tabela.
  7. Se você desejar apenas pesquisar operações do banco de dados nas colunas de chave primária da tabela de origem, selecione a caixa de seleção Selecionar Apenas as Chaves Primárias da Tabela.
  8. Clique em OK. As colunas da tabela são mostradas na área de janela Selecionar Tabela. (Se você selecionou a caixa de seleção Selecionar Apenas as Chaves Primárias das Tabelas, apenas as colunas de chave primária serão exibidas).
  9. Se a codificação de caracteres para esta tabela for diferente da codificação para o banco de dados, insira outra codificação 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.
  10. Selecione as colunas na tabela que, durante o tempo de execução, você deseja que a atividade Pesquisar Tabela pesquise em busca de operações do banco de dados (inserção, exclusão ou atualização). Por padrão, todas as colunas são selecionadas. Limpe a caixa de seleção Usar para colunas indesejadas. Clique em Usar Todos para selecionar novamente todas as colunas.
  11. 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 é mostrada à 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 alfatética.
  12. 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:
    • Tipo de Dado - Padronizado com o tipo de dado para a coluna na tabela de banco de dados de origem. Se o tipo de dado necessário para a coluna na tabela de buffers for diferente do tipo de dado da tabela de origem, selecione um tipo de dado diferente clicando na célula Tipo de Dado e selecionando outro Tipo de Dado na lista. Você deve selecionar um tipo de dado apropriado para esses tipos de dados que são marcados como NÃO SUPORTADOS.
      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 do SQL Server, o Studio não associa automaticamente o tipo de dado correto, portanto, você deve selecionar manualmente o tipo de dado apropriado.
    • Size - Tamanho da coluna definida na tabela. Este tamanho é recuperado a partir da tabela de banco de dados e não é configurável
    • Encoding - É padronizado com a codificação padrão atual que foi configurada no nível do banco de dados ou no nível da tabela. Se a codificação necessária para a coluna for diferente da codificação padrão atual, selecione outra codificação clicando na célula Codificação e selecionando outra Codificação na lista.
    • Anulável - Padronizado com a configuração anulável para a coluna na tabela de banco de dados de origem. Se nullable = false, a coluna deverá ser incluída na mensagem. A caixa de seleção Usar deve ser selecionada para as colunas onde nullable=false. Uma coluna marcada como nullable=false não pode conter um nulo durante o tempo de execução.

Selecionar as Colunas Sequência e Sinalizador

  1. Selecione Escolher Colunas na Lista de Verificação.
  2. Selecione uma Coluna de Sequência na lista. Esta é a coluna de sequência do tipo INTEGER que contém as chaves primárias (uma sequência de números exclusivos: 1, 2, 3 ...) que você incluiu em sua tabela de banco de dados de origem ou determinou que poderá usar uma coluna existente em sua tabela de banco de dados de origem.
  3. Selecione uma Coluna de Sinalizador na lista. Uma coluna de sinalizador do tipo CHAR contendo um sinalizador que o Integration Appliance configura como P quando o Integration Appliance processa a linha. O Integration Appliance usa as colunas de sequência e de sinalizador para verificar mensagens duplicadas. Além disso, ambas as colunas e a configuração da caixa de seleção Excluir linhas após elas terem sido processadas na área de janela Regras de Entrega são usadas pelo Integration Appliance para determinar a ação para uma solicitação de exclusão:
    •  Se a caixa de seleção Excluir linhas após elas terem sido processadas for selecionada, o Integration Appliance configurará o sinalizador como M e, em seguida, excluirá a linha.
    • Se a caixa de seleção Excluir linhas após elas terem sido processadas for limpa, o Integration Appliance configurará o sinalizador como M e, em seguida, P, mas a linha não será excluída. Para uma linha ser processada novamente pelo Integration Appliance, você deve reconfigurar a coluna do sinalizador de volta para null antes de uma tarefa de orquestração com uma atividade Pesquisar Tabela que acessa a mesma tabela de banco de dados de origem ser executada.
  4. Configure as Regras de Entrega.
    Nota: Se você selecionar a opção Exatamente uma vez na tarefa Regras de Entrega, deverá criar tabelas de controle que serão usadas pelo Integration Appliance durante o tempo de execução. Crie as tabelas de controle após publicar a orquestração do Studio para o Integration Appliance. Crie as tabelas de controle usando o Web Management Console (WMC) antes de implementar o projeto.
    Nota: Se selecionar a opção Exatamente Uma Vez, você deverá ativar a persistência. Para obter informações adicionais, consulte Ativando a Persistência.
  5. Configure as Opções de Nova Tentativa.

Mapear a Saída da Atividade

  1. Selecione a tarefa Mapear Saídas na Lista de Verificação. Os parâmetros de saída para a atividade são exibidos no elemento row na área de janela Da Atividade. Os parâmetros de saída exibidos na área de janela Da Atividade correspondem às colunas selecionadas na tarefa Selecionar Tabela. Se a opção Lote foi selecionada em Regras de Entrega, o símbolo de diversas ocorrências será exibido próximo ao elemento row.
    Nota: Durante o tempo de execução, o parâmetro de saída rows da atividade Pesquisar Tabela não será preenchido com os valores das colunas de sequência e de sinalizador. Apenas as colunas selecionadas na tarefa Selecionar Tabela serão retornadas.
  2. Mapeie os parâmetros de saída necessários para as variáveis. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento. Não é necessário mapear os parâmetros de saída para estas atividades.



Feedback | notices