本文档为您介绍在DataV中添加Table Store数据源的方法及参数配置说明。表格存储(Table Store)是构建在阿里云飞天分布式系统之上的分布式NoSQL数据存储服务。

操作步骤

  1. 登录DataV控制台
  2. 选择我的数据 > 添加数据
  3. 单击类型下拉菜单,选择TableStore
  4. 填写Table Store相关信息。
    添加Table Store数据源
    参数 说明
    名称 数据源的显示名称,您可以自由命名。
    AK ID 拥有Table Store访问权限的账号的AccessKey ID。
    AK Secret 拥有Table Store访问权限的账号的AccessKey Secret。
    外网 Table Store的服务地址,需要根据访问的Table Store实例来填写。
  5. 信息填写完成后,单击确定,完成数据源的添加。

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

使用Table Store数据源

  1. 在DataV控制台上,单击我的可视化,选择您的项目,单击编辑,进入大屏编辑界面。
  2. 单击选择某一组件,在数据面板中,选择数据源类型TableStore
  3. 单击选择已有数据源下拉菜单,选择配置完成的Table Store数据源。
  4. 单击选择操作下拉列表选择需要的操作,系统支持以下两种操作方式。
  5. 选择操作下的编辑框中输入查询语句。
    • 查询参数必须为JSON对象。
    • 选择getRow操作时,需要根据指定的主键读取单行数据。

      参数格式如下。

      {
      "table_name": "test",
      "rows": {
      "id": 2
      },
      "columns": [
      "id",
      "test"
      ]
      }
      • table_name:填写您需要查询的Table名。
      • rows:填写行的过滤条件,将筛选出符合条件的行返回。如果您需要在rows里面添加column作为查询条件,那么所添加的column必须是建立过索引的。
      • columns:填写需要返回的列名。
    • 选择getRange操作,可读取指定主键范围内的数据,参数格式如下。
      {
      "table_name": "test",
      "direction": "FORWARD",
      "columns": [
      "id",
      "test"
      ],
      "range": {
      "limit": 4,
      "start": {
      "id": "InfMin"
      },
      "end": {
      "id": 3
      }
      }
      }
      • table_name:填写您需要查询的 Table 名。
      • direction:查询的顺序。
      • columns:填写需要返回的列名。
      • limit:读取最多返回的行数。
      • start:指定读取时的起始列,返回的结果中包含当前起始列,所列出的 column 必须是已经建立索引的列。
      • end:指定读取时的结束列,返回的结果中不包含当前结束列,所列出的 column 必须是已经建立索引的列。
      说明 startend参数里可以使用InfMinInfMax表示最小值和最大值 。
  6. 单击查看数据响应结果,数据响应成功后即可看到效果。

调用示例

  1. 准备Table Store数据。

    您需要先在Table Store控制台创建实例存储数据。如下图建立了一个实例名为test1948的实例,里面有3行数据,每行数据有两个列:id(主键, integer)test(string)


    Table Store数据
  2. 配置数据源。
    配置数据源
  3. 查询参数。
    • 使用getRow方式查询。
      getRow方式查询数据
      数据响应结果如下。
      getRow查询响应结果
    • 使用getRange方式查询。
      getRange方式查询数据
      数据响应结果如下。
      getRange查询响应结果
    说明 在查询getRange参数的时候,过滤条件startid:InfMinendid:3,最后查出来 id12两行记录。因为getRange并不包含end的行,即不包含id3的行。