1.5.2 读记录

GetResult get(GetRequest request)

功能

获取某个表的某一行记录，可以返回所有属性或者部分属性

消耗一个单位读配额

方法参数

request : GetRequest : required

GetRequest包括以下部分

1.tableName ： String ： required

指定要读哪一张表

2.keys : Map< String, Datum > : required

指定要读哪一行，即那行的实体组键(若存在)和主键的属性值，keys必须包含所有的实体组键(若存在)和主键的属性

3.attributes : List< String > : optional

指定需要返回的属性列表，不指定表示返回所有属性

方法返回值

item : Map< String, Datum >

返回的所指定的属性的值

异常错误码

INTERNAL_ERROR(1) : 服务器异常

ACCESS_DENIED（4） : 用户对该表没有读权限

VALIDATION_FAILED（5）: keys没有完全包含实体组键（若存在）和主键的属性，或者指定的属性不存在

THROUGHPUT_EXCEED（8）： 当前读速度已超过该表的读配额

RESOURCE_NOT_FOUND(9) : 所指定的表不存在

限制

keys必须包含实体组键（若存在）和主键的属性

示例

以示例表为例，下面给出读一条记录的示例代码

$tableName = 'php-note';
$get = new GetRequest(array(
  "tableName" => $tableName,
  "keys" => array(
    "userId" => DatumUtil::datum("user1"),
    "noteId" => DatumUtil::datum(rand(0, 10)),
  ),
));

$result = $tableClient->get($get);