Esta seção contém os procedimentos para configurar as
atividades do banco de dados de saída de tabela única a seguir.
Estas atividades incluem:
- Inserir Linhas - Esta atividade obtém dados da variável ou das
variáveis que são mapeadas para os parâmetros de entrada da atividade e
insere estes dados como linhas na tabela de banco de dados especificada.
- Atualizar Linhas - Esta atividade obtém dados da variável ou da
variáveis que são mapeadas para os parâmetros de entrada da atividade e
atualiza as linhas da tabela de banco de dados especificada com estes
novos dados.
- Excluir Linhas - Esta atividade obtém dados da variável ou das
variáveis que são mapeadas para os parâmetros de entrada da atividade e
exclui linhas da tabela de banco de dados especificada com base nestes
dados.
Para as atividades
Atualizar Linhas e
Excluir
Linhas, o Integration Appliance integra a tabela de banco de dados
para determinar quais colunas na tabela são colunas de chave primária. Quando as atividades
Atualizar Linhas ou
Excluir Linhas são
iniciadas durante o tempo de execução, o Integration Appliance usa o valor
da variável recebida que contém o número da chave primária para determinar
quais linhas atualizar ou excluir.
Por exemplo, a coluna
PK é definida no
banco de dados como sendo uma coluna de chave primária para a tabela de
banco de dados.
A caixa de seleção
Usar é selecionada para a coluna
PK na tarefa
Selecionar Tabela da
Lista de Verificação para a atividade
Excluir Linhas. Na
área de janela Mapear Entradas da atividade
Excluir Linhas, a
variável chamada
myIncomingPK é mapeada para o
elemento
PK da linha conforme mostrado em
Figura 1:
Figura 1. myIncomingPK é Mapeado para o Elemento
PK da Linha
Durante o tempo de execução, se o valor da variável
myIncomingPK for igual a 3, a linha com o
PK igual a 3 será excluída da tabela,
conforme mostrado em
Figura 2:
Figura 2. A Linha com a Chave Primária Igual a 3 é Excluída
Se nenhuma coluna de chave primária for
especificada na tarefa
Selecionar Tabela da
Lista de
Verificação, especifique pelo menos uma coluna para agir como a chave
primária. Especifique a coluna ou colunas de chave primária que estão
agindo usando a caixa de diálogo Configurar Chaves Primárias, disponível
clicando em
Chaves na tarefa
Selecionar
Tabela da
Lista de Verificação para as atividades
Excluir
Linhas e
Atualizar Linhas. Se nenhuma chave primária for
especificada na tabela de banco de dados ou selecionada como chaves
primárias atuantes na caixa de diálogo Configurar Chaves Primárias, todas
as linhas da tabela de banco de dados serão afetadas pela operação de
exclusão ou de atualização.
Também é possível usar a caixa de diálogo Configurar Chaves Primárias
para especificar colunas adicionais para agirem como colunas de chave
primária. Por exemplo, para a tabela na figura precedente, é possível
definir que a coluna Nome deve agir como a
coluna de chave primária, além da coluna primária de
PK que foi definida no banco de dados como
sendo uma coluna de chave primária.
Incluir uma Única Atividade do Banco de Dados de Saída de Tabela Única na Orquestração
- Crie ou
abra 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 do banco de dados de saída de tabela única desejada
(Inserir Linhas, Excluir Linhas ou Atualizar Linhas)
para a orquestração.
- Selecione a atividade.
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 é
exibido.
- Selecione um terminal existente e clique em OK.
Vá para o procedimento "Configurar a Atividade".
- Selecione um terminal existente e edite o terminal:
- Selecione Procurar. O Explorador de Projetos é
exibido.
- Selecione um terminal existente e clique em OK.
- Clique em Editar. A área de janela Editar Terminal é exibida.
- Crie um terminal: Selecione Novo. A área de janela Criar Terminal é exibida.
- Crie ou edite um terminal HTTP, consulte
Criando ou Editando um Terminal HTTP.
Selecione as colunas na tabela de banco de dados de origem
em que, durante o tempo de execução, o Integration Appliance pesquisa
mudanças
- Clique em Selecionar Tabela na Lista de
Verificação.
A área de janela Selecionar Tabela é exibida.
- Clique em Procurar... para selecionar a tabela
de banco de dados que deve ser a origem para mensagens de entrada. A caixa
de diálogo Procurar Tabelas de Banco de Dados é exibida.
- Selecione uma tabela na lista e clique em OK.
As informações da coluna para a tabela selecionada são exibidas na área de
janela Selecionar Tabela.
- 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.
Isto configura a codificação para todas as colunas da tabela de buffers
resultante. 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.
- Por padrão, todas as colunas na tabela de origem são selecionadas. Limpe a caixa de seleção Usar para remover uma
coluna da tabela de buffers resultante. 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 é 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. Uma
seta para baixo indica que a coluna é classificada em ordem alfabética
reversa iniciando com z e continuando até a. Clique na seta
para reverter a ordem alfabética.
- Apenas para a atividade Obter Linhas Atualizadas - se desejar
que a tabela de buffers resultante contenha os novos valores e os valores
originais das colunas atualizadas, siga estas etapas:
- Clique em Valores Antigos. A caixa de diálogo
Colunas de Valores Antigos para Atualizações é exibida.
- Selecione a caixa de seleção Armazenar para as
colunas de banco de dados em que deseja salvar os valores originais.
- É possível alterar os nomes padrão designados para colunas para
armazenar os valores originais. Dê um clique duplo na célula
Nome da Coluna para Armazenar Valor Antigo
apropriada.
- Clique em OK. As colunas selecionadas são
exibidas em Da Atividade da área de janela Mapear
Saídas prefixadas com a sequência: old_. É
possível mapear os valores novo e original a partir da área de janela
Mapear Saídas.
- Se necessário, altere as configurações dos valores Tipo de
Dado, Codificação ou
Anulável. 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 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.
Atenção: Você deve selecionar um tipo de dado compatível com o tipo de dado de
origem para evitar dados inválidos durante o tempo de execução. Por
exemplo, não selecione o tipo de dado SMALLINT para a tabela de buffers se
o tipo de dado de origem for INTEGER porque, durante o tempo de execução,
um número grande armazenado em uma coluna INTEGER não será convertido
corretamente no tipo de dado SMALLINT.
- Size - Tamanho da coluna definida na tabela. Este tamanho é recuperado 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. A caixa de
seleção Usar deve ser selecionada para as colunas
em que nullable=false.
Uma coluna marcada como nullable=false não
pode conter um nulo durante o tempo de execução.
- Clique em Reconfigurar para reconfigurar todas
as propriedades da coluna com seus padrões. Isto também reconfigura a
caixa de seleção Usar para todas as colunas.
- Clique em Atualizar para atualizar a lista de
colunas em referência ao estado mais recente do banco de dados de origem. As mudanças recentes na origem são atualizadas nesta área de janela.
- Configure o
Especificando Regras de Entrega para Atividades do Banco de Dados.
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. Para obter informações adicionais, consulte Opções de Nova Tentativa para Atividades do Banco de Dados de Entrada.
Especifique a Tabela do Banco de Dados de Destino para a
Atividade
- Clique em Selecionar Tabela na Lista de
Verificação.
A área de janela Selecionar Tabela é exibida.
- Clique em Procurar... para selecionar a tabela
do banco de dados de destino. A caixa
de diálogo Procurar Tabelas de Banco de Dados é exibida.
- Selecione uma tabela na lista e clique em OK.
As informações da coluna para a tabela selecionada são exibidas na área de
janela Selecionar Tabela.
- 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.
Isto configura a codificação para todas as colunas da tabela de buffers
resultante. 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.
- Por padrão, todas as colunas na tabela de origem são selecionadas. Limpe a caixa de seleção Usar para remover uma
coluna da tabela de buffers resultante. Se uma coluna não for selecionada,
ela não será exibida na área de janela Mapear Entradas e não será
atualizada no tempo de execução. 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 é 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. Uma
seta para baixo indica que a coluna é classificada em ordem alfabética
reversa iniciando com z e continuando até a. Clique na seta
para reverter a ordem alfabética.
- Se necessário, altere as configurações dos valores Tipo de
Dado, Codificação ou
Anulável. 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
desejado 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 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.
Atenção: Você deve selecionar um tipo de dado compatível com o tipo de dado de
origem para evitar dados inválidos durante o tempo de execução. Por
exemplo, não selecione o tipo de dado SMALLINT para a tabela de buffers se
o tipo de dado de origem for INTEGER porque, durante o tempo de execução,
um número grande armazenado em uma coluna INTEGER não é convertido
corretamente no tipo de dado SMALLINT.
- Size - Tamanho da coluna definida na tabela. Este tamanho é recuperado 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 desejada 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. A caixa de
seleção Usar deve ser selecionada para as colunas
em que nullable=false.
Uma coluna marcada como nullable=false não
pode conter um nulo durante o tempo de execução.
- Clique em Reconfigurar para reconfigurar todas
as propriedades da coluna com seus padrões. Isto também reconfigura a
caixa de seleção Usar para todas as colunas.
- Clique em Atualizar para atualizar a lista de
colunas em referência ao estado mais recente do banco de dados de origem. As mudanças recentes na origem são atualizadas nesta área de janela.
- Apenas para a atividade Atualizar Linhas - Selecione a caixa de
seleção Inserir linha se a linha ainda não existir
se, durante o tempo de execução, você desejar que a atividade Atualizar
Linhas tente atualizar primeiro a linha especificada mas, se a linha
não existir, insira a linha na tabela de banco de dados.
- Apenas para a atividade Atualizar Linhas - se você desejar
salvar ambos os valores, novo e original, no banco de dados, siga estas
etapas:
- Clique em Valores Antigos. A caixa de diálogo
Colunas de Valor Antigo para Atualizações é exibida.
- Selecione a caixa de seleção Armazenar para as
colunas de banco de dados em que deseja salvar os valores originais.
- É possível alterar os nomes padrão designados às colunas que armazenam
os valores originais durante o tempo de execução. Dê um clique duplo na
célula Nome da Coluna para Armazenar Valor Antigo
apropriada.
- Clique em OK. As colunas selecionadas são
exibidas em Para Atividade da área de janela Mapear Saídas, prefixadas com
a sequência: old_.
É possível mapear para ambos os valores, novo e original, a partir da área
de janela Mapear Saídas.
- Apenas para as atividades Atualizar Linhas ou Excluir
Linhas - Para especificar as colunas de chave primária atuantes, além
de quaisquer colunas de chave primária já definidas pelo banco de dados,
siga estas etapas:
- Clique em Chaves. A caixa de diálogo Configurar
Chaves Primárias é exibida.
- Para especificar uma coluna como uma coluna de chave primária atuante,
clique na coluna, em seguida, clique em >>.
- Clique em OK.
Nota: Se nenhuma coluna
de chave primária (conforme definido pelo banco de dados) foi especificada
na tabela Selecionar Tabela da Lista de Verificação, você
deverá especificar pelo menos uma coluna como uma coluna de chave primária
atuante.
Repita esta etapa para especificar mais colunas de chave
primária atuantes.
- Configure o
Especificando Regras de Entrega para Atividades do Banco de Dados.
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. Para obter informações adicionais, consulte Opções de Nova Tentativa para Atividades do Banco de Dados de Saída.
Mapear a Entrada da Atividade
- Selecione a tarefa Mapear Entradas na Lista de Verificação.
Os parâmetros de entrada para a atividade são exibidos no elemento
row na área de janela Para Atividade. Os parâmetros
de entrada exibidos na área de janela Da Atividade correspondem às colunas
selecionadas na tarefa
Selecionar Tabela. Se a caixa de seleção
Colocar Diversas Linhas em Lote Por Mensagem foi
selecionada nas
Regras de Entrega, o símbolo de diversas
ocorrências será exibido próximo ao elemento row.
Nota: Apenas para a
atividade Obter Linhas Atualizadas, se colunas foram selecionadas
na caixa de diálogo Colunas de Valores Antigos para Atualizações (na
tarefa Selecionar Tabela), estes parâmetros de saída adicionais
(prefixados por padrão com a sequência: old_)
também serão exibidos sob o elemento rows.
- Mapeie todos os parâmetros de entrada. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento. Você deve mapear todos os parâmetros de entrada da atividade.
Mapear a Saída da Atividade
- Selecione a tarefa Mapear Saídas na Lista de Verificação.
A caixa de seleção
GetRowsCount determina o que é
exibido na área de janela Mapear Saídas:
- Se a caixa de seleção Obter Contagens de Linha
for desmarcada nas Regras de Entrega, a área de janela Mapear
Saídas ficará em branco.
- Se a caixa de seleção Obter Contagens de Linha
for selecionada nas Regras de Entrega, a área de janela Mapear
Saídas exibirá o elemento rowCount.
Se a caixa de seleção Colocar Diversas Linhas em Lote Por
Mensagem for selecionada nas Regras de Entrega, o
símbolo de diversas ocorrências será exibido próximo ao elemento
rowCount.
- Se o parâmetro de saída RowCount for exibido,
mapeie o parâmetro de saída RowCount, se desejado.
Consulte Criando um Mapa para obter instruções gerais sobre mapeamento. Não é necessário mapear os parâmetros de saída da atividade.