使用DataV展示表格存储数据 - 表格存储

通过DataV控制台添加表格存储数据源后，您可以使用DataV可视化展现表格存储的数据。

前提条件

在访问控制RAM服务侧完成如下操作：
- 已创建RAM用户并为RAM用户授予管理表格存储权限（AliyunOTSFullAccess）和管理DataV权限（AliyunDataVFullAccess）。具体操作，请参见创建RAM用户和为RAM用户授权。
  警告
  阿里云账号AccessKey泄露会威胁您所有资源的安全。建议您使用RAM用户AccessKey进行操作，可以有效降低AccessKey泄露的风险。
- 已为RAM用户创建AccessKey。具体操作，请参见创建AccessKey。
在表格存储服务侧已完成如下操作：
- 已开通表格存储服务并创建实例。具体操作，请参见开通表格存储服务和创建实例。
- 已创建数据表。具体操作，请参见数据表操作。
在DataV服务侧完成如下操作：
开通DataV服务。具体操作，请参见开通DataV服务。

背景信息

DataV数据可视化（简称DataV）可以将数据由单一的数字转化为各种动态的可视化图表。更多信息，请参见DataV数据可视化。表格存储的表数据接入DataV后，DataV可以根据表数据生成数据看板，将数据实时展示给需要的用户。

注意事项

此功能只适用于宽表模型。更多信息，请参见宽表模型。
数据源仅支持表格存储数据表或者二级索引表。

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

登录DataV控制台。
在我的数据页签中选择数据源管理，单击添加数据。
在类型列表中，选择TableStore。

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

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

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

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

登录DataV控制台。
在我的可视化页面，根据实际场景创建可视化项目或者直接选择可视化项目进行操作
- 如果使用已有可视化项目，请将鼠标移动到需要使用的可视化项目上，单击编辑即可。
- 如果是首次使用或者已有可视化项目不满足使用需求，请为可视化应用创建项目。
  说明
  系统支持PC端创建、移动端创建以及识图创建三种方式，此处以PC端创建为例介绍。
  1. 单击PC端创建。
  2. 在PC端的模板列表中，选择一个模板，单击创建项目。
    DataV支持基于模板或者使用空白画布制作可视化应用，请根据实际选择。
  3. 在创建数据大屏对话框，填写数据大屏名称以及选择大屏分组，单击创建。

配置表格存储数据源。

在画布编辑页面，单击画布中的某个组件。
说明
如果画布中无组件，请先添加组件。具体操作，请参见添加资产。
在画布右侧的组件配置面板中，单击图标。
在数据页签，单击配置数据源。
在设置数据源模块中，选择数据源类型为TableStore。
在选择已有数据源列表中，选择配置完成的TableStore数据源。
在选择操作列表中，选择需要的操作。
系统支持以下三种操作：
- getRow：对应TableStore的GetRow API，详情请参见GetRow API 参考。
- getRange：对应TableStore的GetRange API，详情请参见GetRange API 参考。
- SQL：SQL查询操作。

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

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

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

预览和发布数据看板。
1. 单击画布编辑器右上角的图标，预览可视化应用。
2. 单击画布编辑器右上角的图标，发布数据看板。
  1. 在发布对话框，单击发布大屏。
  2. 关闭发布成功的对话框。
    说明
    发布成功后，发布页内容已锁定，每次编辑后可通过“快照管理”快速同步发布内容。您也可以单击前往快照管理，查看已创建的快照信息。
  3. 单击分享链接对应链接右侧的图标，复制链接。
  4. 打开浏览器，将复制的链接粘贴到地址栏中，即可在线观看发布成功的数据看板。