Ir para o conteúdo

Esquemas Espelhados

Introdução

Se você estiver usando um esquema no lado de origem ou de destino de uma transformação e quiser copiar sua estrutura para usar no outro lado da transformação, poderá espelhar o esquema dentro da transformação. Depois que um esquema é espelhado, ele se torna um esquema personalizado que você pode editar no editor de esquema para um esquema simples personalizado ou esquema hierárquico personalizado.

O espelhamento de um esquema só é possível quando a origem ou destino para o qual o esquema está sendo copiado não é um esquema gerado pelo conector adjacente.

Crie um Esquema Espelhado

A opção de espelhar um esquema está disponível somente quando determinadas condições são atendidas. Esta seção descreve primeiro quando o espelhamento está disponível e depois aborda como espelhar um esquema. O esquema resultante gerado do espelhamento de um esquema está no mesmo formato do esquema que está sendo espelhado. Por exemplo, se você espelhar um esquema JSON, obterá um esquema JSON; se você espelhar um esquema XML, obterá um esquema XML resultante, etc.

Quando o Espelhamento Está Disponível

Para poder espelhar um esquema, primeiro adicione uma transformação para uma operação e definir seu esquema de origem ou de destino de qualquer uma das maneiras descritas em Esquemas definidos em uma atividade ou Esquemas definidos em uma Transformação (exceto para a opção de esquema espelhado).

Dependendo se o esquema de origem ou de destino estiver definido, o esquema do outro lado da transformação não deverá ser definido para que a opção de espelhamento esteja disponível. Se a operação tiver uma atividade no outro lado da transformação, durante a configuração da atividade ao fornecer um esquema de solicitação ou resposta, certifique-se de selecionar Nenhum na seleção suspensa do esquema para que o esquema não seja herdado pela transformação.

A origem ou o destino para o qual o esquema está sendo copiado não pode ter um esquema adjacente gerado pelo conector; entretanto, qualquer atividade de origem ou de destino com um esquema definido pelo usuário pode ter um esquema copiado para ela, mesmo que a origem da cópia seja de uma atividade gerada pelo conector. Por exemplo, você pode espelhar o esquema gerado a partir de uma Consulta de banco de dados usada como origem de uma transformação se o destino de uma transformação tiver um esquema definido pelo usuário, como aquele de uma atividade FTP Write. No entanto, você não pode espelhar um esquema fornecido por uma atividade FTP Read para usar como esquema de destino para uma atividade Database Insert, pois você deve usar o esquema gerado pelo endpoint do banco de dados. Nesses casos, a opção de espelhamento não está presente.

Espelhar um Esquema

Desde que as condições acima sejam atendidas, a opção de espelhamento é exibida em modo de mapeamento no lado de origem ou de destino da transformação. Dentro da transformação, clique no botão apropriado para Mirror Target Schema ou Mirror Source Schema no respectivo lado da transformação:

  • Lado de origem: Para copiar um esquema usado no lado de destino da transformação para o lado de origem, clique em Espelhar esquema de destino no lado de origem:

    nenhum esquema de origem espelhado no esquema de destino

  • Lado do Destino: Para copiar um esquema usado no lado de origem da transformação para o lado de destino, clique em Espelhar Esquema de Origem no lado de destino:

    nenhum esquema de origem do espelho do esquema de destino

Isso copia a estrutura de origem ou de destino de um lado da transformação para o outro, respectivamente, criando um novo esquema JSON chamado "Esquema Espelhado" por padrão:

esquema espelhado

Na maioria dos casos, o esquema espelhado resultante é uma cópia exata do esquema que está sendo espelhado, convertido para o formato JSON. Existem duas exceções fornecidas como auxílio ao usuário:

  • Atividades de banco de dados: Se o esquema que está sendo espelhado for de uma atividade de banco de dados usando uma única tabela (sem junções), o esquema espelhado resultante será criado automaticamente com um nó filho adicional chamado row. Quando os campos dentro deste nó adicional são mapeados, o nó se torna um nó de loop para permitir que todos os registros sejam repetidos.
  • Atividades baseadas no Salesforce: Se o esquema que está sendo espelhado for de um Salesforce não em massa, Salesforce Service Cloud ou atividade ServiceMax, o esquema espelhado resultante será criado automaticamente com um nó raiz adicional chamado records com o(s) nó(s) filho(s) espelhando o esquema. Quando os campos dentro do(s) nó(s) filho(s) são mapeados, o nó se torna um nó de loop para permitir que todos os registros sejam repetidos.

Para obter mais informações, consulte Nós de loop em Nós e Campos.

Depois de criado, o esquema espelhado é independente do esquema de origem do qual foi espelhado. Ou seja, você pode renomear ou editar esse esquema da maneira que desejar, sem afetar o esquema de origem original. Como o espelhamento de um esquema copia o esquema inteiro, dessa forma você pode primeiro espelhar um esquema e depois editá-lo para remover campos para cortar o esquema (por exemplo, para copiar um esquema de banco de dados apenas para algumas tabelas que estão sendo unidas).

Menu de Ações do Esquema

Após a criação de um esquema espelhado, você poderá acessar opções de menu adicionais que estão disponíveis para todos os esquemas.

Isso inclui exclusão, renomeação, visualização de dependências, implantação, implantação configurável e adição a um grupo, bem como edição de um esquema ou limpeza de um esquema de uma transformação. Para obter detalhes sobre essas ações, consulte Menu Ações do esquema.

Nota

Quando você edita um esquema que foi criado usando este método (a partir do espelhamento de um esquema de origem), a tela de configuração de um esquema simples personalizado ou esquema hierárquico personalizado é aberto para você adicionar ou editar campos e/ou nós conforme necessário.