Superset官網地址: http://airbnb.io/projects/superset/
Superset官方文檔:https://superset.incubator.apache.org/installation.html
安裝步驟:
一. 安裝Python建議安裝Python 3.4 以上版本。Python 2.7 版本在windows 上存在各種編碼問題
Python 下載地址:https://www.python.org/downloads/release/python-350/
下載Windows x86-64 executable installe。直接使用exe的安裝包即可
安裝過程中選中增加到環境變量。
檢查:CMD下 分別運行python -V 和 pip-V。如果找不到命令,則需要添加python的安裝目錄到path環境變量下。
二.安裝virtualenv
1.此步驟可選,直接安裝的話跳到第四步。因為Superset需要安裝的組件較多,最好是使用virtualenv獨立一套python環境
2. 在開發Python應用程序的時候,系統安裝的Python3只有一個版本。所有第三方的包都會被pip
安裝到Python3的site-packages
目錄下。
3.安裝命令:pip install virtualenv
4.使用virtualenv先在D盤建立d:\python\myproject 目錄。
//然后激活 cd d:\python\myproject virtualenv env //等待初始化完成... //激活: env\Scripts\activate
激活后界面命令行有env標識,后續操作也可在env中生效,不會影響整體Python環境。
三.安裝VS2015。
Superset中依賴的一些庫需要使用microsoft visual c++ 2010編譯。
根據官方文檔也可以安裝:Visual C++ 2015 Build
四.Python’s setup tools and pip(可省略)
pip3 install superset --upgrade
獲取最新的setuptools 與 pip庫
五.安裝sasl。
安裝SuperSet報錯(sasl.h 找不到)
解決辦法是:通過 http://www.lfd.uci.edu/~gohlke/pythonlibs/#sasl下載
比如:安裝的python 是3.6版本,系統是64位,就下載
我文件下載到D:\Downloads
pip install D:\Downloads\sasl-0.2.1-cp35-cp35m-win_amd64.whl
六.開始安裝superset。
pip install superset # 創建管理員帳號 fabmanager create-admin --app superset # 初始化數據庫 (windows下,先進入到 Python安裝目錄(或者virtualEnv的虛擬目錄)下,libs\site-packages\superset\bin下) Python superset db upgrade # 加載例子(后續操作都需要在libs\site-packages\superset\bin下) Python superset load_examples # 初始化角色和權限 Python superset init # 啟動服務,端口 8088, 使用 -p 更改端口號。 Python superset runserver -d
然后使用瀏覽器,打開localhost:8088即可看到登錄頁面。
七.Superset國際化處理
官方漢化下載https://github.com/apache/incubator-superset/tree/master/superset/translations
下載下來直接丟到superset目錄下。
修改superset目錄下config.py文件
說明:BABEL_DEFAULT_LOCALE設置默認的本地化環境
LANGUAGES:國際化的語言種類,你可以把注釋全放開,這樣就可以根據不同的語言環進行本地化,若要只提供一種語言,那么就可以放開你要使用的語言,而把其它的語言注釋掉。
如果translations文件夾里沒有messages.mo文件需要messages.po編譯
在終端中將目錄切換到superset/目錄下
執行如下命令:pybabel compile -d translations
注意:要對translations目錄及其子目錄有寫入權限
修改重啟superset即可。
八.數據源。
Superset默認使用sqllite。支持以下數據庫:
使用pip安裝好數據庫后,就可以在Web界面中,配置相關數據源了。
此JSON字符串包含額外的配置元素。該engine_params 對象被解壓縮到 sqlalchemy.create_engine調用中,而將其metadata_params解壓縮到 sqlalchemy.MetaData調用中。有關更多信息,請參閱SQLAlchemy文檔。
數據庫的連接字符串格式參見: http://docs.sqlalchemy.org/en/rel_1_0/core/engines.html#database-urls
安裝問題:
- 當在安裝superSet出現
是因為沒有安裝Visual C++ 2015 Build
2.Failed building wheel for sasl error: Microsoft Visual C++ 10.0 is required. Get it with "Microsoft Windows SDK 7.1":
這個錯誤是因為sasl的安裝需要C++編譯,可參考第五步
3.“module" object has no attribute 'SIGALRM'錯誤:
這是在建立database后,執行sql query報錯。
在編輯database的時候,Expose in SQL Lab和Allow Run Sync都要勾選上,下面其余的不要勾選,保留這兩個就好了。在勾選完Expose in SQL Lab和Allow Run Sync后,windows用戶可能會出現上面的一些錯誤。這是windows下依賴包不兼容產生的。Python的signal包只作用於linux和mac,在win是不啟作用的,所以這一塊在win會產生沖突於是報錯。
把signal所在行都注釋,下面再加一個pass就好了,文件在superset/utils.py.
4.配置Oracle數據源會有報 twophase' is an invalid keyword
cx_Oracle 6.0b1是beta版,建議使用5.3的官方版本。
pip uninstall cx_Oracle 卸載當前pypi
pip install cx_Oracle==5.3指定版本5.3
如果報error: Microsoft Visual C++ 14.0 is required
http://www.lfd.uci.edu/~gohlke/pythonlibs/#cx_oracle下載相應的pypi
可參考第五步