Tablestore:テーブルの設定の更新

前提条件

• OTSClient インスタンスが初期化されていること。詳細については、OTSClient インスタンスの初期化を参照してください。

• データテーブルが作成されていること。詳細については、データテーブルの作成を参照してください。

パラメーター

詳細については、パラメーターを参照してください。

API 操作

 /// <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();
  // データテーブル内のデータの TTL を指定します。値 -1 は、データテーブル内のデータが期限切れにならないことを指定します。
  tableOptions.TimeToLive = -1;
  // データテーブルの各属性列に保持できる最大バージョン数を指定します。この例では、各属性列に最大 5 つのバージョンのデータを保持できます。
  tableOptions.MaxVersions = 5;
  // 現在のシステム時刻と書き込まれたデータのタイムスタンプの最大差を指定します。この例では、最大差は 86,400 秒（1 日）に設定されています。
  tableOptions.DeviationCellVersionInSec = 86400
  // データテーブルでの UpdateRow 操作が許可されることを指定します。
  tableOptions.AllowUpdate = true;
  
  UpdateTableRequest request = new UpdateTableRequest("<TABLE_NAME>");
  request.TableOptions = tableOptions;
  try{
    otsClient.UpdateTable(request);
    Console.WriteLine("テーブルの更新に成功しました。");
  }
  catch (Exception ex)
  {
    Console.WriteLine("テーブルの更新に失敗しました。例外: {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("テーブルの更新に成功しました。");
  }
  catch (Exception ex)
  {
    Console.WriteLine("テーブルの更新に失敗しました。例外: {0}", ex.Message);
  }
}

参照

• API 操作の詳細については、UpdateTableを参照してください。

• テーブルの設定を更新した後、次の操作を実行できます。

  • テーブルに対する操作。詳細については、テーブルを参照してください。

  • データに対する操作。詳細については、データに対する基本操作を参照してください。