如何实现Superset数据库连接持久化？解决容器重启配置丢失问题

问题根源 #

你的docker-compose配置存在关键疏漏：Superset默认使用容器内部的SQLite存储元数据（包括dataset、chart、dashboard、数据库连接等），而没有连接到你部署的PostgreSQL服务。容器停止重启时，内部SQLite数据会被销毁，导致所有配置丢失。

修复方案 #

1. 配置Superset连接外部PostgreSQL #

修改superset服务的environment区块，添加元数据库连接参数，让Superset将数据存储到持久化的PostgreSQL中：

services:
  superset:
    # 其他配置保持不变
    environment:
      - ADMIN_USERNAME=admin
      - ADMIN_EMAIL=admin@superset.com
      - ADMIN_PASSWORD=admin
      # 新增以下元数据库连接配置
      - DATABASE_DB=postgres
      - DATABASE_HOST=db
      - DATABASE_USER=postgres
      - DATABASE_PASSWORD=postgres
      - DATABASE_PORT=5432
      - DATABASE_DIALECT=postgresql

• DATABASE_HOST=db：对应docker-compose中PostgreSQL服务的名称，容器间可通过服务名直接通信
• 其余参数需与db服务的环境变量完全匹配

2. 初始化Superset元数据 #

首次部署时，需要在PostgreSQL中创建Superset所需的元数据表：
执行以下命令进入Superset容器并完成初始化：

docker exec -it superset superset db upgrade
docker exec -it superset superset init

如果希望容器启动时自动执行初始化（仅首次部署需要，后续可移除），可以给superset服务添加command：

superset:
  # 其他配置保持不变
  command: >
    sh -c "superset db upgrade && superset init && superset run -h 0.0.0.0 -p 8088 --with-threads --reload"

3. 验证修复效果 #

重启容器后，重新添加数据库连接、dataset等内容，再停止并重启容器，检查所有配置是否正常保留。

重要注意事项 #

• 请勿删除db服务挂载的./db-data目录，该目录存储PostgreSQL的持久化数据，删除会导致所有元数据丢失
• 若PostgreSQL中已有旧数据，执行superset db upgrade可自动迁移元数据schema，无需清空数据库

内容的提问来源于stack exchange，提问作者Sigma