Superset的基本使用包括添加数据库、配置数据集、创建图表、创建看板.至此可以实现数据可视化.其它功能如用户管理、角色管理等功能用于管理登录用户和用户的角色权限配置,接下来以MySql为数据源,实现整个配置流程
1.配置数据库
数据图形化展示首先需要配置数据源,以MySql为例:
数据库格式为:mysql://<UserName>:<DBPassword>@<Database Host>/<Database Name>
例如: mysql://root:123456@127.0.0.1/test
更多数据库配置参考 官方文档
配置Mysql出现报错:ERROR: 无法加载数据库驱动程序:MySQLEngineSpec
需要安装mysqlclient包:pip install mysqlclient
如果出现以下报错,需要安装 mysql-devel,执行 yum install mysql-devel
Preparing metadata (setup.py) ... error
error: subprocess-exited-with-error
× python setup.py egg_info did not run successfully.
│ exit code: 1
╰─> [16 lines of output]
/bin/sh: line 1: mysql_config: command not found
/bin/sh: line 1: mariadb_config: command not found
/bin/sh: line 1: mysql_config: command not found
Traceback (most recent call last):
File "<string>", line 36, in <module>
File "<pip-setuptools-caller>", line 34, in <module>
File "/tmp/pip-install-cctgiluc/mysqlclient_0b982625181c4cc8a81784cb32b821f3/setup.py", line 15, in <module>
metadata, options = get_config()
File "/tmp/pip-install-cctgiluc/mysqlclient_0b982625181c4cc8a81784cb32b821f3/setup_posix.py", line 70, in get_config
libs = mysql_config("libs")
File "/tmp/pip-install-cctgiluc/mysqlclient_0b982625181c4cc8a81784cb32b821f3/setup_posix.py", line 31, in mysql_config
raise OSError("{} not found".format(_mysql_config_path))
OSError: mysql_config not found
mysql_config --version
mariadb_config --version
mysql_config --libs
[end of output]
note: This error originates from a subprocess, and is likely not a problem with pip.
error: metadata-generation-failed
× Encountered error while generating package metadata.
╰─> See above for output.
在数据库页面点击添加数据库,填写配置后,点击测试连接,提示连接测试成功,说明连接上了数据库,点击保存新建数据库记录
2.添加数据集
在数据集页面中点击创建按钮,弹出添加数据集弹窗
数据源:选择上一步配置的数据库
模式:选择数据库名
表:选择要添加的数据表
点击保存添加数据集记录
3.创建图表
3.1 图表管理页面创建
在图表页面,点击创建图表按钮,进入新建图表页面
选择数据集,图表类型后,点击创建新图表
图表页面如下
具体的操作区域如下:
1.图表配置:
可视化类型:切换图表类型
时间区域:列举了类型为时间的列,根据选择的时间粒度和时间范围,配置时间过滤条件
查询区域:配置查询条件,当类型为聚合类型时,查询指标数据,指标对应某个聚合函数;当类型为列查询时,可以选择多列查询,列查询可以添加行限制及过滤条件
不同图表类型在操作上会有差异,具体可以自行体会
2.查询结果展示
页面右侧为图表展示区域,通过点击查询按钮刷新图表内容
3.功能区:
右上角功能区可以执行的操作如下:
复制图表链接:用于通过链接分享图表
发送邮件:通过邮件分享图表
内嵌代码:提供iframe代码块,用于在第三方页面内嵌图表
导出json:以json格式导出数据
导出csv:以csv格式导出图表数据
检查查询:显示当前图表的查询Sql语句
在SQL工具箱中执行:跳转到SQL工具箱页面,并执行图表的Sql语句
下载为图表:将图表以图片的形式下载
配置好图表后,点击保存按钮,填写图表名称后点击保存,就可以生成图表,如果选择添加看板,可以将图表添加到已有看板或者新建看板存放图表
3.2数据集页面快速创建图表
在数据集页面点击数据集名称快速创建图表
4.创建看板
看板由图表排列而成,可以调整图表占用的长宽,通过行和列组件自定义排列的位置,以及添加Tab、标题、Markdown等组件丰富展示格式
在看板页面点击新建看板
看板页面可以选择组件,拖拽图表
1.Tabs组件
用于实现Tab点击切换页面
首先点击Tabs组件拖拽到看板内容区
对Tab页命名,拖拽图表到第一个Tab中
以同样的方式扩展第二个Tab,并设置第二张图表
这样就实现了通过Tab切换页面
2.行组件
行组件用于图表分行展示
首先拖拽两次行组件到看板内容区
分别往两行中拖拽添加图表,可以得到图表分行的效果
3.列组件
列组件同理,将图表以列的方式垂直排列
首先往看板内容区域拖拽两列
分别将两张图表拖拽到列中
行组件和列组件可以嵌套使用,以便更灵活的排列图表
4.标题行
标题行用于自定义标题,可以设置文字大小以及样式
5.Markdown
Markdown组件支持markdown标记语言,可以简单生成格式化元素
Markdown写法可以参考 Markdown语法
6.分隔组件用于生成分割线
看板功能区包含了对看板的额外操作
另存为:将看板另存为新的看板
复制看板链接:以链接的形式分享看板
邮件分享看板:以邮件的形式分享看板
刷新看板:对看板的每个图表执行刷新操作,重新查询数据并展示
设置自动刷新:设置间隔时间自动刷新看板
下载为图片:将看板以图片的形式下载
切换全屏:全屏显示看板
5.SQL工具箱
SQL工具箱用于编辑Sql,查询数据,展示历史查询信息
在SQL编辑器页面,左侧为数据集及列信息,右侧为编辑Sql和展示查询结果,提供了保存查询的功能
历史查询页面展示查询执行Sql的历史记录
6.用户及角色管理
用户管理功能主要对系统用户进行管理,包括创建、编辑、配置用户是否激活,通过配置角色的方式管理用户权限
用户管理页面如下:
创建用户页面填写用户信息,并配置角色
角色管理页面如下:
编辑角色权限时,权限的格式为 can 操作类型 权限名
比如 can read on Dataset表示查询数据集的权限,can write on Dataset表示编辑数据集的权限