Tablestore PHP SDK: 1 行のデータを書き込む - Tablestore - Alibaba Cloud ドキュメントセンター

PHP SDK の putRow メソッドを使用して、Tablestore テーブルに 1 行のデータを書き込みます。

事前準備

メソッドの説明

public function putRow(array $request)

$request のパラメーターの説明

名前	型	説明
table_name (必須)	string	テーブルの名前。
primary_key (必須)	array	プライマリキーの情報。プライマリキー列の名前と値を含みます。プライマリキー列の型には、STRING、INTEGER、BINARY があります。行内のプライマリキーの数と型は、テーブルに定義されているものと一致している必要があります。プライマリキー列が自動インクリメント列の場合、その値をプレースホルダーに設定します。詳細については、「自動インクリメント主キー列」をご参照ください。
attribute_columns (オプション)	array	属性列の情報。列の名前、値、バージョン番号を含みます。属性列の型には、STRING、INTEGER、BINARY、DOUBLE、BOOLEAN があります。バージョン番号はタイムスタンプです。デフォルトでは、システムによって自動的に生成されます。バージョン番号を手動で指定する方法については、「データバージョンとライフサイクル」をご参照ください。
condition (オプション)	array	書き込み条件。詳細については、「条件付き更新」をご参照ください。
return_content (オプション)	array	返されるデータ。 return_type (必須)`array`：戻り値の型。 ReturnTypeConst::CONST_NONE (デフォルト)：データは返されません。 ReturnTypeConst::CONST_PK：プライマリキー列を返します。これを使用して、自動インクリメント主キーの値を取得します。 ReturnTypeConst::CONST_AFTER_MODIFY：更新された列の値を返します。アトミックカウンターに使用します。
transaction_id (オプション)	string	ローカルトランザクション ID。ローカルトランザクションを一意に識別します。詳細については、「ローカルトランザクション」をご参照ください。

サンプルコード

プライマリキーの値が row1 の 1 行のデータを test_table テーブルに書き込みます。

$request = array (
    'table_name' => 'test_table',
    // プライマリキーを構築
    'primary_key' => array (
        array('id', 'row1')
    )
);

try{
    // putRow を呼び出して行を書き込む
    $response = $client->putRow($request);
    echo "* 読み取り CU コスト: " . $response['consumed']['capacity_unit']['read'] . "\n";
    echo "* 書き込み CU コスト: " . $response['consumed']['capacity_unit']['write'] . "\n";
} catch (Exception $e) {
    echo "行の書き込みに失敗しました。";
}

属性列を追加します。

$request['attribute_columns'] = array(
    array('col1', 'val1')
);

バージョン番号を指定します。各属性列に個別のバージョン番号を割り当てます。
```
$request['attribute_columns'] = array(
    array('col1', 'val1', null, intval(microtime(true) * 1000))
);
```

参考文献

データのバッチ更新