Show Menu
TÓPICOS×

LookupRows

A transformação LookupRows procura outras entradas de log com a mesma ID de rastreamento e define o valor do campo de saída para o valor de um campo designado na linha de entrada.
Como a LookupRows transformação realiza sua pesquisa nas entradas de registro e não nos arquivos de pesquisa, é muito semelhante à CrossRows transformação. Consulte CrossRows .
Para funcionar, a LookupRows transformação exige que os dados sejam solicitados no tempo e agrupados pela ID de rastreamento nos dados de origem. Portanto, LookupRows funciona somente quando definido no Transformation.cfg arquivo ou em um Transformation Dataset Include arquivo.
À medida que você revisa as descrições dos parâmetros na tabela a seguir, lembre-se do seguinte:
  • A linha de saída é a linha de dados na qual a transformação está funcionando em um determinado ponto no tempo.
  • As linhas de entrada são todas as outras linhas de dados (antes, depois ou incluindo a linha de saída) cujos valores do campo de entrada servem como entradas para a transformação.
Parâmetro Descrição Padrão
Nome Nome descritivo da transformação. Você pode digitar qualquer nome aqui.
Comentários Opcional. Notas sobre a transformação.
Condição Limita a saída da transformação a determinadas entradas de log. Se a condição não for atendida para uma entrada de log específica, o campo no parâmetro Saída de valor de linha de saída permanecerá inalterado. A entrada ainda pode ser usada para afetar outras entradas de log.
Condição de entrada Aceita a entrada para a transformação somente de determinadas linhas de entrada. Se a Condição de entrada não for atendida para uma linha de entrada específica, o campo de entrada dessa linha será ignorado e não afetará outras linhas de saída. No entanto, o campo de saída dessa linha ainda é modificado de acordo com a Condição especificada.
Entrada da chave de linha de entrada O nome do campo a ser usado como a chave para as linhas de entrada.
Entrada do valor da linha de entrada O nome do campo na linha de entrada cujo valor é copiado para o campo no parâmetro Saída do Valor da Linha de Saída se todas as condições forem atendidas.
Operação
Uma operação que, para cada linha de saída, é aplicada a todas as linhas de entrada que satisfazem todas as condições definidas pelos parâmetros Input Condition e Input Row Key Input Input (Condição de entrada) para produzir uma saída:
  • PRIMEIRO gera o valor do campo no parâmetro Entrada do valor da linha de entrada a partir da primeira linha de entrada correspondente nos dados (não a primeira linha correspondente após a linha de saída).
  • ÚLTIMO resulta no valor do campo no parâmetro Entrada do valor da linha de entrada a partir da última linha de entrada nos dados (não a última linha correspondente antes da linha de saída).
Entrada da chave da linha de saída O nome do campo a ser usado como a chave para a linha de saída.
Saída do Valor da Linha de Saída O nome do campo na linha de saída cujo valor é copiado do campo no parâmetro Entrada do valor da linha de entrada se todas as condições forem atendidas. Todas as linhas de saída com os mesmos valores de entrada x-trackingid e de entrada de chave de linha de saída têm o mesmo valor de saída de valor de linha de saída.
Os parâmetros Input Row Key Input, Input Row Value Input e Input Condition definem juntos o arquivo de pesquisa para cada ID de rastreamento, enquanto os parâmetros Output Row Key Input, Output Row Value Input e Condition controlam o que é pesquisado no arquivo e qual valor é armazenado no campo especificado por Output Row Value Output.
Para entender melhor a operação da transformação, considere o seguinte contorno:
  • Para cada linha de saída que satisfaça a Condição e tenha uma entrada de chave de linha de saída não vazia:
    • Encontre a primeira ou a última linha de entrada de forma que
      • a linha de entrada satisfaz a condição de entrada e
      • o x-trackingid da linha de entrada é igual ao x-trackingid da linha de saída, e
      • a entrada da chave da linha de entrada é igual à entrada da chave da linha de saída da linha de saída,
  • e defina a Saída do Valor da Linha de Saída da linha de saída como Entrada do Valor da Linha de Entrada da linha de entrada.
Considerações para LookupRows
  • Valores de chave em branco nunca correspondem a nada. Mesmo que haja linhas de entrada com chaves em branco e valores que não estejam em branco que correspondam aos valores Input Condition, um Output Row Key Input de "" sempre produzirá um valor Output Row Value Output de "".
  • Se não for proibido pelo Input Condition, uma linha pode se procurar se seus valores Input Row Key Input e Output Row Key Input valores forem os mesmos.
Se você tiver vários valores chave, poderá combiná-los usando uma Format transformação (consulte Formatar ) antes de aplicar uma LookupRows transformação.
Suponha que você tenha um site que tenha uma página de registro de animais de estimação, onde o nome e a raça sejam inseridos, e uma página posterior de "comprar brinquedo", onde apenas o nome do animal de estimação seja usado. Você gostaria de ser capaz de vincular o nome do animal de estimação à raça de estimação inserida na página de registro. Para fazer isso, você pode criar a seguinte LookupRows transformação:
Vamos analisar este exemplo usando o contorno anterior:
  • Para cada linha de saída que satisfaça um valor não vazio de cs-uri-query(petname) :
    • Encontre a ÚLTIMA linha de entrada de forma que
      • a linha de entrada contém um valor não vazio de cs-uri-query(petrace) e
      • o x-trackingid da linha de entrada é igual ao x-trackingid da linha de saída, e
      • o valor de cs-uri-query(petname) da linha de entrada é igual ao valor de cs-uri-query(petname) da linha de saída,
  • e defina o valor de x-pet-range da linha de saída para o valor de cs-uri-query(petrace) da linha de entrada.
A LookupRows transformação usa o nome do animal de estimação (a chave) para garantir que a raça esteja vinculada ao registro do animal de estimação e compre páginas de brinquedos para que você possa analisar os brinquedos comprados para cada raça de animais de estimação, mesmo para visitantes com vários animais de estimação.