Laboratório: Dashboard de Vendas do Varejo com Apache Superset e PostgreSQL (modelo bi_varejo)

Roteiro para estudo em ambiente de laboratório ou de teste. Execute apenas em equipamentos, redes e contas que você tenha autorização para usar, com backup e homologação próprios. Comandos podem causar indisponibilidade ou perda de dados. Software e marcas citados pertencem aos seus titulares. Termos de Uso.

Duração estimada

120 min

Passos

12

Validações

5

Versões da documentação consultada

Docker Engine a versão estável atual · PostgreSQL 15 (documentação consultada) · Apache Superset 6.0 (documentação consultada)

Topologia

Uma máquina local (192.168.56.10) roda Docker com dois containers: um PostgreSQL (porta 5432) com o esquema bi_varejo, e um Apache Superset (porta 8088) conectado ao PostgreSQL. O usuário acessa o Superset via navegador. Não há conexão direta com o ERP real.

+---------------------+
|   Usuário/Browser   |
|   (localhost)       |
+---------+-----------+
          |
          | HTTP 8088
+---------v-----------+
| Apache Superset     |
| (Docker, 8088)      |
+---------+-----------+
          |
          | TCP 5432
+---------v-----------+
| PostgreSQL          |
| (Docker, 5432)      |
+---------------------+

Equipamentos e software

Roteiro

1. Preparar ambiente Docker

   Você precisa de Docker e Docker Compose instalados para isolar os serviços. Isso evita conflitos e facilita a limpeza.

   Consulte https://docs.docker.com/get-docker/ para instalar Docker.
   Consulte https://docs.docker.com/compose/install/ para instalar Docker Compose.Copiar

   O que você deve ver: Comando 'docker --version' e 'docker compose version' retornam versões instaladas.

2. Criar diretório de trabalho

   Organize os arquivos do laboratório em uma pasta dedicada.

   mkdir superset_lab && cd superset_labCopiar

   O que você deve ver: Diretório superset_lab criado e acessado.

3. Criar docker-compose.yaml

   Defina os serviços PostgreSQL e Superset no Docker Compose.

   cat > docker-compose.yaml <<EOF
   version: '3.7'
   services:
     postgres:
       image: postgres:15
       environment:
         POSTGRES_USER: superset
         POSTGRES_PASSWORD: superset
         POSTGRES_DB: bi_varejo
       ports:
         - "5432:5432"
       volumes:
         - ./pgdata:/var/lib/postgresql/data
     superset:
       image: apache/superset:6.0.0
       environment:
         SUPERSET_SECRET_KEY: 'ulc_lab_secret'
         SUPERSET_DATABASE_URI: postgresql+psycopg2://superset:superset@postgres:5432/bi_varejo
       ports:
         - "8088:8088"
       depends_on:
         - postgres
       volumes:
         - ./docker/requirements-local.txt:/app/requirements-local.txt
   EOFCopiar

   O que você deve ver: Arquivo docker-compose.yaml criado com dois serviços definidos.

4. Criar requirements-local.txt

   Garanta que o Superset tenha o driver psycopg2 para PostgreSQL.

   mkdir -p docker && echo 'psycopg2-binary' > docker/requirements-local.txtCopiar

   O que você deve ver: Arquivo requirements-local.txt criado com psycopg2-binary listado.

5. Subir os containers

   Inicie os serviços PostgreSQL e Superset juntos.

   docker compose up -dCopiar

   O que você deve ver: Containers postgres e superset em execução. 'docker ps' mostra ambos UP.

6. Inicializar Superset

   Configure o banco de dados interno e crie o usuário admin do Superset.

   docker compose exec superset superset db upgrade
   docker compose exec superset superset fab create-admin --username admin --firstname Admin --lastname ULC --email admin@ulc.local --password admin123
   docker compose exec superset superset initCopiar

   O que você deve ver: Usuário admin criado e Superset inicializado.

7. Popular o PostgreSQL com modelo bi_varejo

   Crie o esquema de estudo e insira dados simulados para vendas, produtos e clientes.

   docker compose exec postgres psql -U superset -d bi_varejo -c "CREATE SCHEMA bi_varejo;"
   # Crie as tabelas conforme modelo didático (exemplo para fato_venda)
   docker compose exec postgres psql -U superset -d bi_varejo -c "CREATE TABLE bi_varejo.fato_venda (id SERIAL PRIMARY KEY, data DATE, id_loja INT, id_cliente INT, valor_total NUMERIC);"
   # Repita para as demais tabelas do modelo didático (fato_venda_item, dim_produto, dim_cliente, dim_loja, dim_campanha). Consulte a documentação do PostgreSQL para sintaxe completa.
   # Insira linhas de exemplo em cada tabela.Copiar

   O que você deve ver: Tabelas criadas no esquema bi_varejo e dados de teste inseridos.

8. Acessar o Superset via navegador

   Abra o Superset em http://localhost:8088 e faça login como admin.

   O que você deve ver: Tela de login do Superset acessível. Dashboard inicial visível após login.

9. Adicionar conexão de banco de dados no Superset

   No Superset, adicione a conexão ao PostgreSQL usando a URI postgresql://superset:superset@postgres:5432/bi_varejo.

   O que você deve ver: Conexão testada e salva. Tabelas do esquema bi_varejo ficam disponíveis.

10. Importar tabelas para o Superset

    No menu Data > Datasets, importe as tabelas do esquema bi_varejo.

    O que você deve ver: Datasets bi_varejo.fato_venda, bi_varejo.dim_produto, etc., disponíveis para consulta.

11. Criar gráfico de vendas por loja

    Monte um gráfico simples (barras ou pizza) mostrando o total de vendas por loja.

    O que você deve ver: Visualização criada e exibida corretamente.

12. Salvar e compartilhar dashboard

    Agrupe visualizações em um dashboard e salve.

    O que você deve ver: Dashboard salvo e acessível pelo menu Dashboards.

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Nunca use senhas padrão em ambientes de produção
• Limite o acesso do usuário de banco a somente leitura para dados importados
• Não exponha as portas 5432 ou 8088 para a internet sem firewall
• Remova dados simulados e containers após o laboratório

Checklist final

• Docker e Docker Compose instalados
• Containers postgres e superset rodando
• Superset acessível via navegador
• Banco bi_varejo com tabelas e dados simulados
• Conexão configurada no Superset
• Dashboard de vendas criado