本文档介绍在DataV中添加Table Store数据源的方法,以及相关参数配置说明。

  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. 我的可视化页面中,将移动鼠标至需要编辑的可视化应用上,单击编辑图标。
  3. 在画布编辑页面,单击画布中的某一组件。

    如果画布中还没有组件,请先添加组件,详情请参见添加组件

  4. 在画布右侧的组件配置面板中,单击数据 > 配置数据源
    配置数据源
  5. 设置数据源页面中,选择数据源类型TableStore
  6. 选择已有数据源列表中选择配置完成的Table Store数据源。
  7. 选择操作列表中选择需要的操作。
    系统支持以下两种操作:
  8. 选择操作编辑框中输入查询语句。
    • 查询参数必须为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表示最小值和最大值 。
  9. 单击预览数据源返回结果,查看数据返回结果。

调用示例

  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的行。