全部產品
Search
文件中心

Tablestore:更新表配置

更新時間:Nov 13, 2024

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

前提條件

參數說明

更多資訊,請參見參數說明

介面

 /// <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

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