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(可省略)
获取最新的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.