Configurando a Tabela

Após carregar seus dados, é fundamental configurar os metadados técnicos e de negócio para garantir que a tabela seja útil e performática. Toda a configuração é feita na tela de Edição de Tabela.

---

🔑 Metadados e Chaves

A primeira aba da edição foca na estrutura da tabela.

Tipos de Dados

Revise os tipos de dados (Texto, Número, Data) de cada coluna para garantir que estejam corretos.

TIP

Colunas de códigos (ID, CNPJ, CPF) devem ser preferencialmente Texto ou configuradas com o comportamento Agrupar para preservar a formatação e evitar operações matemáticas indesejadas (como soma de CPFs).

Chaves (Primary Key)

Definir a chave da tabela é crucial para a performance e integridade dos dados:

Tipo de Chave	Comportamento	Uso Recomendado
Chave Duplicada (Duplicate Key)	É o padrão. Permite que existam linhas idênticas ou com a mesma chave	Tabelas de fatos (transações, logs)
Chave Única (Unique Key)	Garante que não haja duplicidade na coluna chave. Linhas com o mesmo ID são substituídas (Update)	Tabelas de dimensões (Clientes, Produtos)

WARNING

Alterar a chave ou tipo de dados de uma tabela já existente exigirá que ela seja Reconstruída, o que vai necessitar de uma nova carga de dados.

---

📊 Comportamento das Colunas

Configure como o módulo de DataViz deve interpretar cada coluna por padrão, facilitando a criação de gráficos pelos usuários finais.

Comportamento (Agregação)

Para colunas numéricas, defina a agregação padrão:

Agregação	Uso Recomendado
Soma (Sum)	Valores monetários, quantidades — ao arrastar para um gráfico, o sistema já aplicará a soma
Média (Avg)	Taxas, notas, indicadores percentuais
Nenhum (None)	Campos numéricos que não são medidas, mas identificadores (Ano, Mês, ID Loja) — orienta o DataViz a tratar como Dimensão (Eixo)

Máscaras e Formatação

Aplique máscaras visuais aos dados para melhorar a apresentação:

Máscara	Exemplo
Moeda	R$ 1.000,00
Porcentagem	10,5%
Data/Hora	DD/MM/AAAA

---

🧮 Fórmulas (Colunas Calculadas)

Crie novas colunas baseadas em lógica de negócio usando a aba Expressões. O HorusDW utiliza a sintaxe do banco de dados Apache Doris.

Adicionando uma Expressão

1. Vá até a aba Expressões
2. Clique em Nova Expressão
3. Defina um Nome funcional ("Ticket Médio")
4. Selecione o Tipo de Dado e a Máscara
5. Escreva a fórmula no editor

Exemplos Comuns

Ticket Médio (Divisão)

sum(VALOR_VENDA) / count(distinct ID_PEDIDO)

Classificação de Texto (Case When)

Útil para criar agrupamentos de negócio:

CASE 
    WHEN valor_total > 1000 THEN 'Alto Valor'
    WHEN valor_total > 500 THEN 'Médio Valor'
    ELSE 'Baixo Valor'
END

Distinção PF/PJ (Tamanho da String)

CASE 
    WHEN length(cpf_cnpj_limpo) > 11 THEN 'Pessoa Jurídica' 
    ELSE 'Pessoa Física' 
END

Extração de Data

year(data_venda)  -- Retorna o Ano (Inteiro)
month(data_venda) -- Retorna o Mês (Inteiro)

TIP

Use o autocompletar do editor para ver as colunas disponíveis. As fórmulas são processadas em tempo de consulta, garantindo que os dados estejam sempre atualizados.