Guia de Instalação e Configuração

Passo a passo completo e estruturado para você inicializar, configurar banco de dados e conectar o AI Assistant do Apache Superset em ambiente Docker.

1. Instalação do Superset

Processo de pull da imagem e primeira execução local.

Passo 1

Acessar o Docker Desktop garantindo que o motor do Docker esteja rodando.

Passo 2

Acessar o Terminal do Docker (ou o terminal do seu SO com o Docker configurado).

Passo 3

Baixar a imagem do Superset executando o comando abaixo:

docker pull apache/superset:GHA-dev-23964003251
Passo 4

Rodar o Superset criando a sua chave secreta (minha_chave_secreta):

docker run -d -p 8088:8088 -e SUPERSET_SECRET_KEY=minha_chave_secreta --name superset apache/superset:GHA-dev-23964003251
Passo 5

Verificar se o container subiu corretamente:

docker ps

*No arquivo original constava `docker os`, que normalmente se refere a `docker ps` para checar os containers rodando.

Passo 6

Criar o banco de dados e aplicar subida das rodadas de migração:

docker exec -it superset superset db upgrade
Passo 7

Criar o username, senha e email para o perfil de administrador:

docker exec -it superset superset fab create-admin
Passo 8

Inicializar os dados padrão de permissões (roles e permissions):

docker exec -it superset superset init

2. Acesso ao Superset

Como reiniciar e acessar a interface web.

Passo 9

Para ver os containers existentes (mesmo os parados):

docker ps -a
Passo 10

Para iniciar o container do Superset que já foi recém criado:

docker start superset
Passo 11

Acesse o Superset abrindo seu navegador no seguinte link:

http://localhost:8088

3. Instalação e Conexão do Postgres

Subindo um container com Postgres 16 para interagir com os dados.

Passo 12

Instalar e executar o Postgres (na porta 5432):

docker run -d --name superset-db -e POSTGRES_DB=superset_data -e POSTGRES_USER=superset -e POSTGRES_PASSWORD=superset123 -p 5432:5432 postgres:16
Passo 13

Conectar o Postgres no front do Superset. Navegue em Data → Connect Database → Postgres e informe:

  • Host: host.docker.internal
  • Port: 5432
  • Database name: superset_data
  • Username: meu_usuario
  • Password: minha_senha
  • Display Name: Postgres Superset
  • SSL: desligado
  • URI: postgresql+psycopg2://meu_usuario:minha_senha@host.docker.internal:5432/superset_data
Passo 14

Configurações adicionais de Segurança para permitir CSVs:

Navegue em Settings → Database Connections → Edit e ative/ligue a opção: Allow file uploads to database.

Passo 15

Para carregar um CSV no Superset vá em:

+ Data → Upload CSV

Passo 16

Para criar um painel (Dashboard), clique em:

+ Charts

4. Instalação do AI Assistant

Ativando a interface conversacional com a OpenAI API integrada.

Passo 17

Entrar dentro do container iterativamente executando o bash:

docker exec -it superset bash
Passo 18

Acessar o caminho de configuração e criar o arquivo:

touch /app/pythonpath/superset_config.py
Passo 19

Aplicar a configuração editando o arquivo de parâmetros. Use o comando CAT via heredoc. Atenção, troque a chave pela sua!

cat <<EOF > /app/pythonpath/superset_config.py
FEATURE_FLAGS = {
    "ENABLE_CHAT": True,
    "ENABLE_SQLLAB_BACKEND_PERSISTENCE": True,
    "ENABLE_TEMPLATE_PROCESSING": True,
}
SQLLAB_QUERY_ASSISTANT_ENABLED = True
OPENAI_API_KEY = "SUA_CHAVE_AQUI"
EOF
Passo 20

Para verificar se o arquivo foi criado com sucesso no diretório correto:

ls /app/pythonpath/
Passo 21

Instalar a biblioteca `openai` dentro da venv/ambiente python ativo no Superset:

pip install openai
Passo 22

Sair do terminal do container (retornar ao SO):

exit
Passo 23

Reiniciar o superset para as configurações aplicarem:

docker restart superset

Dica extra sobre Retenção/Paradas

Se for necessário interromper o serviço depois:
docker stop superset.

E se precisar rodar novamente do zero usando um volume para persistência de dados local:

docker run -d -p 8088:8088 -e SUPERSET_SECRET_KEY=minha_chave -v superset_home:/app/superset_home --name superset apache/superset:GHA-dev-23964003251