本文將通過參數說明和範例程式碼為您介紹如何使用 PHP SDK 更新表配置。在更新資料表時,您可以修改表的配置資訊(例如資料生命週期、最大版本數、有效版本偏差等)和 Stream 配置。此外,您還可以為高效能型執行個體中資料表調整預留讀寫輸送量。
前提條件
已初始化 OTSClient。具體操作,請參見初始化 OTSClient。
已建立資料表。具體操作,請參見建立資料表。
介面
/**
* 更新資料表配置(table_options、reserved_throughput和stream_spec)。
* 此API可以用來上調或者下調資料表的預留讀寫輸送量。
* @api
* @param [] $request 請求參數。
* @return [] 請求返回。
* @throws OTSClientException 當參數檢查出錯或服務端返回校正出錯時拋出異常。
* @throws OTSServerException 當OTS服務端返回錯誤時拋出異常。
*/
public function updateTable(array $request);
參數說明
更多資訊,請參見參數說明。
樣本
更新資料表配置
以下樣本用於修改資料表的配置資訊。
$result = $client->updateTable([
//設定資料表名稱。
'table_name' => '<TABLE_NAME>',
'table_options' => [
//資料的到期時間,-1表示永不到期。
'time_to_live' => -1,
//最大版本數,屬性列值最多保留5個版本。
'max_versions' => 5,
//有效版本偏差,即寫入資料的時間戳記與系統目前時間的偏差允許最大值為86400秒(1天)。
'deviation_cell_version_in_sec' => 86400,
//允許UpdateRow相關更新寫入操作。
'allow_update' => true
],
//'stream_spec' => [
// //開啟Stream功能。
// 'enable_stream' => true,
// //設定stream到期時間為24小時。
// 'expiration_time' => 24
//]
]);
更新高效能型執行個體中資料表的預留輸送量
以下樣本用於修改高效能型執行個體中資料表的預留輸送量 。
$result = $client->updateTable([
'table_name' => '<TABLE_NAME>',
//設定新的預留讀輸送量為1,寫輸送量為1。容量型執行個體下的資料表只能設定為0。
'reserved_throughput' => [
'capacity_unit' => [
'read' => 1,
'write' => 1
]
]
]);
相關文檔
關於 API 說明的更多資訊,請參見 UpdateTable。
更新表配置後,您可能需要以下操作: