Acrescentar uma coluna numa tabela Silver ou Gold

As tabelas Silver e Gold (as mart_… também) são montadas por uma receita: de quais tabelas o dado vem, quais colunas entram e qual filtro vale. Um dado novo — por exemplo, clicks numa tabela que só tem impressões — só aparece na tabela quando entra na receita e a tabela é refeita.

Antes: a receita já tem a coluna?#

Às vezes a receita já calcula a coluna e a tabela é que foi gerada antes dela — aí basta refazer a tabela (passo 4). Para conferir, pergunte ao Aiô ("a mart_estado_cidade calcula clicks?"): ele lê a receita e as colunas que a tabela tem hoje, e diz se falta só executar de novo.

Passo a passo#

1. Em ETL/ELT → Pipelines, abra o pipeline que monta a tabela. Tabelas Gold ficam num pipeline próprio, separado do que traz os dados da origem.

2. Na seção Camada Gold (ou Camada Silver), ache o cartão da tabela e clique em Editar.

3. Acrescente a coluna:

   • no modo Guiado, use Adicionar coluna e escolha o campo da tabela de origem — ou Coluna calculada, para uma conta (ex.: valor_total * 0.1);

   • no modo SQL livre, acrescente a coluna no SELECT final. Exemplo, contando os cliques de cada linha de origem:

     sqlCopiar

     COUNTIF(Clicked) AS clicks

4. Salve. O cartão passa a mostrar ⟳ requer reprocessar: a receita mudou, mas a tabela ainda não.

5. No cartão da tabela, clique em Processar agora — roda só esta tabela, de verdade, e mostra o resultado com o link Ver execução. (Para rodar o pipeline inteiro, use Executar agora no topo.) Quando a execução terminar, a tabela já tem a coluna nova e o cartão volta a ✓ Processado.

6. No painel que usa a tabela, clique em Atualizar agora. Ele refaz a cópia da tabela que o painel guarda, e a coluna aparece na lista de Campos.

7. Arraste a coluna para o visual — números vão em Valores; texto e data vão no Eixo (no mapa, Local).

Você vai ver a coluna na lista de Campos, debaixo do nome da tabela, e o número no visual.

Por que não "trazer o campo de outra tabela"?#

Um campo com o nome certo pode existir em outra tabela — clicks está na tabela diária, por exemplo. Mas uma tabela por dia e outra por estado e cidade contam coisas em níveis diferentes: somadas juntas, dão um número que não quer dizer nada. O caminho certo é a coluna nascer na própria tabela, com o mesmo nível de detalhe dela (passo 3).

Perguntas comuns#

Executei e a coluna não apareceu no painel. Falta o passo 6: o painel lê uma cópia guardada da tabela, e é o Atualizar agora que traz as colunas novas.

O cartão diz "⟳ requer reprocessar" há dias. A receita foi editada e o pipeline não rodou desde então. Execute (passo 5) — ou ligue a agenda do pipeline para ele rodar sozinho.