本文將通過參數說明和範例程式碼為您介紹如何使用 .NET SDK 更新表配置。在更新資料表時,您可以修改表的配置資訊(例如資料生命週期、最大版本數、有效版本偏差等)和 Stream 配置。此外,您還可以為高效能型執行個體中資料表調整預留讀寫輸送量。
前提條件
已初始化 OTSClient。更多資訊,請參見初始化 OTSClient。
已建立資料表。具體操作,請參見建立資料表。
參數說明
更多資訊,請參見參數說明。
介面
/// <summary>
/// 更新資料表配置(TableOptions、ReservedThroughput或StreamSpecification)。
/// </summary>
public UpdateTableResponse UpdateTable(UpdateTableRequest request);
/// <summary>
/// UpdateTable的非同步形式,其參數和調用方式與UpdateTable保持一致。
/// </summary>
public Task<UpdateTableResponse> UpdateTableAsync(UpdateTableRequest request);
樣本
更新資料表配置
以下樣本用於修改資料表的配置資訊。
public static void UpdateTable()
{
OTSClient otsClient = Config.GetClient();
TableOptions tableOptions = new TableOptions();
//資料的到期時間,-1表示永不到期。
tableOptions.TimeToLive = -1;
//最大版本數,屬性列值最多保留5個版本。
tableOptions.MaxVersions = 5;
//有效版本偏差,即寫入資料的時間戳記與系統目前時間的偏差允許最大值為86400秒(1天)。
tableOptions.DeviationCellVersionInSec = 86400
//允許UpdateRow相關更新寫入操作。
tableOptions.AllowUpdate = true;
UpdateTableRequest request = new UpdateTableRequest("<TABLE_NAME>");
request.TableOptions = tableOptions;
try{
otsClient.UpdateTable(request);
Console.WriteLine("Update table succeeded.");
}
catch (Exception ex)
{
Console.WriteLine("Update table failed, exception:{0}", ex.Message);
}
}
更新高效能型執行個體中資料表的預留輸送量
以下樣本用於修改高效能型執行個體中資料表的預留輸送量 。
public static void UpdateTable()
{
OTSClient otsClient = Config.GetClient();
//設定新的預留讀輸送量為1,寫輸送量為1。容量型執行個體下的資料表只能設定為0。
CapacityUnit reservedThroughput = new CapacityUnit(1, 1);
TableOptions tableOptions = new TableOptions();
tableOptions.AllowUpdate = false;
tableOptions.TimeToLive = -1;
UpdateTableRequest request = new UpdateTableRequest("<TABLE_NAME>", reservedThroughput);
request.TableOptions = tableOptions;
try{
otsClient.UpdateTable(request);
Console.WriteLine("Update table succeeded.");
}
catch (Exception ex)
{
Console.WriteLine("Update table failed, exception:{0}", ex.Message);
}
}
相關文檔
關於 API 說明的更多資訊,請參見 UpdateTable。
更新表配置後,您可能需要以下操作: