TableInBatchGetRowRequest は、BatchGetRow 操作で読み取りを行うテーブルのリクエスト情報を示します。

データ構造

  1. message TableInBatchGetRowRequest { required string table_name = 1; repeated bytes primary_key = 2; // Plainbuffer encoding repeated bytes token = 3; repeated string columns_to_get = 4; // If it is not specified, all columns are read optional TimeRange time_range = 5; optional int32 max_versions = 6; optional bool cache_blocks = 7 [default = true]; // Whether the read data enters the BlockCache optional bytes filter = 8; optional string start_column = 9; optional string end_column = 10;}
  1. <div class="p" id="p-5sg-0yw-47w"><span class="keyword parmname" id="parmname-bq2-dqc-ulo"> table_name</span>:
  2. <ul class="ul" id="ul-xrb-dzq-dfb">
  3. <li class="li" id="li-kir-kje-gyj">
  4. <p class="p" id="p-ci1-nrn-2qe">データ型:String</p>
  5. </li>
  6. <li class="li" id="li-vv9-y4s-4ab">
  7. <p class="p" id="p-t1g-m3p-y73">テーブルの名前。</p>
  8. </li>
  9. </ul>
  10. </div>
  11. <div class="p" id="p-y7j-6iy-5ig"><span class="keyword parmname" id="parmname-prj-i1t-7fy">primary_key</span>:
  12. <ul class="ul" id="ul-h1j-2zq-dfb">
  13. <li class="li" id="li-ddu-ho0-op1">
  14. <p class="p" id="p-jnt-80g-2ry">データ型:Repeated bytes</p>
  15. </li>
  16. <li class="li" id="li-l7n-1mz-c85">
  17. <p class="p" id="p-4ss-rfh-8fc">必須 / 省略可能:必須</p>
  18. </li>
  19. <li class="li" id="li-1c7-nlx-7pc">
  20. <p class="p" id="p-w7o-ryn-za9">行内のすべての主キー列 (主キーの名前と値を含む) 。 主キー列は Plainbuffer 形式でエンコードされます。 詳細については、<a title="" href="https://jp.alibabacloud.com/help/doc-detail/50600.htm">Plainbuffer エンコーディング</a>をご参照ください。
  21. </p>
  22. </li>
  23. </ul>
  24. </div>
  25. <div class="p" id="p-opd-7nr-1q8"><span class="keyword parmname" id="parmname-fnd-otq-mgu">token</span>:
  26. <ul class="ul" id="ul-ftj-fzq-dfb">
  27. <li class="li" id="li-xs5-vf5-lkl">
  28. <p class="p" id="p-az8-0vg-736">データ型:Repeated bytes</p>
  29. </li>
  30. <li class="li" id="li-a24-wrc-q6v">
  31. <p class="p" id="p-cez-dab-afk">必須 / 省略可能:省略可能</p>
  32. </li>
  33. <li class="li" id="li-7st-5zw-w6z">
  34. <p class="p" id="p-vbq-h4w-1c6">次に読み込みを行う (現在は使用不可の) ワイド行の開始位置を指定します。</p>
  35. </li>
  36. </ul>
  37. </div>
  38. <div class="p" id="p-p2p-iui-zhr"><span class="keyword parmname" id="parmname-kra-jf2-pon">columns_to_get</span>:
  39. <ul class="ul" id="ul-exr-gzq-dfb">
  40. <li class="li" id="li-miu-c5v-ym2">
  41. <p class="p" id="p-zep-f3d-wak">データ型:Repeated string</p>
  42. </li>
  43. <li class="li" id="li-cyy-qk4-9jl">
  44. <p class="p" id="p-8l9-cmu-c5z">該当のテーブルから返されるすべての列の名前。</p>
  45. </li>
  46. </ul>
  47. </div>
  48. <div class="p" id="p-8xa-tab-td1"><span class="keyword parmname" id="parmname-7k3-hmg-spg">time_range</span>:
  49. <ul class="ul" id="ul-xms-hzq-dfb">
  50. <li class="li" id="li-9cz-d3h-c9j">
  51. <p class="p" id="p-5it-gtq-gye">データ型:<a title="" href="https://jp.alibabacloud.com/help/doc-detail/50585.htm">TimeRange</a></p>
  52. </li>
  53. <li class="li" id="li-5pk-ax0-aqr">
  54. <p class="p" id="p-v59-a9s-zgj">必須 / 省略可能:time_range または max_versions のいずれか、または両方が存在する必要があります。</p>
  55. </li>
  56. <li class="li" id="li-i7o-nxx-06u">
  57. <p class="p" id="p-ddx-3rw-arv">データのバージョンを読み取るためのタイムスタンプの範囲。</p>
  58. </li>
  59. <li class="li" id="li-dt6-v7k-604">
  60. <p class="p" id="p-7wu-w0s-ue5">タイムスタンプはミリ秒単位です。 タイムスタンプの最小値と最大値は、それぞれ順に 0 、 INT64 MAX です。</p>
  61. </li>
  62. <li class="li" id="li-t9u-2p7-bj9">
  63. <p class="p" id="p-hnu-aby-l7j">時間範囲のデータを照会するには、 start_time および end_time を指定します。</p>
  64. </li>
  65. <li class="li" id="li-aho-d4l-50a">
  66. <p class="p" id="p-rva-24o-on8">特定のタイムスタンプのデータを照会するには、specific_time を指定します。</p>
  67. </li>
  68. <li class="li" id="li-2v1-yno-s89">
  69. <p class="p" id="p-hd7-q9q-apk">例:time_range の値が (100、200) の場合、返される列データのタイムスタンプは [100、200) 以内である必要があります。</p>
  70. </li>
  71. </ul>
  72. </div>
  73. <div class="p" id="p-dk3-z19-xop"><span class="keyword parmname" id="parmname-uog-r3s-pqy">max_versions</span>:
  74. <ul class="ul" id="ul-jsw-3zq-dfb">
  75. <li class="li" id="li-l5q-ecy-t9s">
  76. <p class="p" id="p-vej-icm-rt2">データ型:int32</p>
  77. </li>
  78. <li class="li" id="li-6ve-t0y-qx6">
  79. <p class="p" id="p-ely-o81-szx">必須 / 省略可能:少なくとも max_versions、 time_range のいずれかが存在する必要があります。</p>
  80. </li>
  81. <li class="li" id="li-07y-8s9-9gz">
  82. <p class="p" id="p-5r8-grq-c1r">返される結果の最大数です。</p>
  83. </li>
  84. <li class="li" id="li-hrf-09p-1i9">
  85. <p class="p" id="p-2gi-pvu-561">例:max_versions の値が 2 の場合、列ごとに最大 2 つのバージョンのデータが返されます。</p>
  86. </li>
  87. </ul>
  88. </div>
  89. <div class="p" id="p-8kz-qke-idn"><span class="keyword parmname" id="parmname-565-hg1-d9z">cache_blocks</span>:
  90. <ul class="ul" id="ul-b1v-jzq-dfb">
  91. <li class="li" id="li-0xw-km9-fqs">
  92. <p class="p" id="p-q06-rzl-71c">データ型:Bool</p>
  93. </li>
  94. <li class="li" id="li-9md-1i4-zzf">
  95. <p class="p" id="p-js8-ogx-v6c">必須 / 省略可能:省略可能</p>
  96. </li>
  97. <li class="li" id="li-f6i-zk5-d1q">
  98. <p class="p" id="p-bai-bh9-vum">読み取られたデータが BlockCache に入るかどうか。</p>
  99. </li>
  100. <li class="li" id="li-o22-q2g-4wv">
  101. <p class="p" id="p-qfp-cwa-oa0">既定値:true </p>
  102. </li>
  103. <li class="li" id="li-8r2-69l-ryu">
  104. <p class="p" id="p-kjv-daq-srl">現在、当該パラメーターを false に設定することはできません。</p>
  105. </li>
  106. </ul>
  107. </div>
  108. <div class="p" id="p-d3j-l2j-43t"><span class="keyword parmname" id="parmname-uiz-blo-wfi">filter</span>:
  109. <ul class="ul" id="ul-szs-kzq-dfb">
  110. <li class="li" id="li-p2i-aag-vkh">
  111. <p class="p" id="p-r6z-sr8-vei">データ型:Bytes</p>
  112. </li>
  113. <li class="li" id="li-78p-mk6-ti4">
  114. <p class="p" id="p-mbs-l0o-od2">必須 / 省略可能:省略可能</p>
  115. </li>
  116. <li class="li" id="li-den-erp-s4r">
  117. <p class="p" id="p-zvj-42e-p47">フィルター条件式。</p>
  118. </li>
  119. <li class="li" id="li-69d-dil-920">
  120. <p class="p" id="p-fy0-zs6-8oa"><a title="" href="https://jp.alibabacloud.com/help/doc-detail/50646.htm">Filter</a>後のバイナリデータは Protobuf 形式でシリアル化されます。
  121. </p>
  122. </li>
  123. </ul>
  124. </div>
  125. <div class="p" id="p-tfg-o0d-6gs"><span class="keyword parmname" id="parmname-hx8-rm3-r2v">start_column</span>:
  126. <ul class="ul" id="ul-rbw-lzq-dfb">
  127. <li class="li" id="li-6er-y5h-1pj">
  128. <p class="p" id="p-wzk-a2l-76d">データ型:String</p>
  129. </li>
  130. <li class="li" id="li-vdd-lev-88i">
  131. <p class="p" id="p-qkp-6yw-edy">必須 / 省略可能:省略可能</p>
  132. </li>
  133. <li class="li" id="li-k5b-407-ipj">
  134. <p class="p" id="p-hg8-0ev-5fz">読み取られる開始列 (ワイド行を読み取るために使用) 。</p>
  135. </li>
  136. <li class="li" id="li-305-xkm-247">
  137. <p class="p" id="p-zn8-nil-znt">返される結果には、現在の開始列が含まれます。</p>
  138. </li>
  139. <li class="li" id="li-v8v-779-1tb">
  140. <p class="p" id="p-7xo-5bo-99y">列名は辞書順でソートされます。</p>
  141. </li>
  142. <li class="li" id="li-qty-kgm-ijr">
  143. <p class="p" id="p-g6c-dug-51y">例:テーブルに列「a」、「b」、「c」が含まれ、start_column の値が「b」の場合、読み取りは列「b」から始まり、列「b」および「c」が返されます。</p>
  144. </li>
  145. </ul>
  146. </div>
  147. <div class="p" id="p-r90-d9l-7yj"><span class="keyword parmname" id="parmname-apl-l6i-p5v">end_column</span>:
  148. <ul class="ul" id="ul-uzb-nzq-dfb">
  149. <li class="li" id="li-pu2-scb-3w0">
  150. <p class="p" id="p-jym-gv3-2yg">データ型:String</p>
  151. </li>
  152. <li class="li" id="li-4se-rwr-241">
  153. <p class="p" id="p-aq8-3co-owp">必須 / 省略可能:省略可能</p>
  154. </li>
  155. <li class="li" id="li-5rl-1ac-fo6">
  156. <p class="p" id="p-ym9-0xi-53n">読み取られる終了列 (ワイド行の読み取りに使用) 。</p>
  157. </li>
  158. <li class="li" id="li-n3t-aui-d4l">
  159. <p class="p" id="p-40t-5yr-45e">返される結果には、現在の終了列は含まれません。</p>
  160. </li>
  161. <li class="li" id="li-m05-o4d-fzb">
  162. <p class="p" id="p-axr-qid-hj6">列名は辞書順でソートされます。</p>
  163. </li>
  164. <li class="li" id="li-7x1-jy0-p5i">
  165. <p class="p" id="p-n61-1vo-iqg">例:テーブルに列「a」、「b」、「c」が含まれ、end_column の値が「b」の場合、読み取りは列「b」で終了し、列「a」が返されます。</p>
  166. </li>
  167. </ul>
  168. </div>
  169. </section>
  170. <section class="section" id="section-wuu-acq-qnf">
  171. <h2 class="title sectiontitle" id="title-ksh-l7z-cr0">関連する操作</h2>
  172. <p class="p" id="p-itt-a7a-hiq"><a title="" href="https://jp.alibabacloud.com/help/doc-detail/27310.htm">BatchGetRow</a></p>
  173. </section>
  174. </div>
  175. </article>
  176. </main>