Cadastro dos clientes
A tabela dim_customer armazena o cadastro dos clientes (consumidores) da loja: nome, contato, documento, telefone, endereço, consentimento de marketing e o atendente responsável pela carteira. Cada linha é um cliente, identificado pela coluna customer_id, com o cadastro atual dele. Com dados atualizados de hora em hora, entre 6h e 22h (horário de Brasília); de madrugada não há atualização.
Exemplo
Um consumidor fala pela primeira vez com a loja pelo WhatsApp e, dias depois, informa o e-mail ao atendente. Na tabela isso vira uma linha só:
• customer_id = 'cli123', name = 'Ana', phone_country_code = '55', phone_area_code = '11', phone_number = '912345678', created_at no dia do primeiro contato.
• Quando o e-mail é informado, a mesma linha passa a ter email = 'ana@exemplo.com' e updated_at muda. O valor anterior não fica guardado.
• Se o atendente Bruno colocar a Ana na carteira dele, user_owner_id passa a ser o user_id do Bruno na dim_user.
Muitos campos ficam vazios porque dependem do que foi cadastrado: em geral só o telefone vem preenchido em quase todos. O telefone é dividido em três colunas; junte phone_country_code, phone_area_code e phone_number para ter o número completo. O mesmo número pode aparecer em mais de um customer_id, então para contar pessoas pelo telefone use count(distinct ...) do número montado.
accept_marketing pode vir true, false ou vazio; vazio quer dizer que não há registro de consentimento, não que a pessoa aceitou. birth_date é texto no formato 'AAAA-MM-DD HH:MM:SS' e raramente vem preenchido. Para o nome do atendente da carteira, cruze user_owner_id com a dim_user; os campos personalizados do cadastro ficam na dim_customer_custom_fields, pelo customer_id.
Em contas com mais de uma loja, o mesmo consumidor tem um customer_id em cada loja: use retailer_id para separar.
Atenção: Os registros desta tabela utilizam o fuso horário UTC, ou seja, para que as datas sejam referentes ao fuso horário brasileiro, é preciso inserir nas queries o fuso horário brasileiro.
SET TIME ZONE '-03:00';
SELECT month(tb.birth_date) as mes_aniver
,COUNT(tb.customer_id) as qtd_clientes
FROM dim_customer AS tb
WHERE tb.created_at >= '2025-04-01'
GROUP BY month(tb.birth_date)
;
Dicionário de dados
Variável | Tipo | Descrição |
customer_id | string | Id interno do consumidor, utilizado para vincular à outras tabelas (pela coluna customer_id das mesmas) |
retailer_id | string | Id interno do cliente |
user_owner_id | string | Id do atendente que tem esse consumidor na carteira. |
name | string | Nome do consumidor |
string | Email do consumidor | |
document | string | Documento do consumidor |
accept_marketing | boolean | Campo de aceitar receber mensagens de marketing |
updated_at | timestamp | Data da ultima atualização desse registro |
created_at | timestamp | Data da criação desse registro |
last_name | string | Ultimo nome |
address_id | string | ID do endereço cadastrado |
phone_country_code | string | Código do país do telefone |
phone_area_code | string | Código de área do telefone |
phone_number | string | Número do telefone |
business_name | string | Nome da empresa informado |
business_document | string | CNPJ da empresa informado |
birth_date | string | Data de nascimento do consumidor (texto), quando informada |
