当前位置：首页 > news >正文

开源的现代数据探索和可视化平台：Apache Superset 从 PyPI 安装 Superset

news 2025/8/5 8:28:35

文中内容仅限技术学习与代码实践参考，市场存在不确定性，技术分析需谨慎验证，不构成任何投资建议。

Apache Superset™ 是一个开源的现代数据探索和可视化平台。对于许多团队来说，Superset 可以取代或增强专有的商业智能工具。Superset 可以与各种数据源很好地集成。

从 PyPI 安装 Superset

本页介绍如何使用发布在 PyPI 上的 apache_superset 包安装 Superset。

操作系统依赖

Superset 将其数据库连接信息存储在元数据数据库中。为此，我们使用 cryptography Python 库来加密连接密码。不幸的是，该库具有操作系统级别的依赖项。

Debian 和 Ubuntu

Ubuntu 24.04 默认使用 python 3.12，Superset 当前尚不支持。您需要添加第二个 python 3.11 安装并安装所需的额外依赖项。

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.11 python3.11-dev python3.11-venv build-essential libssl-dev libffi-dev libsasl2-dev libldap2-dev default-libmysqlclient-dev

在 Ubuntu 20.04 和 22.04 中，以下命令将确保安装所需的依赖项：

sudo apt-get install build-essential libssl-dev libffi-dev python3-dev python3-pip libsasl2-dev libldap2-dev default-libmysqlclient-dev

在 20.04 之前 的 Ubuntu 中，以下命令将确保安装所需的依赖项：

sudo apt-get install build-essential libssl-dev libffi-dev python-dev python-pip libsasl2-dev libldap2-dev default-libmysqlclient-dev

Fedora 和 RHEL 衍生 Linux 发行版

使用 yum 包管理器安装以下包：

sudo yum install gcc gcc-c++ libffi-devel python-devel python-pip python-wheel openssl-devel cyrus-sasl-devel openldap-devel

在较新的 CentOS 和 Fedora 版本中，您可能需要使用 dnf 安装一组略有不同的包：

sudo dnf install gcc gcc-c++ libffi-devel python3-devel python3-pip python3-wheel openssl-devel cyrus-sasl-devel openldap-devel

此外，在 CentOS 上，您可能需要升级 pip 才能使安装生效：

pip3 install --upgrade pip

Mac OS X

如果您未使用最新版本的 OS X，我们建议您升级，因为我们发现许多人遇到的问题与旧版本的 Mac OS X 有关。更新后，安装最新版本的 XCode 命令行工具：

xcode-select --install

我们不建议使用系统安装的 Python。相反，请先安装 homebrew 管理器，然后运行以下命令：

brew install readline pkg-config libffi openssl mysql postgresql@14

您应安装较新版本的 Python。请参阅 pyproject.toml 文件以获取 Superset 官方支持的 Python 版本列表。我们建议使用 Python 版本管理器，如 pyenv（以及 pyenv-virtualenv）。

让我们确保拥有最新版本的 pip 和 setuptools：

pip install --upgrade setuptools pip

最后，您可能需要设置 LDFLAGS 和 CFLAGS 以便某些 Python 包正确构建。您可以使用以下命令导出这些变量：

export LDFLAGS="-L$(brew --prefix openssl)/lib"
export CFLAGS="-I$(brew --prefix openssl)/include"

这些变量现在将在 pip 安装 requirements 时可用。

Python 虚拟环境

我们强烈建议在虚拟环境中安装 Superset。

您可以使用以下命令创建并激活虚拟环境。确保您使用的是兼容的 python 版本。您可能需要显式使用例如 python3.11 而不是 python3。

# virtualenv 在 Python 3.6+ 中作为 venv 而不是 pyvenv 提供。
# 参见 https://docs.python.org/3.6/library/venv.html
python3 -m venv venv
. venv/bin/activate

或使用 pyenv-virtualenv：

# 这里我们将虚拟环境命名为 'superset'
pyenv virtualenv superset
pyenv activate superset

激活虚拟环境后，您安装或卸载的所有 Python 包都将限制在此环境中。您可以通过在命令行上运行 deactivate 来退出环境。

安装并初始化 Superset

首先，安装 apache_superset：

pip install apache_superset

然后，定义必需配置，SECRET_KEY 和 FLASK_APP：

export SUPERSET_SECRET_KEY=YOUR-SECRET-KEY
# 对于生产使用，请确保这是一个强密钥，例如使用 `openssl rand -base64 42` 生成。参见 https://superset.apache.org/docs/configuration/configuring-superset#specifying-a-secret_key
export FLASK_APP=superset

然后，您需要初始化数据库：

superset db upgrade

通过运行以下命令完成安装：

# 在元数据数据库中创建管理员用户（使用 `admin` 作为用户名以便加载示例）
superset fab create-admin# 加载一些数据以供使用
superset load_examples# 创建默认角色和权限
superset init# 要在端口 8088 上启动开发 Web 服务器，请使用 -p 绑定到另一个端口
superset run -p 8088 --with-threads --reload --debugger

如果一切顺利，您应该能够在浏览器中导航到 hostname:port（例如，默认本地为 localhost:8088）并使用您创建的用户名和密码登录。