Modelo de cadeia Carregar dados para Wdata

O modelo Load Data to Wdata traz dados para uma tabela Wdata, substituindo um conjunto de dados existente ou adicionando um novo. Esse modelo é usado com mais frequência como parte de uma cadeia existente, mas pode ser adicionado a qualquer fluxo de trabalho que exija que um conjunto de dados seja carregado em uma tabela.

Requisitos

A tabela Wdata de destino deve ser criada antes da execução dessa cadeia.
Este modelo é composto de três cadeias. Cada cadeia deve ser publicada separadamente em em seu espaço de trabalho.
O nome do arquivo deve incluir uma extensão .csv ou .tsv. Por exemplo: "Nome_do_arquivo_Exemplo.csv".
O tamanho máximo de arquivo recomendado para um conjunto de dados é de 300 MB. Saiba mais sobre as recomendações de tamanho de arquivo.

Encontre o modelo

O modelo Load Data to WData está localizado na seção Workiva Chains da tela Templates.

Veja como encontrá-lo:

Em Construtor de Cadeia, vá para a guia Modelos dynamic_feed .
Selecione Cadeias Workiva no menu na parte superior.
Procure por Load Data to Wdata | Primary Chain no canto superior direito e abra o modelo.
Depois de localizar o modelo, clique em Nova cadeia para implantá-lo em seu espaço de trabalho

Observação: Depois de configurada, cada cadeia desse modelo deve ser publicada no espaço de trabalho.

Configurar o modelo

Esse modelo consiste em três cadeias: a cadeia primária, uma cadeia de substituição de conjunto de dados e uma cadeia de adição de novo conjunto de dados. Quando a cadeia primária é implementada em seu espaço de trabalho, as duas cadeias secundárias (Add/Replace) são implementadas automaticamente com ela.

Veja a seguir uma análise mais detalhada de cada cadeia:

Cadeia primária: Essa cadeia determina se há um conjunto de dados em sua tabela que tenha o mesmo nome do conjunto de dados que está sendo carregado pela cadeia. Se um conjunto de dados correspondente for encontrado, a cadeia captura informações sobre o conjunto de dados correspondente e, com base na entrada de tempo de execução "Load Method" que você configurou para a cadeia principal, redireciona esses dados para uma das duas cadeias secundárias.
Cadeia Replace Dataset: Essa cadeia remove o conjunto de dados correspondente de sua tabela e o substitui por um novo. Se ocorrer um erro durante a execução e a opção de reversão for selecionada, a cadeia excluirá automaticamente o novo conjunto de dados e reverterá para o conjunto de dados que deveria ser substituído.
Cadeia Adicionar novo conjunto de dados: Essa cadeia cria um novo conjunto de dados e o importa para a sua tabela. O novo conjunto de dados deve ter um nome de arquivo exclusivo que não seja usado atualmente por nenhum outro conjunto de dados na tabela.

Ao adicionar esse conjunto de cadeias a uma cadeia existente, as entradas de tempo de execução da cadeia primária devem ser configuradas no nó "Cadeia de execução". As cadeias secundárias não exigem nenhuma alteração ou configuração.

Suas configurações devem ser semelhantes a estas:

Variáveis

Tipo

Nome

Finalidade

Variável do espaço de trabalho

wsv_WdataLoadWarningThreshold

Essa variável funciona como um limite flexível para o tamanho do arquivo do conjunto de dados. Qualquer conjunto de dados acima do limite escolhido acionará um aviso. Como o tempo de processamento aumenta com o tamanho do arquivo, conjuntos de dados menores podem ser processados muito mais rapidamente.

O tamanho de arquivo recomendado fornece um aviso amplo de que o seu conjunto de dados pode estar se aproximando do limite de tamanho de arquivo Wdata. Quando um aviso é acionado, você pode considerar refatorar seu arquivo ou explorar outras opções para levar em conta o arquivo maior.

Tamanho de arquivo recomendado: 150 MB a 200 MB

Variável de cadeia dinâmica

dcv-Chain Result

Captura o status da cadeia em vários estágios. Isso é obrigatório e não deve ser alterado.

Entradas de tempo de execução

Entrada em tempo de execução	Finalidade	Tipo de campo	Necessário
ID da tabela	Digite a ID da tabela Wdata para a qual o conjunto de dados será carregado. Esse ID também será usado para determinar se há conjuntos de dados duplicados na tabela. Recomendamos que você use variáveis de espaço de trabalho para armazenar o ID da tabela; isso permite que o modelo seja usado em vários processos.	Texto	Sim
Nome do arquivo	O nome do conjunto de dados que será importado para a tabela Wdata. O nome do arquivo informa à cadeia quais dados devem ser substituídos. Os requisitos do nome do arquivo variam de acordo com a cadeia selecionada: Cadeia Add New Dataset (Adicionar novo conjunto de dados) - O nome do arquivo não deve ser usado em nenhum outro lugar da tabela. Replace Dataset Chain (Substituir cadeia de conjuntos de dados) - O nome do arquivo deve corresponder ao conjunto de dados que será substituído. Observação: O nome do arquivo deve incluir a extensão .csv ou .tsv. Por exemplo: "File_Name_Example.csv"	Texto	Sim
Arquivo de dados	O arquivo de dados que será importado para a tabela. A extensão deve ser .csv ou .tsv. Observação: O arquivo de dados pode utilizar qualquer um dos delimitadores de tabela Wdata compatíveis.	Arquivo	Sim
Método de carga	Determina se o arquivo deve substituir um conjunto de dados existente ou ser adicionado como um novo. Opções: Substituir conjunto de dados Adicionar novo conjunto de dados	Menu suspenso	Sim
Reversão	Em caso de erro, isso reverte todas as alterações e reimporta o conjunto de dados original. Definido como True por padrão. Aplicável somente ao método de carregamento Replace Dataset.	Booleano (Verdadeiro/Falso)	Não

Solução de problemas

Para visualizar o histórico de execução da cadeia, inclusive os erros:

Acesse a guia Monitor no Chain Builder.
Passe o mouse sobre o ponto de interrogação para ver o status da execução da cadeia.

Se sua cadeia acionou um erro ou não conseguiu atualizar os dados corretos, faça as seguintes verificações:

Verifique se todas as três cadeias foram publicadas em seu espaço de trabalho. Cada cadeia deve ser publicada separadamente.
Certifique-se de que seu conjunto de dados use um delimitador compatível e que o nome do arquivo inclua uma extensão .csv ou .tsv ("File_Name_Example.csv").
Ao usar o método de carregamento Replace Dataset, verifique se o nome do arquivo corresponde ao nome do arquivo existente em sua tabela Wdata. Se não corresponder, a cadeia simplesmente adicionará um novo arquivo à sua tabela sem substituir o antigo.
Por outro lado, ao usar o método de carregamento Adicionar novo conjunto de dados, verifique se o nome do arquivo não é usado em nenhum outro lugar na tabela Wdata. A cadeia falhará se um nome de arquivo sobreposto for usado.
Certifique-se de que a concessão OAuth2 associada à conexão Workiva tenha o acesso apropriado.
Ao inserir o ID da tabela, verifique se todo o ID foi digitado e se não há espaços em branco à esquerda ou à direita.
Verifique se há variáveis de carimbo de data/hora de tempo de execução. Não devem ser usados em nomes de arquivos, pois criam um nome de arquivo exclusivo para cada conjunto de dados, o que significa que a cadeia não conseguirá identificar nenhum conjunto de dados correspondente em sua tabela.

Mapeamentos de colunas e outras modificações na cadeia

Se você tiver problemas com os cabeçalhos das colunas ao importar dados, pode usar data prep ou outros comandos.

Opcional: Marcação de conjuntos de dados importados

A marcação é compatível com a importação de conjuntos de dados, mas recomendamos que você implemente um conjunto adicional de cadeias a partir do modelo antes de fazer qualquer alteração no original. Uma vez modificada, a cadeia provavelmente será difícil de ser reutilizada em outras tabelas, a menos que os conjuntos de dados nessas tabelas utilizem as mesmas tags.

Para adicionar marcação a uma cadeia:

Adicione as seguintes entradas de tempo de execução a cada uma das três cadeias implementadas a partir deste modelo:
- Tag-Key (campo de texto)
- Tag-Value (campo de texto)
Edite a cadeia primária para passar as entradas de tempo de execução para cada evento de "Cadeia de execução":
Em Replace Dataset Chain (Substituir cadeia de conjuntos de dados) e em Add New Dataset Chain (Adicionar nova cadeia de conjuntos de dados), edite o nó de comando "Import New Dataset" (Importar novo conjunto de dados) para aceitar as entradas de tempo de execução da tag.