更新表配置

本文将通过参数说明和示例代码为您介绍如何使用 PHP SDK 更新表配置。在更新数据表时,您可以修改表的配置信息(例如数据生命周期、最大版本数、有效版本偏差等)和 Stream 配置。此外,您还可以为 CU 模式(原按量模式)下高性能型实例中数据表调整预留读写吞吐量。

前提条件

接口

/**
 * 更新数据表配置(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
    //]
]); 

更新 CU 模式下高性能型实例中数据表的预留吞吐量

以下示例用于修改 CU 模式下高性能型实例中数据表的预留吞吐量 。

$result = $client->updateTable([
    'table_name' => '<TABLE_NAME>',
    //设置新的预留读吞吐量为1,写吞吐量为1。容量型实例下的数据表只能设置为0。
    'reserved_throughput' => [         
        'capacity_unit' => [
            'read' => 1,            
            'write' => 1
        ]
    ]
]);  

相关文档

  • 关于 API 说明的更多信息,请参见 UpdateTable

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