数据面板

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

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

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

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

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

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

1. 以 admin 身份登录 web 界面后，点击左侧边栏的“数据面板”功能，点击界面中的“初始化”按键。

2. 对于 2.00.11 及之后版本，需在节点的配置文件中增加以下配置，然后重启集群，即完成初始化。

   • 如果是单节点模式部署，配置文件为 dolphindb.cfg
   • 如果是集群模式部署，配置文件为 controller.cfg
   • 如果是高可用集群模式部署，需要修改所有控制节点对应的 controller.cfg

   thirdPartyCreateUserCallback=dashboard_grant_functionviews
   thirdPartyDeleteUserCallback=dashboard_delete_user

3. 对于 2.00.11 之前的版本，无需其他初始化步骤。但必须注意：2.00.11 之前的版本，初始化后创建用户时，需要管理员手动调用以下命令，才可为新创建的用户赋权使用 Dashboard。如果将来 server 升级为 2.00.11及之后版本，需要执行一次步骤2。

   dashboard_grant_functionviews(<newUserName>, NULL, false)

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

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

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

1. 面板切换：在本节点的不同数据面板间切换。

2. 回到主界面：返回数据面板主界面。

3. 新增：创建一个空面板。

4. 保存：保存当前面板。

5. 导出：将本面板的相关配置信息以 json 文件的格式保存。

6. 创建副本：创建一个当前面板的副本。

7. 导入：将包含面板配置信息的 json文件 导入从而实现面板导入。

8. 修改名称：更改当前面板的名称。

9. 分享：将当前面板通过链接的形式分享给其他用户。分享前应确保最新改动已经保存。

10. 删除：删除当前面板。

11. 模式切换：切换编辑模式和预览模式。

12. 变量：由当前用户的变量，以供数据源和图表展示使用。

13. 数据源：设置当前用户的数据源，以供图表展示使用。

14. 图表列表：可供用户选用的所有图表。

15. 面板工作区：用户可在此编排图表。

16. 图表配置区：选中面板工作区的某一图表后才会显示，用于配置当前图表的信息。

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

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

删除：删除当前变量。

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

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

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

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

当变量类型为单选或多选时，可以通过 SQL 导入的方式生成可选值。SQL 必须返回一个包含两列的表，第一列作为标签，第二列作为值。

数据源可以选择 “表格” 和 “矩阵“ 两种数据类型。其中矩阵仅可作为热力图的数据源，可通过 DolphinDB SQL 编辑数据源；而”表格“可以选择“DolphinDB SQL”或“流数据” 两种方式编辑。

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

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

删除：删除当前数据源。

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

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

• 如需通过变量灵活配置，可以点击插入变量实现；

• 自动刷新可以及时获取最新信息；

• 最大行数将展示结果的前n条数据，若不设置最大行数，则默认展示所有数据。

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

• 点选某个流表时，右侧会展示列名预览。

• 下方“IP 端口”展示当前连接的节点。

• 过滤分为列过滤和表达式过滤。列过滤需要在 DolphinDB 客户端配合函数 setStreamTableFilterColumn 指定过滤列；表达式过滤直接设置条件表达式，不符合条件的数据将被过滤掉，例如 colName==3

• 最大行数将展示结果的前n条数据，若不设置最大行数，则默认展示所有数据。

数据面板提供了柱状图、折线图、饼图、表格、K线、混合图、订单图、富文本、描述表、编辑器、仪表盘、雷达图、变量、散点图、热力图等 15 个图供用户选择，其中柱状图、折线图、多源图、散点图、混合图支持进行阈值设置。可以通过”阈值类型“选项将阈值设置为百分比或绝对值两种类型，其中百分比是指相对于该轴当前的最大值。展示类型包括以下三种选项：

• 不展示：隐藏阈值。

• 区域填充：将当前阈值到大于此阈值的最小阈值之间的区域填充为其对应的颜色。例如，设置阈值 20% 为绿色，阈值 80% 为红色，则 20%-80%之间填充为绿色，80%以上填充为红色。

• 线条：通过一条线来标识区域的下边界。线条的类型、线宽和颜色允许多种选择。例如，设置阈值 20% 为绿色，阈值 80% 为红色，则 20% 处有一条绿色线，80% 处有一条红色线。

各图表的效果展示图详见附录。

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

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

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

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

1. 点击页面上方中央的编辑按键，切换到编辑模式。

2. 点击 ”变量” ->”新建” ，将新变量命名为“频率”：

   • 显示名称设置为“K线频率”，
   • 变量类型设置为“单选”，
   • 可选项新增5项，标签依次为“1分钟”、“5分钟”、“15分钟”、“30分钟”、“1小时”，其对应的值分别为”m1_“、”m5_“、”m15_“、”m30_“、”m60_“，
   • 变量值可任选一个，例如“1分钟”。

3. 点击 “保存”。

   

1. 点击 ”变量” ->”新建” ，将新变量命名为“symbol”：

2. 显示名称设置为“债券名称”，

3. 变量类型设置为“自由文本”，

4. 变量值可设置为流表中SECURITYID的任一取值，例如 230210

5. 点击 ”保存”。

   

点击 “数据源”->”新建”，将新数据源命名为“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 ，点击“保存”。

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

• 基本属性：

  • 标题设置为“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线" 。

• 每行变量数：图中每行最多展示的变量数上限

• 查询按钮：是否设置一个查询按钮，每当更改变量后，需要点击查询按钮生效

• 按钮文案：上述按钮可展示为其他名称

最终K线图的展示效果如下图所示：