Table Store PHP SDK 寫入單行資料 - Tablestore

本文介紹如何通過 PHP SDK 在Table Store的資料表中寫入單行資料。

前提條件

方法說明

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，用於唯一標識局部事務，詳情請參見局部事務。

範例程式碼

以下範例程式碼在 test_table 表中寫入一行資料，該行資料的主索引值為 row1。

$request = array (
    'table_name' => 'test_table',
    // 構造主鍵
    'primary_key' => array (
        array('id', 'row1')
    )
);

try{
    // 調用 putRow 方法寫入行資料
    $response = $client->putRow($request);
    echo "* Read CU Cost: " . $response['consumed']['capacity_unit']['read'] . "\n";
    echo "* Write CU Cost: " . $response['consumed']['capacity_unit']['write'] . "\n";
} catch (Exception $e) {
    echo "Put Row failed.";
}

添加屬性列。

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

指定資料版本號碼，您可以為每個屬性列指定單獨的版本號碼。

$request['attribute_columns'] = array(
    array('col1', 'val1', null, intval(microtime(true) * 1000))
);

Tablestore：寫入單行資料

前提條件

方法說明

範例程式碼

相關文檔