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

前提条件

已准备好待添加的TableStore数据源。

添加TableStore数据源操作步骤

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

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

使用TableStore数据源操作步骤

  1. 登录DataV控制台。
  2. 在我的可视化页面中，将鼠标移动至需要编辑的可视化应用上，单击编辑。
  3. 在画布编辑页面，单击画布中的某一组件。

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

  4. 在画布右侧的组件配置面板中，单击数据 > 配置数据源。
    配置数据源
  5. 在设置数据源页面中，选择数据源类型为TableStore。
  6. 在选择已有数据源列表中选择配置完成的TableStore数据源。
  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必须是已经建立索引的列。
      说明 start和end参数中，可以使用InfMin和InfMax表示最小值和最大值 。
  9. 单击预览数据源返回结果，查看数据返回结果。

调用示例

  1. 准备TableStore数据。

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

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