閱讀802 返回首頁    go 阿裏雲

GetRow__API 概覽_API 參考_表格存儲-阿裏雲

行為：

根據給定的主鍵讀取單行數據。

請求結構：

  1. message GetRowRequest {
  2.     required string table_name = 1;
  3.     repeated Column primary_key = 2;
  4.     repeated string columns_to_get = 3;
  5.     optional ColumnCondition filter = 4;
  6. }

table_name：

  • 類型：string。

  • 是否必要參數：是。

  • 要讀取的數據所在的表名。

primary_key：

  • 類型：repeated Column。

  • 是否必要參數：是。

  • 該行全部的主鍵列。

columns_to_get：

  • 類型：repeated string。

  • 是否必要參數：否。

  • 需要返回的全部列的列名。若為空，則返回該行的所有列。

  • 如果指定的列不存在，則不會返回該列的數據。

  • 如果給出了重複的列名，返回結果隻會包含一次該列。

  • columns_to_get 中 string 的個數不應超過 128 個。

filter:

  • 類型：ColumnCondition。

  • 是否必要參數：否。

  • 過濾條件表達式。

響應消息結構：

  1. message GetRowResponse {
  2.     required ConsumedCapacity consumed = 1;
  3.     required Row row = 2;
  4. }

consumed：

  • 類型：CapacityUnit。

  • 本次操作消耗的服務能力單元。

row：

  • 類型:Row。

  • 該行需要返回的的列數據集合。其中 primary_key_columns 和 attribute_columns 分別存放讀取到的主鍵列和屬性列，其順序不保證與 GetRowRequest 中的 columns_to_get 一致。

  • 如果該行不存在，primary_key_columns 和 attribute_columns 均為空。

服務能力單元消耗：

  • 如果請求的行不存在，消耗 1 讀服務能力單元。

  • 如果請求的行存在，消耗讀服務能力單元的數值為這該行所有主鍵列的數據大小與實際讀取的屬性列數據大小之和除以 4 KB 向上取整。關於數據大小的計算請參見購買指導。

  • 如果請求超時，結果未定義，服務能力單元有可能被消耗，也可能未被消耗。

  • 如果返回內部錯誤（HTTP 狀態碼：5XX），則此次操作不消耗服務能力單元，其他錯誤情況消耗 1 讀服務能力單元。

請求示例：

  1. GetRowRequest {
  2.   table_name: "consume_history"
  3.   primary_key {
  4.     name: "CardID"
  5.     value {
  6.       type: STRING
  7.       v_string: "2007035023"
  8.     }
  9.   }
  10.   primary_key {
  11.     name: "SellerID"
  12.     value {
  13.       type: STRING
  14.       v_string: "00022"
  15.     }
  16.   }
  17.   primary_key {
  18.     name: "DeviceID"
  19.     value {
  20.       type: STRING
  21.       v_string: "061104"
  22.     }
  23.   }
  24.   primary_key {
  25.     name: "OrderNumber"
  26.     value {
  27.       type: INTEGER
  28.       v_int: 142857
  29.     }
  30.   }
  31.   columns_to_get: "CardID"
  32.   columns_to_get: "SellerID"
  33.   columns_to_get: "DeviceID"
  34.   columns_to_get: "OrderNumber"
  35.   columns_to_get: "Amount"
  36.   columns_to_get: "Remarks"
  37. }

響應示例：

  1. GetRowResponse {
  2.   consumed {
  3.     capacity_unit {
  4.       read: 1
  5.     }
  6.   }
  7.   row {
  8.     primary_key_columns {
  9.       name: "CardID"
  10.       value {
  11.         type: STRING
  12.         v_string: "2007035023"
  13.       }
  14.     }
  15.     primary_key_columns {
  16.       name: "SellerID"
  17.       value {
  18.         type: STRING
  19.         v_string: "00022"
  20.       }
  21.     }
  22.     primary_key_columns {
  23.       name: "DeviceID"
  24.       value {
  25.         type: STRING
  26.         v_string: "061104"
  27.       }
  28.     }
  29.     primary_key_columns {
  30.       name: "OrderNumber"
  31.       value {
  32.         type: INTEGER
  33.         v_int: 142857
  34.       }
  35.     }
  36.     attribute_columns {
  37.       name: "Amount"
  38.       value {
  39.         type: DOUBLE
  40.         v_double: 2.5
  41.       }
  42.     }
  43.     attribute_columns {
  44.       name: "Remarks"
  45.       value {
  46.         type: STRING
  47.         v_string: "ice cream"
  48.       }
  49.     }
  50.   }
  51. }

最後更新：2016-11-23 16:03:56

  上一篇：go 操作匯總__API 概覽_API 參考_表格存儲-阿裏雲
  下一篇：go PutRow__API 概覽_API 參考_表格存儲-阿裏雲