Debian 11(Bullseye)にApache SupersetとMariaDBをインストールする

Apache SupersetはPython製のBIツールです。

〇Apache Supersetの画面(Debian 11)

インストール方法

1. 以下のコマンドを実行してMariaDBをインストールします。

sudo apt-get update

sudo apt-get -y install mariadb-server mariadb-client libmariadb-dev

sudo mysql -uroot -e "SET PASSWORD = PASSWORD('root'); FLUSH PRIVILEGES;"

※パスワードは適宜変更してください。

mysql -uroot -proot -e "CREATE DATABASE superset DEFAULT CHARACTER SET utf8mb4;"

mysql -uroot -proot -e "CREATE USER superset@localhost IDENTIFIED BY 'superset';"

※パスワードは適宜変更してください。

mysql -uroot -proot -e "GRANT ALL PRIVILEGES ON superset.* TO 'superset'@'localhost';"

mysql -uroot -proot -e "FLUSH PRIVILEGES;"

2.pipenvのインストール

sudo apt-get -y install python3-pip python3-distutils python3-dev python3-testresources

sudo pip3 install --upgrade setuptools

sudo pip3 install pipenv

echo "export PIPENV_VENV_IN_PROJECT=true" >> ~/.bashrc

echo "export PYTHONPATH=/home/debian/superset" >> ~/.bashrc

※この例ではdebianユーザのホームディレクトリ下のsupersetディレクトリにsuperset_config.pyを配置することを想定しています。適宜パスを変更してください。

source ~/.bashrc

3.Apache Supersetのインストール

sudo apt-get -y install build-essential libssl-dev libffi-dev libsasl2-dev libldap2-dev

mkdir -p ~/superset

cd ~/superset

pipenv --python 3

pipenv install apache-superset

pipenv install PyMySQL

SECRET_KEY=`echo -e "import os; print(os.urandom(24).hex())" | python3`

cat << EOF > superset_config.py
# Superset specific config
ROW_LIMIT = 5000

BABEL_DEFAULT_LOCALE='ja'

SUPERSET_WEBSERVER_PORT = 8088

# Flask App Builder configuration
# Your App secret key
#SECRET_KEY = '\2\1thisismyscretkey\1\2\e\y\y\h'
SECRET_KEY = '#####'

# The SQLAlchemy connection string to your database backend
# This connection defines the path to the database that stores your
# superset metadata (slices, connections, tables, dashboards, ...).
# Note that the connection information to connect to the datasources
# you want to explore are managed directly in the web UI
#SQLALCHEMY_DATABASE_URI = 'sqlite:////path/to/superset.db'
SQLALCHEMY_DATABASE_URI = 'mysql+pymysql://superset:superset@localhost:3306/superset'

# Flask-WTF flag for CSRF
WTF_CSRF_ENABLED = True
# Add endpoints that need to be exempt from CSRF protection
WTF_CSRF_EXEMPT_LIST = []
# A CSRF token that expires in 1 year
WTF_CSRF_TIME_LIMIT = 60 * 60 * 24 * 365

# Set this API key to enable Mapbox visualizations
MAPBOX_API_KEY = ''
EOF

※データベースのパスワードなど、適宜変更してください。

sed -i "s/#####/$SECRET_KEY/" superset_config.py

pipenv shell

superset db upgrade

superset fab create-admin --username admin --firstname admin --lastname user --email admin@localhost.localdomain --password admin

※管理者のユーザ名やパスワードなど適宜変更してください。

superset load_examples

superset init

superset run -h 0.0.0.0 -p 8088 --with-threads --reload

※動作の確認。Ctrl+Cで止めます。

4. サービス化

cat << EOF | sudo tee /etc/systemd/system/superset.service
[Unit]
Description=superset
[Service]
Type=simple
Environment=PYTHONPATH=/home/debian/superset
ExecStart=/home/debian/superset/.venv/bin/superset run -h 0.0.0.0 -p 8088 --with-threads --reload
User=debian
Group=debian
WorkingDirectory=/home/debian/superset
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
EOF

※この例ではdebianユーザでサービスを実行し、supersetをインストールした仮想環境は/home/debian/supersetにあることを想定しています。適宜変更してください。

sudo systemctl enable superset.service

sudo systemctl start superset.service

ブラウザでhttp://<サーバ名またはIPアドレス>:8088/ にアクセスします。adminユーザ、パスワードadminでログインします。

関連情報

・Apache Supersetのインストール方法、ダッシュボードやチャートの作成方法は以下のページを参照してください。
Apache Supersetのまとめ