Conceito: alterações no esquema do conjunto de dados

Um esquema é um conjunto de regras que define como os dados são organizados, estruturados e restritos. Vários artefatos e componentes do Workday têm um esquema, incluindo conjuntos de dados e componentes de conjunto de dados.

Um conjunto de dados pode consistir em vários esquemas, dependendo de como ele estiver configurado. Cada um destes componentes do conjunto de dados tem seu próprio esquema:

Os arquivos que contêm dados externos que você carrega em um conjunto de dados base.
O relatório personalizado que você cria para colocar os dados do Workday em um conjunto de dados base.
A entrada para uma fase. Para a primeira fase em um conjunto de dados base, esse esquema é determinado pela origem do conjunto de dados.
A saída de uma fase. Para a última fase no pipeline principal, esse esquema determina o esquema de saída de todo o conjunto de dados.

As alterações de esquema podem ocorrer em qualquer lugar de um conjunto de dados. Os esquemas mudam quando você adiciona novos campos ou remove campos existentes, como por exemplo, quando você:

Adicione um campo calculado Prism.
Oculte ou exponha um campo.
Adicione uma fase que acrescente ou exclua campos nessa fase.

Os esquemas também podem ser alterados nos conjuntos de dados base quando você:

Carregue um arquivo externo.
Importe um arquivo de um servidor SFTP.
Importe dados de um relatório personalizado.

As alterações onde as alterações ocorrem em um conjunto de dados podem afetar outros componentes do conjunto de dados. Alterações nos esquemas do conjunto de dados podem dividir componentes que foram baseados no esquema original. O local onde as alterações ocorrem também pode afetar a forma como você as gerencia.

Quando você importa dados que alteram o esquema de um conjunto de dados base de um servidor SFTP ou relatório personalizado, deve editar manualmente o conjunto de dados base para incorporar as alterações. Quando novos campos são adicionados ao conjunto de dados devido à alteração do esquema de origem, o Workday os oculta automaticamente. Exponha os novos campos e salve o conjunto de dados base para incluir os campos no esquema do conjunto de dados.

A Workday recomenda que você garanta que o conjunto de dados esteja atualizado e inclua os campos que você quer. Na maioria dos casos, você usa a fase Gerenciar campos para gerenciar alterações de esquema do conjunto de dados.

A fase Gerenciar campos usa a saída da fase anterior como base para monitorar as alterações. Quando essa base é alterada, o Workday avisa no painel de detalhes do pipeline. Se a linha de base é alterada, na fase Gerenciar campos, o Workday:

Exibe todos os campos novos e removidos.
Ainda não inclui todas as alterações no esquema do conjunto de dados.
Não exibe nenhum dado na tabela de exemplo.

A Workday recomenda:

Adicione uma fase Gerenciar campos no início do pipeline principal de um conjunto de dados derivado quando você quiser monitorar o esquema da tabela ou do conjunto de dados do qual é derivado.
Adicione uma fase Gerenciar campos no final do Pipeline principal de um conjunto de dados que você pretende publicar. Isso permite que você detecte quaisquer alterações de esquema que possam interromper os relatórios que usam a fonte de dados Prism deste conjunto de dados publicado.
Adicione uma fase Gerenciar campos ao final de um pipeline quando você precisar ocultar campos ou expor novos campos.
Adicionar uma fase Gerenciar campos a um conjunto de dados base para garantir que nenhuma integração futura possa remover acidentalmente um campo existente.
Inclua no máximo duas fases Gerenciar campos em um único pipeline.

Em alguns casos, o Workday lida com as alterações de esquema sem usar uma fase Gerenciar campos. Exemplo: quando é carregado uma nova versão de um arquivo de origem em um conjunto de dados base, o Workday trata as alterações de esquema com base na linha de cabeçalho do arquivo de origem:

O arquivo de origem contém a linha do cabeçalho	Resultado
Sim	O Workday usa os nomes dos campos na linha de cabeçalho do conjunto de dados base para determinar quais campos estão no novo arquivo de origem. Você pode adicionar ou excluir campos em qualquer lugar do arquivo de origem. Se os nomes dos campos no arquivo de origem não mudam, o Workday atualiza o esquema do conjunto de dados base para o qual você importa o novo arquivo de origem.
Não	O Workday lida com as alterações que ocorrem apenas no final do arquivo de origem. Você pode adicionar novos campos somente no final do arquivo de origem. Se você fizer isso, o Workday atualiza o esquema do conjunto de dados base para o qual você está importando o novo arquivo de origem.