本文将通过参数说明和示例代码为您介绍如何使用 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。
更新表配置后,您可能需要以下操作: