数据面板

数据面板（亦称为 Dashboard）是一个强大的数据可视化和分析工具，旨在帮助用户更好地理解和利用数据。

数据面板在数据分析和资源监控领域具有广泛的应用场景，因为它提供了许多强大功能和优势，包括：

直观的数据可视化：通过各种图表，可以帮助用户将数据转化为可理解的信息，从而能够更深入地了解业务或监控资源。
灵活性和可定制性：提供了多种图表，旨在满足各种行业和用例的需求。用户可以自定义布局、颜色、数据源等，以满足用户的特定需求。
数据互动性：支持用户与数据进行互动，包括筛选、搜索等功能，以便能够深入挖掘信息。
实时数据更新：用户可以通过配置，实现从多个数据源获取实时数据，确保始终处于最新的信息状态。
安全性和权限管理：提供强大的数据安全性和权限管理功能，以确保只有授权用户可以访问敏感信息。

下文将介绍如何创建面板、创建图表、设置数据源、设计可视化、分享面板。无论您是新手还是有相关产品使用经验的用户，本文都将帮助您快速上手以上功能。

基本概念

为便于用户理解，这里列举本文中用到的一些名词概念：

数据面板：主要的工作区，用于组织和显示多个图表。
图表：数据的展示形式。
数据源：DolphinDB 作为数据层，为其提供数据服务。对 DolphinDB 中的对象，如 DFS 表或流数据表的一个查询，就是一个数据源。
变量：用于动态控制仪表板中的查询元素，帮助用户在运行时更改数据源的特定参数，以便更灵活地分析和呈现数据。

权限管理

数据面板的数据来自 DolphinDB ，因此其遵循严格的权限管理。用户只能对自己有权访问的库表或流数据表进行图表展示。有关具体权限规则，参考：用户权限管理。

安装部署

部署

数据面板仅支持 2.00 系列版本，暂不支持 1.30 系列版本。仅支持浏览器语言为中文时使用。

数据面板做 2.00.11 开始内置的 Web 组件，用户在升级到此版本后无需额外部署。

如果 2.00.11 之前版本的用户希望使用此功能，请下载最新版本的安装包，用其中的 server/web/ 目录替换原有的 web。如果 DolphinDB server 是以集群模式部署，需要将每个节点对应的 web 全部替换。其中 web 目录支持热替换，用户无需重启集群。

用户可通过在浏览器中访问 <ip>:<port> 进入 web 界面。这里的 ip 和 port 须指定为数据节点或计算节点。

数据面板位于功能面板中，点击即可进入数据面板页面。

初始化

首次使用时，需要管理员 admin 在数据节点进行初始化。不能由其他用户或在其他节点执行。

以 admin 身份登录 web 界面后，点击左侧边栏的“数据面板”功能，点击界面中的“初始化”按键。
对于 2.00.11 及之后版本，需在节点的配置文件中增加以下配置，然后重启集群，即完成初始化。
- 如果是单节点模式部署，配置文件为 dolphindb.cfg
- 如果是集群模式部署，配置文件为 controller.cfg
- 如果是高可用集群模式部署，需要在 web 的集群总览界面修改 Controller Config
```
thirdPartyCreateUserCallback=dashboard_grant_functionviews
thirdPartyDeleteUserCallback=dashboard_delete_user
```
对于 2.00.11 之前的版本，无需其他初始化步骤。但必须注意：2.00.11 之前的版本，初始化后创建用户时，需要管理员手动调用以下命令，才可为新创建的用户赋权使用 Dashboard。如果将来 server 升级为 2.00.11及之后版本，需要执行一次步骤2。
```
dashboard_grant_functionviews(<newUserName>, NULL, false)
```

基本操作

创建面板

在数据面板界面点击 “新建” ，输入要创建的面板名称，点击确定，可以创建一个空面板。

导出和导入功能：可以对已有面板的进行备份和迁移。导入和导出通过 json 格式文件实现。导入时，请确保 json 文件内容符合数据面板配置要求。

分享功能：可通过链接的方式将面板分享给其他用户。选中面板后点击批量分享，即可获得模板对应的链接。将链接分享给集群中的其他用户，其他用户访问链接后需要先登录自己账号，然后即可进入预览模式，不可编辑。

编辑面板

面板切换：在本节点的不同数据面板间切换。
回到主界面：返回数据面板主界面。
新增：创建一个空面板。
保存：保存当前面板。
导出：将本面板的相关配置信息以 json 文件的格式保存。
创建副本：创建一个当前面板的副本。
导入：将包含面板配置信息的 json文件导入从而实现面板导入。
修改名称：更改当前面板的名称。
分享：将当前面板通过链接的形式分享给其他用户。分享前应确保最新改动已经保存。
删除：删除当前面板。
模式切换：切换编辑模式和预览模式。
变量：由当前用户的变量，以供数据源和图表展示使用。
数据源：设置当前用户的数据源，以供图表展示使用。
图表列表：可供用户选用的所有图表。
面板工作区：用户可在此编排图表。
图表配置区：选中面板工作区的某一图表后才会显示，用于配置当前图表的信息。

编辑变量

新建：为当前数据面板新增变量。

重命名：指为当前变量重命名，变量名显示在左侧。

删除：删除当前变量。

复制：复制当前变量，可在不同数据面板的配置变量界面，通过 ctrl+v 粘贴。

显示名称：指当前变量在图表中显示的名称，如变量symbol，在图表中显示为债券名称。

变量类型：有单选、多选、自由文本、日期四种类型。其中单选和多选需要新增可选项，新增界面会在类型是为单选或多选时显示。

变量值：显示当前的变量值。如果是首次新增，应为变量设置一个初始值。如果是单选变量，在变量值选定为某一可选项后，无法在可选项列表中删除该项。如要删除，需要先修改变量值的选择。

编辑数据源

数据源可以选择“DolphinDB SQL”或“流数据”。

新建：为当前数据面板新增数据源。

重命名：为当前数据源重命名，数据源名称显示在左侧。

删除：删除当前数据源。

复制：复制当前数据源，可在不同数据面板的配置数据源界面，通过 ctrl+v 粘贴。

DolphinDB SQL，在代码区编辑需要查询的内容：

如需通过变量灵活配置，可以点击插入变量实现；
自动刷新可以及时获取最新信息；
最大行数将展示结果的前n条数据，若不设置最大行数，则默认展示所有数据。

流数据，左侧会显示当前节点所有流数据表，用户也可以手动过滤检索，选择需要展示数据的流数据表：

点选某个流表时，右侧会展示列名预览。
下方“IP 端口”展示当前连接的节点。
过滤分为列过滤和表达式过滤。列过滤需要在 DolphinDB 客户端配合函数 setStreamTableFilterColumn 指定过滤列；表达式过滤直接设置条件表达式，不符合条件的数据将被过滤掉，例如 colName==3
最大行数将展示结果的前n条数据，若不设置最大行数，则默认展示所有数据。

选择图表

数据面板提供了柱状图、折线图、饼图、表格、K线、混合图、订单图、富文本、描述表、编辑器、仪表盘、雷达图、变量、散点图等14个图供用户选择。各图表的效果展示图详见附录。

使用时，在左侧图标列表选择要设置的图表，鼠标左键点击将其拖拽至工作区空白处；再点击“点击填充数据源”，选择一个数据源。

点击选中此图表，可按需调整其位置和大小。

图表右上角的复制按键，即可复制当前图表到剪贴板；在当前或其他数据面板通过 ctrl+v 实现粘贴。

注：

如果目标数据面板上没有足够的空间展示，会导致图表之间重叠，需手动拖动调整位置。
如果先复制图，再复制数据源，需要在图表的编辑数据源处重新“应用”一下数据源。

实例演示，使用数据面板展示 K 线图

已知 DolphinDB 当前节点有流表 klineStream 实时接收 K 线数据，klineStream 的表结构如下表所示，列”m1_“、”m5_“、”m15_“、”m30_“、”m60_“前缀分别对应1分钟、5分钟、15分钟、30分钟、60分钟K线，”open“、”high“、”low“、”close“、”volume“分别对应开盘价、最高价、最低价、收盘价和成交量。


name	typeString
createTime	TIMESTAMP
SECURITYID	SYMBOL
m1_open	DOUBLE
m1_high	DOUBLE
m1_low	DOUBLE
m1_close	DOUBLE
m1_volume	LONG
m5_open	DOUBLE
m5_high	DOUBLE
m5_low	DOUBLE
m5_close	DOUBLE
m5_volume	LONG
m15_open	DOUBLE
m15_high	DOUBLE
m15_low	DOUBLE
m15_close	DOUBLE
m15_volume	LONG
m30_open	DOUBLE
m30_high	DOUBLE
m30_low	DOUBLE
m30_close	DOUBLE
m30_volume	LONG
m60_open	DOUBLE
m60_high	DOUBLE
m60_low	DOUBLE
m60_close	DOUBLE
m60_volume	LONG

创建面板

点击 ”新建“，输入新数据面板名称为”K线 “，点击”确定“，创建一个空面板。

配置变量

点击页面上方中央的编辑按键，切换到编辑模式。
点击 ”变量” ->”新建” ，将新变量命名为“频率”：
- 显示名称设置为“K线频率”，
- 变量类型设置为“单选”，
- 可选项新增5项，标签依次为“1分钟”、“5分钟”、“15分钟”、“30分钟”、“1小时”，其对应的值分别为”m1_“、”m5_“、”m15_“、”m30_“、”m60_“，
- 变量值可任选一个，例如“1分钟”。
点击 “保存”。

点击 ”变量” ->”新建” ，将新变量命名为“symbol”：
显示名称设置为“债券名称”，
变量类型设置为“自由文本”，
变量值可设置为流表中SECURITYID的任一取值，例如 230210
点击 ”保存”。

配置数据源

点击 “数据源”->”新建”，将新数据源命名为“K线”，在右侧选择“DolphinDB 脚本/SQL”，输入脚本

select createtime, securityid, decimal32({{频率}}high,4) as high,{{频率}}low as low,{{频率}}close as close,{{频率}}open as open,{{频率}}volume as volume,ma({{频率}}close, 5, 1) as ma5, ma({{频率}}close, 10, 1) as ma10, ma({{频率}}close, 20, 1) as ma20, ma({{频率}}close, 60, 1) as ma60 from klineStream where securityid == '{{symbol}}'

脚本中的 {{频率}} 和 {{symbol}} 通过点击下方的"插入变量"->"频率"和"symbol"，将上步骤中配置的变量插入。

开启自动刷新，并设置间隔时间为 1s，最大行数设置为 150 ，点击“保存”。

配置图表

将左侧的“K线”拖动至面板空白处，点击“点击填充数据源”，选择之前配置的数据源“K线”。
点击图表，在界面右侧配置本图表的各项属性：

基本属性：
- 标题设置为“K线”，并根据需求设置标题字号和内边距等参数，
- 提示框设置为”是“，代表当光标移动到图中某一位置时，是否显示这个一点的数据值，
- X 轴、Y 轴缩略图，代表是否开启缩略轴。这里将 X 轴缩略轴设置为”是“，以便用户通过调整鼠标滚轮显示特定时间窗口的图像。
变量设置：
- 配置数据源时插入了变量“频率”和“symbol”，所以设置关联变量为“频率”和“symbol”。
- 每行变量数表示在图表中，每行展示可调整的变量数，设置为2 。
- 查询按钮设置为“是”。考虑到变量“symbol”是自由文本类型，在文本输入过程中实时刷新查询会占用不必要的资源，所以将此选项设置为“是“，当变量调整完成后点击查询才会结合新的变量做查询。
X轴属性：类型是时间轴，名称是时间，坐标列是 createtime ，时间格式化 HH:mm:ss 。
Y轴属性：
- Y 轴 1：类型是数据轴，名称是 k 线，位置是左侧。
- Y 轴 2：类型是数据轴，名称是交易量，位置是右侧。
数据列：
- 数据列1：OHLC 分别对应表中字段”open“、”high“、”low“、”close“，关联 Y 轴”k线“。
- 数据列2：交易量 volume，关联 Y 轴 ”交易量“。
- 通过点击”增加数据列“依次添加数据列3, 4, 5, 6，分别设置数据列和名称为"ma5"、"ma10"、"ma20"、"ma60"，关联 Y 轴 "k线" 。