使用二级索引读取数据

参数

使用GetRow接口读取索引表中数据时有如下注意事项：

• table_name需要设置为索引表名称。

• 由于系统会自动将未出现在索引列中的数据表主键补齐到索引表主键中，所以设置行的主键时，需要同时设置索引表索引列和补齐的数据表主键。

示例

以下示例用于读取索引表中指定主键的行数据。

$request = [
 'table_name' => '<INDEX_NAME>', //设置索引表名称。
 'primary_key' => [ //设置索引表主键。如果读取本地二级索引中的数据，索引表的第一列主键必须与数据表的第一列主键相同。
 ['PK0', 123],
 ['Col1', "abc"],
 ['PK1', 'abc']
 ],
 'max_versions' => 1, //设置读取最新版本。
 'columns_to_get' => ['Col1'] //设置要读取的列。
];
$response = $otsClient->getRow($request); 

参数

使用GetRange接口读取索引表中数据时有如下注意事项：

• table_name需要设置为索引表名称。

• 由于系统会自动将未出现在索引列中的数据表主键补齐到索引表主键中，所以设置起始主键和结束主键时，需要同时设置索引表索引列和补齐的数据表主键。

示例

以下示例用于读取索引表中指定主键范围内的数据。

//查找PK0从1到4（左闭右开）的数据。
//范围的边界需要提供完整的主键，如果查询的范围不涉及到某一列值的范围，则需要将该列设置为无穷大（INF_MAX）或者无穷小（INF_MIN）。
//如果读取本地二级索引中的数据，索引表的第一列主键必须与数据表的第一列主键相同。
$startPK = [
 ['Col1', "abc"], 
 ['PK0', null, PrimaryKeyTypeConst::CONST_INF_MIN] //'INF_MIN'表示最小值。
 ['PK1', null, PrimaryKeyTypeConst::CONST_INF_MIN] //'INF_MIN'表示最小值。
];
//范围的边界需要提供完整的主键，如果查询的范围不涉及到某一列值的范围，则需要将该列设置为无穷大（INF_MAX）或者无穷小（INF_MIN）。
$endPK = [
 ['Col1', "abc"],
 ['PK0', null, PrimaryKeyTypeConst::CONST_INF_MAX] //'INF_MAX'表示最大值。
 ['PK1', null, PrimaryKeyTypeConst::CONST_INF_MAX] //'INF_MAX'表示最大值。
];
$request = [
 'table_name' => '<INDEX_NAME>', //设置索引表名称。
 'max_versions' => 1, //设置读取最新版本。
 'direction' => DirectionConst::CONST_FORWARD, //设置正序查询。
 'inclusive_start_primary_key' => $startPK, //设置开始主键。
 'exclusive_end_primary_key' => $endPK, //设置结束主键。
 'limit' => 10 //设置最多返回10行数据。
];
$response = $otsClient->getRange ($request);
print "Read CU Consumed: {$response['consumed']['capacity_unit']['read']}\n";

foreach ($response['rows'] as $rowData) {
 //处理每一行数据。
}