Sumário

Search

  1. Prefácio
  2. Trabalhando com Transformações
  3. Transformação Agregador
  4. Transformação Personalizada
  5. Funções de Transformação Personalizada
  6. Transformação Mascaramento de Dados
  7. Exemplos de Mascaramento de Dados
  8. Transformação Expressão
  9. Transformação Procedimento Externo
  10. Transformação Filtros
  11. Transformação HTTP
  12. Transformação de Resolução de Identidade
  13. Transformação Java
  14. Referência da API da transformação Java
  15. Expressões Java
  16. Exemplo de Transformação Java
  17. Transformação Joiner
  18. Transformação Pesquisa
  19. Caches de Pesquisa
  20. Cache de Pesquisa Dinâmica
  21. Transformação Normalizador
  22. Transformação Classificação
  23. Transformação Roteador
  24. Transformação de Gerador de Sequência
  25. Transformação Classificador
  26. Transformação de Qualificador de Origem
  27. Transformação SQL
  28. Usando a Transformação SQL em um Mapeamento
  29. Transformação Procedimento Armazenado
  30. Transformação Controle de Transações
  31. Transformação União
  32. Transformação Dados Não Estruturados
  33. Transformação Estratégia de Atualização
  34. Transformações XML

Guia de Transformações

Guia de Transformações

Propriedades de pesquisa

Propriedades de pesquisa

Configure as propriedades de pesquisa, como cache e múltiplas correspondências, na guia Propriedades da Pesquisa. Configure a condição de pesquisa ou as instruções de SQL para consultar a tabela de pesquisa. Você também pode alterar o nome da tabela Pesquisa.
Quando você cria um mapeamento, configura as propriedades para cada transformação Pesquisa. Ao criar uma sessão, você pode substituir propriedades, como o tamanho do índice e do cache de dados em cada transformação.
A tabela a seguir descreve as propriedades da transformação Pesquisa:
Opção
Tipo de Pesquisa
Descrição
Substituição SQL de Pesquisa
Relacional
Substitui a instrução SQL padrão para consultar a tabela de pesquisa.
Especifica a instrução SQL que você deseja que o Serviço de Integração utilize para consultar os valores da pesquisa. Use com o cache de pesquisa ativado.
Nome da Tabela de Pesquisa
Pipeline
Relacional
O nome da tabela ou do qualificador de origem a partir do qual a transformação efetua a pesquisa e o cache dos valores. Quando você criar a transformação Pesquisa, escolha uma origem, destino ou qualificador de origem como a origem da pesquisa. Você também pode importar uma tabela, exibição ou sinônimo de outro banco de dados quando criar a transformação Pesquisa.
Se você inserir uma Substituição SQL de Pesquisa, não precisa inserir o Nome da Tabela de Pesquisa.
Filtro da Origem de Pesquisa
Relacional
Restringe as pesquisas que o Serviço de Integração executa com base no valor dos dados em qualquer porta na transformação Pesquisa. Use com o cache de pesquisa ativado.
Armazenamento em Cache Ativado
Arquivo Simples
Pipeline
Relacional
Indica se o Serviço de Integração efetua o cache dos valores da pesquisa durante a sessão.
Quando você ativa o cache de pesquisa, o Serviço de Integração consulta a origem da pesquisa uma vez, efetua o cache dos valores e procura os valores no cache durante a sessão. Efetuar o cache dos valores de pesquisa pode melhorar o desempenho da sessão.
Quando você desabilita o cache, sempre que uma linha é transferida para a transformação, o Serviço de Integração emite uma instrução de seleção para a origem da pesquisa, para os valores de pesquisa.
O Serviço de Integração sempre efetua o cache das pesquisas de arquivos simples e de pipeline.
Diretiva de pesquisa em várias correspondências
Arquivo Simples
Pipeline
Relacional
Determina quais linhas retornar quando a transformação Pesquisa encontra múltiplas linhas que correspondem à condição de pesquisa. Selecione um dos seguintes valores:
  • Usar Primeiro Valor. Retorna a primeira linha que corresponde à condição de pesquisa.
  • Usar Último Valor. Retorne a última linha que corresponde à condição de pesquisa.
  • Usar Todos os Valores. Retorne todas as linhas correspondentes.
  • Use Qualquer Valor. O Serviço de Integração retorna o primeiro valor que corresponde à condição de pesquisa. Ela cria um índice baseado nas portas-chave ao invés de todas as portas da transformação de Pesquisa.
  • Relatar Erro. O Serviço de Integração relata um erro e não retorna uma linha. Se você não ativar a opção Valor Antigo da Saída na Atualização, a opção Política de Pesquisa na Correspondência Múltipla é configurada como Relatar Erro para as consultas dinâmicas.
Condição de Pesquisa
Arquivo Simples
Pipeline
Relacional
Exibe a condição de pesquisa que você configurou na guia Condição.
Informações de Conexão
Relacional
Especifica o banco de dados que contém a tabela de pesquisa. Você pode definir o banco de dados no arquivo de parâmetro, mapeamento ou sessão:
  • Mapeamento. Selecione o objeto de conexão. Você também pode especificar o tipo de conexão do banco de dados. Digite
    Relational:
    antes do nome da conexão, caso seja uma conexão relacional. Digite
    Application:
    antes do nome da conexão, caso seja uma conexão de aplicativo.
  • Sessão Use as variáveis de conexão $Source ou $Target. Se você usar uma destas variáveis, a tabela de pesquisa deve residir no banco de dados de origem ou de destino. Especifique a conexão do banco de dados para cada variável nas propriedades da sessão.
  • Arquivo de parâmetros. Use o parâmetro de sessão $DBConnection
    Name
    ou $AppConnection
    Name
    , e o defina no arquivo de parâmetros.
Por padrão, o Designer especifica $Source se você escolher uma tabela de origem e $Target se escolher uma tabela de destino quando criar a transformação Pesquisa. Você pode substituir esses valores nas propriedades da sessão.
O Serviço de Integração provoca a falha da sessão se não puder determinar o tipo de conexão do banco de dados.
Tipo de Origem
Arquivo Simples
Pipeline
Relacional
Indica que a transformação Pesquisa lê valores de uma tabela relacional, arquivo simples ou qualificador de origem.
Nível de Rastreamento
Arquivo Simples
Pipeline
Relacional
Configura a quantidade de detalhes incluídos no log da sessão.
Nome do Diretório do Cache de Pesquisa
Arquivo Simples
Pipeline
Relacional
Especifica o diretório usado para criar os arquivos de cache de pesquisa quando você configura a transformação Pesquisa para efetuar o cache de origem de pesquisa. Também salva os arquivos persistentes do cache de pesquisa quando você seleciona a opção Pesquisa Persistente.
Por padrão, o Serviço de Integração usa o diretório $PMCacheDir configurado para o Serviço de Integração.
Cache de Pesquisa Persistente
Arquivo Simples
Pipeline
Relacional
Indica se o Serviço de Integração usa um cache de pesquisa persistente, que consiste em pelo menos dois arquivos de cache. Se uma transformação Pesquisa for configurada para um cache de pesquisa persistente, e os arquivos desse tipo de cache não existirem, o Serviço de Integração cria os arquivos durante a sessão. Use com o cache de pesquisa ativado.
Tamanho do Cache dos Dados de Pesquisa, Tamanho do Cache de Índice da Pesquisa
Arquivo Simples
Pipeline
Relacional
O padrão é Automático. Indica o tamanho máximo que o Serviço de Integração aloca ao cache de dados e ao índice na memória. É possível usar um valor numérico para o cache, usar um valor de cache proveniente de um arquivo de parâmetros ou configurar o Serviço de Integração para definir o tamanho do cache usando a configuração Automático. Se configurar o Serviço de Integração para determinar o tamanho do cache, você também poderá especificar a área máxima de memória que o Serviço alocará ao cache.
Se o Serviço de Integração não puder alocar a quantidade configurada de memória ao inicializar a sessão, ele provocará a sua falha. Quando o Serviço de Integração não pode armazenar todos os dados do cache na memória, ele faz a paginação no disco.
Use com o cache de pesquisa ativado.
Cache de Pesquisa Dinâmica
Arquivo Simples
Pipeline
Relacional
Indica o uso de um cache de pesquisa dinâmica. Insere ou atualiza as linhas no cache de pesquisa à medida que as transfere para a tabela de destino.
Use com o cache de pesquisa ativado.
Valor Antigo de Saída na Atualização
Arquivo Simples
Pipeline
Relacional
Use com o cache dinâmico ativado. Quando você ativa esta propriedade, o Serviço de Integração gera a saída dos valores antigos pelas portas de pesquisa/saída. Quando o Serviço de Integração atualiza uma linha no cache, ele gera a saída do valor que existia no cache de pesquisa antes de atualizar a linha, com base nos dados de entrada. Quando o Serviço de Integração insere uma linha no cache, ele gera a saída de valores nulos.
Quando você desativa esta propriedade, o Serviço de Integração gera a saída dos mesmos valores pelas portas de pesquisa/saída e entrada/saída.
Essa propriedade é ativada por padrão.
Atualizar Condição de Cache Dinâmico
Arquivo Simples
Pipeline
Relacional
Uma expressão que indica se o cache dinâmico deve ou não ser atualizado. Crie uma expressão usando as portas de pesquisa ou de entrada. A expressão pode conter valores de entrada ou valores no cache de pesquisa. O Serviço de Integração atualiza o cache quando a condição é verdadeira e o dados existem no cache. Use com o cache dinâmico ativado. O padrão é verdadeiro.
Prefixo do Nome do Arquivo de Cache
Arquivo Simples
Pipeline
Relacional
Use com o cache de pesquisa persistente. Especifica o prefixo do nome de arquivo para usar nos arquivos de cache de pesquisa persistente. O Serviço de Integração usa o prefixo como nome para os arquivos de cache persistentes que ele salva no disco. Insira o prefixo. Não insira .idx ou .dat.
Você pode inserir um parâmetro ou variável para o prefixo do nome de arquivo. Use qualquer tipo de parâmetro ou variável que possa ser definido no arquivo de parâmetro.
Se os arquivos de cache persistentes nomeados existirem, o Serviço de Integração cria o cache de memória a partir dos arquivos. Se os arquivos de cache persistentes nomeados não existirem, o Serviço de Integração recria os arquivos de cache persistentes.
Reenviar para cache da Origem de Pesquisa
Arquivo Simples
Pipeline
Relacional
Use com o cache de pesquisa ativado. Quando selecionado, o Serviço de Integração recria o cache de pesquisa a partir da origem da pesquisa, quando chama pela primeira vez a instância da transformação Pesquisa.
Se você usar um cache de pesquisa persistente, ele recria os arquivos de cache persistentes antes de usar o cache. Se você não usar um cache de pesquisa persistente, ele recria o cache de pesquisa na memória antes de usar o cache.
Inserir e Atualizar
Arquivo Simples
Pipeline
Relacional
Use com o cache dinâmico ativado. Aplica-se a linhas inseridas na transformação Pesquisa com o tipo de linha inserir. Quando ativado, o Serviço de Integração insere linhas no cache e atualiza as linhas existentes; quando desativado, ele não atualiza as linhas existentes.
Atualizar e Inserir
Arquivo Simples
Pipeline
Relacional
Use com o cache dinâmico ativado. Aplica-se a linhas inseridas na transformação Pesquisa com o tipo de linha atualizar.
Quando ativado, o Serviço de Integração atualiza as linhas existentes e insere uma linha se for nova. Quando desativado, o Serviço de Integração não insere linhas novas.
Formato de Data e Hora
Arquivo Simples
Clique no botão Abrir para selecionar um formato de data e hora. Defina o formato e a largura do campo. Os formatos de milissegundos, microssegundos ou nanosegundos têm a largura de campo de 29.
Se você não selecionar um formato de data e hora para uma porta, pode inserir qualquer formato de data e hora. O padrão é MM/DD/YYYY HH24:MI:SS. O formato dr Data e Hora não altera o tamanho da porta.
Separador de Milhar
Arquivo Simples
Se você não define um separador de milhares para uma porta, o Serviço de Integração usa as propriedades definidas aqui.
Você pode escolher nenhum separador, uma vírgula ou um ponto final. O padrão é nenhum separador.
Separador Decimal
Arquivo Simples
Se você não definir um separador decimal para um campo específico na definição de pesquisa ou na guia Portas, o Serviço de Integração usa as propriedades definidas aqui.
Você pode escolher um separador decimal de vírgula ou ponto final. O padrão é o ponto final.
Comparação de String com Diferenciação de Maiúscula/Minúscula
Arquivo Simples
Pipeline
O Serviço de Integração utiliza comparações de string com diferenciação entre maiúscula e minúscula ao realizar as pesquisas nas colunas de strings.
Para pesquisas relacionais, a diferenciação entre maiúscula e minúscula depende do suporte do banco de dados.
Ordenamento Nulo
Arquivo Simples
Pipeline
Determina como o Serviço de Integração ordena valores nulos. Você pode optar por classificar valores nulos como altos ou baixos. Por padrão, o Serviço de Integração classifica valores nulos como altos. Isto substitui a configuração do Serviço de Integração para tratar nulos, nos operadores de comparação, como alto, baixo ou nulo.
Para pesquisas relacionais, a classificação dos nulos depende do valor padrão do banco de dados.
Entrada Classificada
Arquivo Simples
Pipeline
Indica se os dados do arquivo de pesquisa estão ou não na ordem classificada. Isso aumenta o desempenho de pesquisas de arquivo. Se você ativar a entrada classificada, e as colunas de condição não estiverem agrupadas, o Serviço de Integração provoca a falha da sessão. Se as colunas de condição estiverem agrupadas, mas não classificadas, o Serviço de Integração processa a pesquisa como se você não tivesse configurado a entrada classificada.
A Origem da Pesquisa é Estática
Arquivo Simples
Pipeline
Relacional
A origem da pesquisa não muda em uma sessão.
Cache de Pesquisa Pré-Criado
Arquivo Simples
Pipeline
Relacional
Permite que o Serviço de Integração crie o cache de pesquisa antes que a transformação Pesquisa receba os dados. O Serviço de Integração pode criar vários arquivos de cache de pesquisa ao mesmo tempo para melhorar o desempenho.
Você pode configurar esta opção no mapeamento ou na sessão. O Serviço de Integração usará a configuração de nível de sessão se você configurar a opção de transformação Pesquisa como Automático.
Configure uma das seguintes opções:
  • Automático. O Serviço de Integração usa o valor configurado na sessão.
  • Sempre permitido. O Serviço de Integração pode criar o cache de pesquisa antes que a transformação Pesquisa receba a primeira linha de origem. O Serviço de Integração cria um pipeline adicional para criar o cache.
  • Nunca permitido. O Serviço de Integração não pode criar o cache de pesquisa antes que a transformação Pesquisa receba a primeira linha.
Configure o número de pipelines que o Serviço de Integração pode criar simultaneamente. Configure os Pipelines Simultâneos Adicionais para a propriedade de sessão Criação do Cache de Pesquisa. O Serviço de Integração poderá pré-criar o cache de pesquisa se esta propriedade for maior que zero.
Precisão de Subsegundos
Relacional
Especifica a precisão de subsegundo das portas de data e hora.
Em pesquisas relacionais, você pode alterar a precisão de bancos de dados que tenham uma escala editável para dados de data e hora. Você pode alterar a precisão de subsegundos para tipos de dados Oracle Timestamp, Informix Datetime e Teradata Timestamp.
Selecione um valor inteiro positivo de 0 a 9. O padrão é 6 microssegundos. Se você ativar a otimização de empilhamento, o banco de dados retorna o valor de data e hora completo, independente da configuração da precisão do subsegundo.