Tablestore Node.js SDK を使用して単一行のデータを読み取る - Tablestore

Node.js SDK で `getRow` を呼び出して、Tablestore テーブルから単一行を読み取ります。プライマリキーの値、バージョン範囲、および列フィルターを指定して、返されるデータを制御します。

注意事項

データを読み取るには、完全なプライマリキーの値を指定する必要があります。この値には、自動採番主キー列の値も含まれます。

前提条件

メソッド

getRow: function getRow(params, callback)

パラメーターの説明

名前	型	説明
tableName (必須)	string	データテーブルの名前。
primaryKey (必須)	Array	プライマリキーに関する情報。プライマリキー列の名前と値が含まれます。プライマリキー列のデータの型は、STRING、INTEGER、または BINARY です。プライマリキーの数と型は、データテーブルのものと一致している必要があります。
maxVersions (任意)	number	返すバージョンの最大数。デフォルト値は 1 です。クエリ条件を満たすデータバージョン数が指定された最大バージョン数を超えた場合、最新のものから順に指定された数のバージョンが返されます。
timeRange (任意)	object	データバージョンの範囲を指定します。 Tablestore テーブルの各属性列は、異なるデータバージョンを持つことができます。バージョン範囲を指定すると、その範囲内のデータのみが返されます。
columnsToGet (任意)	Array	読み取るデータ列。プライマリキー列または属性列を指定できます。 columnsToGet を設定しない場合、行全体が返されます。 columnsToGet を設定し、読み取る行に指定されたデータ列が含まれていない場合、null が返されます。
columnFilter (任意)	TableStore.ColumnCondition	フィルター条件。詳細については、「フィルター」をご参照ください。 columnsToGet と columnFilter の両方を設定した場合、システムはまず columnsToGet に基づいて行を選択し、次に columnFilter に基づいてデータをフィルター処理します。
transactionId (任意)	string	ローカルトランザクションの ID。この ID はローカルトランザクションを一意に識別します。詳細については、「ローカルトランザクション」をご参照ください。

例

次のサンプルコードは、プライマリキーの値が row1 である単一行のデータを読み取る方法を示しています。

var params = {
    tableName: 'test_table',
    primaryKey: [{ 'id': 'row1' }]
};

client.getRow(params, function (err, data) {
    if (err) {
        console.log('Get row failed with error: ', err);
        return;
    }
    console.log('Read CU Cost: ', data.consumed.capacityUnit.read);
    console.log('Write CU Cost: ', data.consumed.capacityUnit.write);
    console.log('Row Data: ', JSON.stringify(data.row));
});

読み取るデータバージョンの時間範囲を設定します。指定された時間範囲内のデータのみが返されます。
```
params.timeRange = {
    startTime: (Date.now() - 86400 * 1000).toString(),
    endTime: Date.now().toString()
}
```
読み取る属性列を指定します。
```
params.columnsToGet = ['col2']
```

Tablestore:単一行のデータを読み取る

注意事項

前提条件

メソッド

例

参考情報