对接DataV

注意事项

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

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

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

1. 登录DataV控制台。

2. 在工作台页面，选择左侧导航栏的功能导航模块，单击数据准备>数据源。

3. 在数据源页面，单击新建数据源。

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

      

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

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

4. 单击确定。

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

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

1. 登录DataV控制台。

2. 在工作台页面中，将鼠标移动至需要编辑的数据看板上，单击编辑。

   重要

   如果您的工作台页面内还没有创建任何数据看板，请先创建一个数据看板。更多信息，请参见使用模板创建PC端看板。

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

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

      说明

      如果画布中还没有组件，请先在画布左侧组件库页签添加组件。更多信息，请参见组件画布操作。

   2. 在画布右侧的组件配置面板中选择数据源。

      

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

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

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

      系统支持以下三种操作：

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

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

      • SQL：SQL查询操作。

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

      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语句查询所需数据。

   7. 单击查看数据返回结果，查看数据返回结果。

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

   1. 单击画布编辑器右上角的预览，预览数据看板。

      

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

      

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

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

         说明

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

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

      

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

计费信息

常见问题

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

相关文档

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