bi-nomenclatura

Padrão Corporativo de Nomenclatura

Técnico para quem desenvolve, intuitivo para quem consome, previsível para quem mantém. O nome revela o papel do objeto antes de ele ser aberto.

Regra de ouro

SQL é estrutura. Power BI é comunicação. Prefixo técnico só existe na camada física. Todo objeto visível no modelo usa nome de negócio. Colunas técnicas que sobram (chaves, FKs) ficam ocultas.

Motivo além da leitura humana: Copilot e agentes de IA leem nomes ao pé da letra. TabFatVenda piora respostas em linguagem natural; Vendas ajuda.

SQL Físico → Views Semânticas → Power Query → Modelo Semântico → Relatórios

1. Prefixos da camada física

2. Papel dimensional

TabFlt é uma tabela achatada que junta fato e dimensões. Serve para escopo pequeno ou export de terceiros. Quando o volume ou o reuso crescer, migre para TabDim/TabFat.

❌ Proibido nome genérico: TabFatDados, TabFatBase.

3. Convenções gerais (camada física)

• Singular: TabDimCliente ✔️ │ TabDimClientes ❌
• PascalCase: TabFatVendaMensal ✔️ │ tab_fat_venda ❌
• Sem caractere especial, espaço no início ou fim, ou emoji.

4. Campos

❌ Abreviação proibida: CodCli, DtFat, VlrTot.

Em SQL, use sempre AS [Nome Amigável] na view semântica: reduz renomeação no Power Query e antecipa a camada semântica.

-- View semântica: estrutura física por dentro, nome de negócio por fora
CREATE VIEW VwFatVenda AS
SELECT
    v.CodigoCliente AS [Código do Cliente],
    v.DataVenda     AS [Data da Venda],
    v.ValorVenda    AS [Valor da Venda]
FROM TabFatVenda AS v;

5. Fronteira física × semântica

6. Medidas e variáveis DAX

• Medida: nome amigável com espaços — Total de Vendas, Ticket Médio.
• Variação: [Base] [Período] ([Unidade]) — Total de Vendas (ytd), Margem Bruta (%).
• Contagem: prefixo # — # Pedidos, # Clientes.
• Variável DAX: camelCase com prefixo v — vTotalVendas, vMetaMes.

7. Comparativo temporal: AV/AA/Δ/Δ%/Δi

Padrão oficial para qualquer medida que compara o período corrente com o mesmo período do ano anterior. Use o símbolo literal, nunca por extenso.

Total de Vendas AV = SUM ( TabFatVenda[ValorVenda] )

Total de Vendas AA =
CALCULATE ( [Total de Vendas AV], SAMEPERIODLASTYEAR ( TabDimCalendario[Data] ) )

Δ Total de Vendas = [Total de Vendas AV] - [Total de Vendas AA]

Δ% Total de Vendas = DIVIDE ( [Δ Total de Vendas], [Total de Vendas AA] )

Δi Total de Vendas =
VAR vVariacao = [Δ% Total de Vendas]
RETURN
    SWITCH (
        TRUE (),
        ISBLANK ( vVariacao ), BLANK (),   -- sem ano anterior: sem farol
        vVariacao > 0, "✔️",
        vVariacao = 0, "⚠️",
        "❗"
    )

⚠️ SAMEPERIODLASTYEAR exige a tabela de calendário marcada como Tabela de Datas.

Os nomes físicos no exemplo (TabFatVenda, TabDimCalendario) aparecem porque a referência DAX usa o nome da tabela no modelo. Se as tabelas já foram renomeadas para a camada semântica, troque por Vendas[Valor da Venda] e Calendário[Data].

Checklist ao criar ou renomear

1. O prefixo revela o papel? (física)
2. Singular e PascalCase? (física)
3. Objeto visível usa nome de negócio, sem prefixo técnico?
4. Campos semânticos com nome amigável via alias ou renomeação?
5. Nenhuma abreviação críptica sobrou?
6. Comparativos temporais seguem AV/AA/Δ/Δ%/Δi?