跳到主要内容
版本：Nightly

Superset

Apache Superset 是开源的 BI 工具，用 Python 编写。 以下内容可以帮助你把 GreptimeDB 作为 Superset 的数据源。

安装​

用 Docker Compose 运行 Superset​

Docker compose 是本地试用 Superset 最快的方式。上游明确表示不支持也不建议将 docker compose 用于生产环境，因此请仅将其用于评估。在这种运行方式下，需要在 Superset 代码目录下的 docker/ 中添加一个 requirements-local.txt。

并将 GreptimeDB 依赖加入到 requirements-local.txt:

greptimedb-sqlalchemy

启动 Supertset 服务：

docker compose -f docker-compose-non-dev.yml up

本地运行 Superset​

假如你通过 Pypi 包安装和运行 Superset，需要将 GreptimeDB 的依赖安装到相同的 Python 环境。

pip install greptimedb-sqlalchemy
SQLAlchemy 版本

greptimedb-sqlalchemy 要求 sqlalchemy>=1.4,<2。当前发行版 Superset 6.1.0 锁定 SQLAlchemy 1.4.54，两者可以配合使用。Superset 主分支已升级到 SQLAlchemy 2.0，后续 版本需要 dialect 先支持 2.0。若使用更早的 Superset，请自行核对其锁定的 SQLAlchemy 版本是否落在上述范围内。

添加 GreptimeDB 数据库​

准备添加，选择 设置 / 数据库连接.

添加数据库，并在支持的数据库列表中选择 GreptimeDB。

根据 SQLAlchemy URI 的规范，填写以下格式的数据库连接地址。

greptimedb://<username>:<password>@<host>:<port>/<database>
  • 如果没有启动认证，可以忽略 <username>:<password>@ 部分。
  • 默认端口 4003 （我们用 PostgresSQL 协议通信）。
  • 默认数据库 public。如果是使用 GreptimeCloud 实例，可以从控制台复制数据库名称。