Buscar K
Aparência
Configurar uma tabela
- Tipo
- Como fazer
- Para
- Engenharia de dados, Analista
- Na tela
- HorusDW › Tabelas › Editar Tabela
A tela Editar Tabela é onde uma tabela fica pronta para o BI: a chave decide se uma carga substitui ou acumula linhas, e os campos de cada coluna dizem ao DataViz e à IA do Lumo como ler aquele dado. Ela vale para Tabela e Tabela Estática; o Cadastro tem editor próprio (veja Criar e estruturar um Cadastro), e na tabela Datalake a tela não mostra chave nem expressões.
Para abrir, clique em Editar na linha da tabela, em HorusDW › Tabelas.
Escolher a chave
O Tipo de Chave define o que acontece quando chega uma linha com a mesma chave de outra que já está na tabela:
| Tipo de Chave | O que faz |
|---|---|
| Chave Duplicada (padrão) | Guarda as duas linhas. As Colunas Chave servem só de índice para consultas mais rápidas |
| Chave Única | Fica só a última linha de cada combinação das Colunas Chave. É ela que evita duplicar dado entre cargas |
Quem decide é a Gravação do Dataflow que alimenta a tabela; ser tabela fato ou dimensão não muda a escolha. Chave Única só deduplica com pelo menos uma coluna marcada em Colunas Chave; sem coluna marcada, ela se comporta como Chave Duplicada.
| Gravação do Dataflow | Tipo de Chave |
|---|---|
| Substituir tudo ou Substituir a janela | Qualquer um. A carga apaga antes de inserir |
| Atualizar por chave | Chave Única com Colunas Chave. Sem isso, o Dataflow é recusado ao salvar |
| Extração Incremental num Dataflow novo | Chave Única com Colunas Chave, pelo mesmo motivo |
| Somente inserir | Não aceita tabela com Chave Única e Colunas Chave: ela substituiria a linha de qualquer forma, e o Dataflow é recusado ao salvar |
Por exemplo, numa tabela de pedidos carregada com Extração Incremental, marque Chave Única e ponha ID_PEDIDO em Colunas Chave: um pedido alterado na origem substitui a linha antiga em vez de virar uma segunda. Os pares de Extração e Gravação estão em Tipos de carga.
A Coluna de Partição (Apenas Data) é opcional e aceita só coluna do tipo Data. Ela divide a tabela por data e acelera consulta e limpeza de período em tabela grande.
WARNING
Mudar chave, colunas chave, partição ou o nome e o tipo de uma coluna reconstrói a tabela, e os dados atuais se perdem. A tela avisa com Reconstrução Necessária antes de salvar. Numa tabela de Dataflow, o dado volta na próxima execução; numa Tabela Estática, reprocesse os arquivos em Gerenciar Arquivos.
Preencher as colunas
A aba Colunas tem uma linha por coluna:
| Campo | Para que serve |
|---|---|
| Rótulo | O nome que as pessoas veem no DataViz, por exemplo Valor Líquido no lugar de VL_LIQ |
| Descrição | Uma frase sobre o campo, lida pela IA para entender o dado. Ex.: Valor do pedido após descontos, sem frete |
| Máscara | Formato do número: Número Inteiro, Moeda R$, Porcentual (%), casas decimais, segundos, minutos e outras |
| Comportamento | Em número: Somatório (padrão), Agrupar ou Média. Em data: Data, Mês e Ano, Somente Ano ou Data e Hora |
| Papel | O que o dado é. Guia a IA na hora de somar, tirar média ou agrupar |
Use Agrupar para número que não é medida, como ANO ou COD_LOJA: o DataViz passa a tratá-lo como dimensão e não soma. Use Média para taxa, percentual e preço unitário.
Os papéis disponíveis são:
| Papel | Quando usar |
|---|---|
| Identificador (código) | Código, ID, CPF ou CNPJ que o usuário não lê |
| Nome | Nome de produto, cliente, empresa |
| Pessoa | Nome de gente: vendedor, funcionário |
| Categoria | Poucos valores que agrupam: tipo, setor, situação |
| Data | Data ou data e hora |
| Dinheiro | Valor monetário que se soma |
| Quantidade | Contagem ou volume que se soma |
| Saldo (retrato na data) | Estoque ou saldo numa data: soma entre itens, nunca ao longo do tempo |
| Média ou taxa (não soma) | Média, percentual, preço unitário |
| Texto livre | Observação sem uso para agrupar |
O papel e a descrição não mudam o Dashboard. Eles servem ao Chat com Dados, ao MCP e aos geradores de IA, que erram menos quando sabem que um saldo não se soma ao longo do tempo.
Clique em Salvar ao terminar.
Preencher com Gerar com IA
O botão Gerar com IA, abaixo da lista de colunas, preenche rótulo, máscara, comportamento e papel de todas as colunas de uma vez. A tela pede confirmação, porque ele substitui todos os rótulos que já existem, e mostra Ajustando Rótulos... enquanto roda.
O papel que alguém escolheu à mão é preservado; os que a IA preencheu aparecem com a etiqueta IA e podem ser trocados. Revise o resultado antes de publicar. O uso conta nos créditos de IA.
Depois de publicada
Numa tabela publicada, a tela tranca o nome e o tipo das colunas e as expressões. Rótulo, descrição, máscara, comportamento e papel continuam editáveis. Para mudar a estrutura, clone a tabela para a sua Minha Mesa, mude lá e publique substituindo a original. Veja Publicar uma tabela.
Se der errado
A tabela "…" não tem chave única: com carga Incremental, cada registro alterado entraria como linha nova (ou com a Gravação "Atualizar por chave"): a tabela está com Chave Duplicada ou sem Colunas Chave. Marque Chave Única, escolha as colunas e salve a tabela antes do Dataflow.
O total do Dashboard dobra a cada carga: a tabela tem Chave Duplicada e o Dataflow regrava linhas que já estavam lá. Troque para Chave Única com a coluna que identifica o registro.
Relacionado
Pelo Lumo CLI
Chave, partição, rótulos, máscara, papel e descrição também podem ser versionados em YAML. Veja a referência de table.