全部產品
Search
文件中心

Tablestore:更新表配置

更新時間:Nov 13, 2024

本文將通過參數說明和範例程式碼為您介紹如何使用 PHP SDK 更新表配置。在更新資料表時,您可以修改表的配置資訊(例如資料生命週期、最大版本數、有效版本偏差等)和 Stream 配置。此外,您還可以為高效能型執行個體中資料表調整預留讀寫輸送量。

前提條件

介面

/**
 * 更新資料表配置(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

  • 更新表配置後,您可能需要以下操作: