Miniconda安装Superset完整指南

一步步指导您使用Miniconda安装和配置Apache Superset，包含常见问题解决方案

1

安装Miniconda

首先下载并安装Miniconda，这是Anaconda的轻量级版本，适合数据科学和Python环境管理。

# 下载Miniconda安装脚本 (Linux/macOS)
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

# 执行安装脚本 (禁止激活默认base环境)
bash Miniconda3-latest-Linux-x86_64.sh -b -p $HOME/miniconda
echo "auto_activate_base: false" >> ~/.condarc
注意： Windows用户可以从Miniconda官网下载.exe安装包，安装时取消勾选"Add Anaconda to my PATH environment variable"选项。
2

验证Miniconda安装

安装完成后，验证Miniconda是否正确安装并可用。

# 将Miniconda添加到PATH (临时)
export PATH="$HOME/miniconda/bin:$PATH"

# 验证安装
conda --version
python --version
预期输出： 应显示conda和Python的版本号，如conda 23.1.0和Python 3.9.16。
3

创建Python环境

为Superset创建一个独立的Python环境，避免与其他项目产生依赖冲突。

# 创建名为superset的Python 3.9环境
conda create -n superset python=3.9

# 列出所有环境验证创建成功
conda env list
提示： 使用特定Python版本(如3.9)可以避免最新版本可能存在的兼容性问题。
4

激活环境

在安装Superset之前，需要激活刚创建的Python环境。

# 激活superset环境
conda activate superset

# 验证当前环境
which python
python --version
验证： which python应显示路径中包含"miniconda/envs/superset"，Python版本应为3.9.x。
5

安装Apache Superset

使用pip在激活的环境中安装Superset及其依赖项。

# 更新pip
python -m pip install --upgrade pip

# 安装Superset
pip install apache-superset

# 验证安装
superset --version
常见问题： 如果安装失败，可能需要先安装一些系统依赖，如gcc和python-dev。
6

处理安装异常

解决安装过程中可能遇到的常见异常情况。

# C++ 14.0异常解决方案
conda install -c conda-forge cxx-compiler

# MarkupSafe异常解决方案
pip install --upgrade MarkupSafe

# cryptography异常解决方案
conda install -c conda-forge cryptography
提示： 大多数依赖问题可以通过conda-forge渠道安装解决，比pip更可靠。
7

创建Superset管理员

设置Superset的管理员账户，用于登录和管理仪表板。

# 设置FLASK_APP环境变量
export FLASK_APP=superset

# 创建管理员用户
superset fab create-admin

# 按提示输入用户名、姓名、邮箱和密码
安全提示： 使用强密码并妥善保管，这是访问Superset的超级用户账户。
8

Superset初始化

初始化Superset数据库并加载示例数据(可选)。

# 初始化数据库
superset db upgrade

# 加载示例数据 (可选)
superset load_examples

# 初始化角色和权限
superset init
注意： 加载示例数据会占用额外空间，但有助于学习和了解Superset功能。
9

启动Superset

最后一步，启动Superset开发服务器。

# 启动开发服务器
superset run -p 8088 --with-threads --reload --debugger

# 或使用gunicorn生产环境运行
gunicorn --workers 5 --timeout 120 --bind 0.0.0.0:8088 \ "superset.app:create_app()"
访问： 启动后，在浏览器中访问http://localhost:8088，使用之前创建的管理员账户登录。