对接DataV-Board 6.0

注意事项

• 此功能只适用于宽表模型 。更多信息，请参见宽表模型。

• 数据源仅支持表格存储数据表或者二级索引表。

步骤一：添加表格存储数据源

1. 登录DataV控制台。

2. 可选：在页面右上角，单击返回旧版。

   说明

   • 若您已进入旧版配置页（页面右上角的按钮为进入新版），则无需执行此操作。

   • 新版配置页和旧版配置页部分参数有差异，建议使用新版配置页。更多信息，请参见对接DataV-Board 7.0。

3. 在我的数据页签中选择数据源管理，单击添加数据。

4. 在类型列表中，选择TableStore。

   填写 名称、AK ID、AK Secret 和 外网 地址，然后单击 确定。

5. 配置表格存储相关信息，详细参数说明请参见下表。

   参数	说明
   名称	数据源的显示名称。
   AK ID	拥有表格存储访问权限的阿里云账号或者RAM用户的AccessKey ID。
   AK Secret	拥有表格存储访问权限的阿里云账号或者RAM用户的AccessKey Secret。
   外网	表格存储实例的服务地址，请根据访问的表格存储实例填写。更多信息，请参见服务地址。

6. 单击确定。

   添加的数据源会自动显示在数据源列表中。

步骤二：配置表格存储数据源

1. 登录DataV控制台。

2. 可选：在页面右上角，单击返回旧版。

   说明

   • 若您已进入旧版配置页（页面右上角的按钮为进入新版），则无需执行此操作。

   • 新版配置页和旧版配置页部分参数有差异，建议使用新版配置页。更多信息，请参见对接DataV-Board 7.0。

3. 在我的可视化页面，根据实际场景创建可视化项目或者直接选择可视化项目进行操作

   • 如果使用已有可视化项目，请将鼠标移动到需要使用的可视化项目上，单击编辑即可。选择目标可视化项目后，单击项目卡片中的编辑按钮进入项目编辑页面。

   • 如果是首次使用或者已有可视化项目不满足使用需求，请为可视化应用创建项目。

     说明

     系统支持PC端创建、移动端创建以及识图创建三种方式，此处以PC端创建为例介绍。

     1. 单击PC端创建。

     2. 在PC端的模板列表中，选择一个模板，单击创建项目。

        DataV支持基于模板或者使用空白画布制作可视化应用，请根据实际选择。

     3. 在创建数据大屏对话框，填写数据大屏名称以及选择大屏分组，单击创建。

4. 配置表格存储数据源。

   1. 在画布编辑页面，单击画布中的某个组件。

      说明

      如果画布中无组件，请先添加组件。具体操作，请参见资产管理（企业版）。

   2. 在画布右侧的组件配置面板中，单击图标。

   3. 在数据页签，单击配置数据源。

   4. 在设置数据源模块中，选择数据源类型为TableStore。

   5. 在选择已有数据源列表中，选择配置完成的TableStore数据源。

   6. 在选择操作列表中，选择需要的操作。

      系统支持以下三种操作：

      • getRow：对应TableStore的GetRow API，详情请参见GetRow API 参考。

      • getRange：对应TableStore的GetRange API，详情请参见GetRange API 参考。

      • SQL：SQL查询操作。

   7. 在选择操作编辑框中输入查询语句。

      getRow

      • 查询参数必须为JSON对象。

      • 选择getRow操作时，需要根据指定的主键读取单行数据。

        参数格式如下。

        {
            "table_name": "test",
            "rows": {
                "id": 1,
                "pk": "1",
            },
            "columns": [
                "id",
                "pk",
                "test"
            ]
        }

        参数	说明
        table_name	待查询TableStore的表名称。
        rows	行的主键。 重要 当表中存在多个主键列时，设置的主键列个数与数据类型必须和数据表的主键列个数与数据类型一致。
        columns	填写需要返回的列名。

      getRange

      • 查询参数必须为JSON对象。

      • 选择getRange操作，可读取指定主键范围内的数据，参数格式如下。

        {
            "table_name": "test",
            "direction": "FORWARD",
            "columns": [
                "id",
                "test"
            ],
            "range": {
                "limit": 4,
                "start": {
                    "id": "InfMin"
                },
                "end": {
                    "id": "3"
                }
            }
        }

        参数	说明
        table_name	待查询TableStore的表名称。
        direction	读取方向。 如果值为正序（FORWARD），则起始主键必须小于结束主键，返回的行按照主键由小到大的顺序进行排列。 如果值为逆序（BACKWARD），则起始主键必须大于结束主键，返回的行按照主键由大到小的顺序进行排列。 例如同一表中有两个主键A和B，A<B。如正序读取[A, B)，则按从A至B的顺序返回主键大于等于A、小于B的行；逆序读取[B, A)，则按从B至A的顺序返回大于A、小于等于B的数据。
        columns	读取的列集合，列名可以是主键列或属性列。 如果不设置返回的列名，则返回整行数据。 如果某行数据的主键属于读取范围，但是该行数据不包含指定返回的列，那么返回结果中不包含该行数据。
        limit	数据的最大返回行数，此值必须大于0。 表格存储按照正序或者逆序返回指定的最大返回行数后即结束该操作的执行，即使该区间内仍有未返回的数据。
        start	本次范围读取的起始主键和结束主键，起始主键和结束主键需要是有效的主键或者是由InfMin和InfMax类型组成的虚拟点，虚拟点的列数必须与主键相同。 其中InfMin表示无限小，任何类型的值都比它大；InfMax表示无限大，任何类型的值都比它小。 重要 当表中存在多个主键列时，设置的主键列个数与数据类型必须和数据表的主键列个数与数据类型一致。 start表示起始主键，如果该行存在，则返回结果中一定会包含此行。 end表示结束主键，无论该行是否存在，返回结果中都不会包含此行。
        end

      SQL

      通过自定义SQL语句查询所需数据。

   8. 单击预览数据返回结果，查看数据返回结果。

5. 预览和发布数据看板。

   1. 单击画布编辑器右上角的图标，预览可视化应用。

   2. 单击画布编辑器右上角的图标，发布数据看板。

      1. 在发布对话框，单击发布大屏。

      2. 关闭发布成功的对话框。

         说明

         发布成功后，发布页内容已锁定，每次编辑后可通过“快照管理”快速同步发布内容。您也可以单击前往快照管理，查看已创建的快照信息。

      3. 单击分享链接对应链接右侧的图标，复制链接。

         该操作在发布面板的分享链接标签页中完成，链接格式为 https://datav.aliyuncs.com/share/xxx。

      4. 打开浏览器，将复制的链接粘贴到地址栏中，即可在线观看发布成功的数据看板。

计费信息

常见问题

使用GetRange接口查询数据时返回指定范围外的数据

相关文档

• 您也可以通过对接Grafana展示数据。如果需要展示时序模型中的时序表数据，请对接Grafana进行数据展示。具体操作，请参见对接Grafana。

• 如果要将DataV-Board 6.0可视化应用迁移到DataV-Board 7.0，您可以通过迁移新版功能实现。具体操作，请参见迁移功能。