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:
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:
- Uma linha é inserida no banco de dados. A coluna do sinalizador é
configurada como null para a linha.
- A atividade Pesquisar Tabela é executada pela
primeira vez e configura o valor do sinalizador como P
para esta linha.
- 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
- Criar ou
abrir uma orquestração. Uma representação gráfica da orquestração é
aberta.
- Selecione a guia Atividades e expanda a pasta
Banco de Dados.
- Arraste a atividade Pesquisar Tabela para a
orquestração.
- Selecione a atividade Pesquisar Tabela.
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 as Colunas da Tabela de Origem para Pesquisar Operações do Banco de Dados.
- 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 é mostrada.
- Crie um novo terminal:
- Selecione Novo. A área de janela
Criar Terminal é aberta.
- Crie ou edite um terminal de banco de dados.
Especificar as Colunas da Tabela de
Origem para Pesquisar Operações do Banco de Dados
- Clique em Selecionar Terminal na Lista de Verificação.
A área de janela Selecionar Terminal é aberta.
- Clique em Procurar. A caixa de diálogo
Selecionar uma Única Tabela de Origem é aberta.
- Selecione uma tabela que, durante o tempo de execução, a atividade
Pesquisar Tabela pesquisa em busca de operações do
banco de dados.
- Selecione um esquema de usuário na lista Filtrar por
Esquema do Usuário.
- 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.
- Selecione uma única tabela na lista:
- Clique em >> para incluir uma tabela.
- Clique em << para remover uma tabela.
- 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.
- 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).
- 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.
- 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.
- 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.
- 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
- Selecione Escolher Colunas na Lista
de Verificação.
- Selecione uma Coluna de Sequência na lista.
Esta é a coluna de sequência do tipo INTEGER contendo 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 poderia usar uma
coluna existente em sua tabela de banco de dados de origem.
- 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.
- 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.
- Configure as
Opções
de Nova Tentativa.
Mapear a Saída da Atividade
- 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.
- 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.