如何构建SQLAlchemy URI以连接MySQL数据库与Superset

阿华AIGC实验室

2026-5-11

如何构建Superset连接MySQL的SQLAlchemy URI？

嘿，我来帮你搞定这个连接URI的问题～首先得明确SQLAlchemy连接MySQL的基础格式，再结合你用Docker部署的两种MySQL环境，分情况给你拆解：

基础格式回顾

SQLAlchemy连接MySQL的标准URI格式是：

mysql+pymysql://<用户名>:<密码>@<主机/容器名>:<端口>/<数据库名>?<可选参数>

这里pymysql是Python的MySQL驱动，官方Superset镜像一般已经预装了，如果没有的话，进Superset容器补装一下就行：docker exec -it <superset容器名> pip install pymysql

情况1：连接你`stack.yml`里的MySQL服务

这个MySQL和Adminer在同一个Docker Compose网络里，Superset是另一个独立的Compose项目，得先解决网络互通问题，再写URI：

方式A：让Superset加入MySQL的Compose网络

先查一下stack.yml启动的网络名称：执行docker network ls，找名字类似你的项目目录名_default的网络

启动Superset时，指定加入这个网络：

docker-compose --network <上面查到的网络名> up

这时候就能直接用MySQL的服务名db来访问，对应的URI是：
```
mysql+pymysql://root:example@db:3306/mysql?charset=utf8mb4
```
👉 说明：root是MySQL默认超级用户，example是你stack.yml里设置的密码，mysql是MySQL默认自带的数据库，你也可以换成自己在Adminer里创建的数据库名

方式B：通过主机IP访问（需要映射MySQL端口）

如果不想改网络配置，就把MySQL的3306端口映射到主机：

修改stack.yml，给db服务加上端口映射：

services:
  db:
    image: mysql
    command: --default-authentication-plugin=mysql_native_password
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: example
    ports:
      - 3306:3306  # 新增这一行

重启stack服务：docker-compose -f stack.yml down && docker-compose -f stack.yml up -d
用主机的内部地址host.docker.internal（Docker官方提供的主机别名，Linux/Windows/macOS通用）来写URI：
```
mysql+pymysql://root:example@host.docker.internal:3306/mysql?charset=utf8mb4
```

情况2：连接你单独启动的`some-mysql`容器

这个容器是你用docker run单独启动的，同样分两种网络访问方式：

方式A：通过共享Docker网络访问

先创建一个共享网络：docker network create shared-mysql-network
把some-mysql容器加入这个网络：docker network connect shared-mysql-network some-mysql
启动Superset时加入同一个网络：docker-compose --network shared-mysql-network up
对应的URI是：
```
mysql+pymysql://root:my-secret-pw@some-mysql:3306/mysql?charset=utf8mb4
```
👉 说明：my-secret-pw是你启动容器时设置的密码，some-mysql是容器名

方式B：通过主机映射端口访问

如果不想折腾网络，就重新启动容器时映射端口：

先停掉旧容器：docker stop some-mysql && docker rm some-mysql

重新启动并映射端口：

docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -p 3306:3306 -d mysql:tag

同样用host.docker.internal写URI：

mysql+pymysql://root:my-secret-pw@host.docker.internal:3306/mysql?charset=utf8mb4

额外小提示

如果你用的是MySQL 8.0+，记得启动容器时加上--default-authentication-plugin=mysql_native_password参数（你stack.yml里已经加了，单独启动的容器也要加上），避免因为认证插件不兼容导致连接失败
建议先通过Adminer（localhost:8080）登录MySQL，创建一个专门给Superset用的数据库（比如superset_db），然后把URI里的mysql换成这个新数据库名，更规范

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