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のまとめ
