Tablestore:単一行のデータの読み取り

使用上の注意

データを読み取る際は、自動採番プライマリキー列の値を含め、完全なプライマリキーの値を指定する必要があります。

前提条件

Tablestore クライアントの初期化

メソッド

public GetRowResponse GetRow(GetRowRequest request)

非同期メソッド：

public Task<GetRowResponse> GetRowAsync(GetRowRequest request)

コード例

この例では、プライマリキーの値が 'row1' である単一行を読み取ります。

try
{
    // プライマリキーを構築します。
    PrimaryKey primaryKey = new PrimaryKey
    {
        { "id", new ColumnValue("row1") }
    };

    // GetRow メソッドを呼び出して行を読み取ります。
    GetRowRequest getRowRequest = new GetRowRequest("test_table", primaryKey);
    GetRowResponse getRowResponse = client.GetRow(getRowRequest);

    Console.WriteLine($"RequestId： {getRowResponse.RequestID}");
    Console.WriteLine($"読み取りで消費したキャパシティーユニット： {getRowResponse.ConsumedCapacityUnit.Read}");
    Console.WriteLine($"書き込みで消費したキャパシティーユニット： {getRowResponse.ConsumedCapacityUnit.Write}");
    Console.WriteLine($"行データ： {getRowResponse.Row}");
}
catch (Exception ex)
{
    Console.WriteLine($"行の取得に失敗しました。例外： {ex.Message}");
}

• 読み取るデータのバージョン範囲を指定します。メソッドは、指定されたバージョン範囲内のデータのみを返します。

  TimeRange timeRange = new TimeRange
  {
      StartTime = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds() - 86400 * 1000,
      EndTime = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds()
  };
  
  // GetRow メソッドを呼び出して行を読み取ります。
  GetRowRequest getRowRequest = new GetRowRequest("test_table", primaryKey, null, null, timeRange);

• 読み取る属性列を指定します。

  HashSet<string> columnsToGet = new HashSet<string> { "col2" };
  
  // GetRow メソッドを呼び出して行を読み取ります。
  GetRowRequest getRowRequest = new GetRowRequest("test_table", primaryKey, columnsToGet);