TableInBatchGetRowRequest は、BatchGetRow 操作で読み取りを行うテーブルのリクエスト情報を示します。
データ構造
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;}
<div class="p" id="p-5sg-0yw-47w"><span class="keyword parmname" id="parmname-bq2-dqc-ulo"> table_name</span>:<ul class="ul" id="ul-xrb-dzq-dfb"><li class="li" id="li-kir-kje-gyj"><p class="p" id="p-ci1-nrn-2qe">データ型：String</p></li><li class="li" id="li-vv9-y4s-4ab"><p class="p" id="p-t1g-m3p-y73">テーブルの名前。</p></li></ul></div><div class="p" id="p-y7j-6iy-5ig"><span class="keyword parmname" id="parmname-prj-i1t-7fy">primary_key</span>:<ul class="ul" id="ul-h1j-2zq-dfb"><li class="li" id="li-ddu-ho0-op1"><p class="p" id="p-jnt-80g-2ry">データ型：Repeated bytes</p></li><li class="li" id="li-l7n-1mz-c85"><p class="p" id="p-4ss-rfh-8fc">必須 / 省略可能：必須</p></li><li class="li" id="li-1c7-nlx-7pc"><p class="p" id="p-w7o-ryn-za9">行内のすべての主キー列 (主キーの名前と値を含む) 。 主キー列は Plainbuffer 形式でエンコードされます。 詳細については、<a title="" href="https://jp.alibabacloud.com/help/doc-detail/50600.htm">Plainbuffer エンコーディング</a>をご参照ください。</p></li></ul></div><div class="p" id="p-opd-7nr-1q8"><span class="keyword parmname" id="parmname-fnd-otq-mgu">token</span>:<ul class="ul" id="ul-ftj-fzq-dfb"><li class="li" id="li-xs5-vf5-lkl"><p class="p" id="p-az8-0vg-736">データ型：Repeated bytes</p></li><li class="li" id="li-a24-wrc-q6v"><p class="p" id="p-cez-dab-afk">必須 / 省略可能：省略可能</p></li><li class="li" id="li-7st-5zw-w6z"><p class="p" id="p-vbq-h4w-1c6">次に読み込みを行う (現在は使用不可の) ワイド行の開始位置を指定します。</p></li></ul></div><div class="p" id="p-p2p-iui-zhr"><span class="keyword parmname" id="parmname-kra-jf2-pon">columns_to_get</span>:<ul class="ul" id="ul-exr-gzq-dfb"><li class="li" id="li-miu-c5v-ym2"><p class="p" id="p-zep-f3d-wak">データ型：Repeated string</p></li><li class="li" id="li-cyy-qk4-9jl"><p class="p" id="p-8l9-cmu-c5z">該当のテーブルから返されるすべての列の名前。</p></li></ul></div><div class="p" id="p-8xa-tab-td1"><span class="keyword parmname" id="parmname-7k3-hmg-spg">time_range</span>:<ul class="ul" id="ul-xms-hzq-dfb"><li class="li" id="li-9cz-d3h-c9j"><p class="p" id="p-5it-gtq-gye">データ型：<a title="" href="https://jp.alibabacloud.com/help/doc-detail/50585.htm">TimeRange</a></p></li><li class="li" id="li-5pk-ax0-aqr"><p class="p" id="p-v59-a9s-zgj">必須 / 省略可能：time_range または max_versions のいずれか、または両方が存在する必要があります。</p></li><li class="li" id="li-i7o-nxx-06u"><p class="p" id="p-ddx-3rw-arv">データのバージョンを読み取るためのタイムスタンプの範囲。</p></li><li class="li" id="li-dt6-v7k-604"><p class="p" id="p-7wu-w0s-ue5">タイムスタンプはミリ秒単位です。 タイムスタンプの最小値と最大値は、それぞれ順に 0 、 INT64 MAX です。</p></li><li class="li" id="li-t9u-2p7-bj9"><p class="p" id="p-hnu-aby-l7j">時間範囲のデータを照会するには、 start_time および end_time を指定します。</p></li><li class="li" id="li-aho-d4l-50a"><p class="p" id="p-rva-24o-on8">特定のタイムスタンプのデータを照会するには、specific_time を指定します。</p></li><li class="li" id="li-2v1-yno-s89"><p class="p" id="p-hd7-q9q-apk">例：time_range の値が (100、200) の場合、返される列データのタイムスタンプは [100、200) 以内である必要があります。</p></li></ul></div><div class="p" id="p-dk3-z19-xop"><span class="keyword parmname" id="parmname-uog-r3s-pqy">max_versions</span>:<ul class="ul" id="ul-jsw-3zq-dfb"><li class="li" id="li-l5q-ecy-t9s"><p class="p" id="p-vej-icm-rt2">データ型：int32</p></li><li class="li" id="li-6ve-t0y-qx6"><p class="p" id="p-ely-o81-szx">必須 / 省略可能：少なくとも max_versions、 time_range のいずれかが存在する必要があります。</p></li><li class="li" id="li-07y-8s9-9gz"><p class="p" id="p-5r8-grq-c1r">返される結果の最大数です。</p></li><li class="li" id="li-hrf-09p-1i9"><p class="p" id="p-2gi-pvu-561">例：max_versions の値が 2 の場合、列ごとに最大 2 つのバージョンのデータが返されます。</p></li></ul></div><div class="p" id="p-8kz-qke-idn"><span class="keyword parmname" id="parmname-565-hg1-d9z">cache_blocks</span>:<ul class="ul" id="ul-b1v-jzq-dfb"><li class="li" id="li-0xw-km9-fqs"><p class="p" id="p-q06-rzl-71c">データ型：Bool</p></li><li class="li" id="li-9md-1i4-zzf"><p class="p" id="p-js8-ogx-v6c">必須 / 省略可能：省略可能</p></li><li class="li" id="li-f6i-zk5-d1q"><p class="p" id="p-bai-bh9-vum">読み取られたデータが BlockCache に入るかどうか。</p></li><li class="li" id="li-o22-q2g-4wv"><p class="p" id="p-qfp-cwa-oa0">既定値：true </p></li><li class="li" id="li-8r2-69l-ryu"><p class="p" id="p-kjv-daq-srl">現在、当該パラメーターを false に設定することはできません。</p></li></ul></div><div class="p" id="p-d3j-l2j-43t"><span class="keyword parmname" id="parmname-uiz-blo-wfi">filter</span>:<ul class="ul" id="ul-szs-kzq-dfb"><li class="li" id="li-p2i-aag-vkh"><p class="p" id="p-r6z-sr8-vei">データ型：Bytes</p></li><li class="li" id="li-78p-mk6-ti4"><p class="p" id="p-mbs-l0o-od2">必須 / 省略可能：省略可能</p></li><li class="li" id="li-den-erp-s4r"><p class="p" id="p-zvj-42e-p47">フィルター条件式。</p></li><li class="li" id="li-69d-dil-920"><p class="p" id="p-fy0-zs6-8oa"><a title="" href="https://jp.alibabacloud.com/help/doc-detail/50646.htm">Filter</a>後のバイナリデータは Protobuf 形式でシリアル化されます。</p></li></ul></div><div class="p" id="p-tfg-o0d-6gs"><span class="keyword parmname" id="parmname-hx8-rm3-r2v">start_column</span>:<ul class="ul" id="ul-rbw-lzq-dfb"><li class="li" id="li-6er-y5h-1pj"><p class="p" id="p-wzk-a2l-76d">データ型：String</p></li><li class="li" id="li-vdd-lev-88i"><p class="p" id="p-qkp-6yw-edy">必須 / 省略可能：省略可能</p></li><li class="li" id="li-k5b-407-ipj"><p class="p" id="p-hg8-0ev-5fz">読み取られる開始列 (ワイド行を読み取るために使用) 。</p></li><li class="li" id="li-305-xkm-247"><p class="p" id="p-zn8-nil-znt">返される結果には、現在の開始列が含まれます。</p></li><li class="li" id="li-v8v-779-1tb"><p class="p" id="p-7xo-5bo-99y">列名は辞書順でソートされます。</p></li><li class="li" id="li-qty-kgm-ijr"><p class="p" id="p-g6c-dug-51y">例：テーブルに列「a」、「b」、「c」が含まれ、start_column の値が「b」の場合、読み取りは列「b」から始まり、列「b」および「c」が返されます。</p></li></ul></div><div class="p" id="p-r90-d9l-7yj"><span class="keyword parmname" id="parmname-apl-l6i-p5v">end_column</span>:<ul class="ul" id="ul-uzb-nzq-dfb"><li class="li" id="li-pu2-scb-3w0"><p class="p" id="p-jym-gv3-2yg">データ型：String</p></li><li class="li" id="li-4se-rwr-241"><p class="p" id="p-aq8-3co-owp">必須 / 省略可能：省略可能</p></li><li class="li" id="li-5rl-1ac-fo6"><p class="p" id="p-ym9-0xi-53n">読み取られる終了列 (ワイド行の読み取りに使用) 。</p></li><li class="li" id="li-n3t-aui-d4l"><p class="p" id="p-40t-5yr-45e">返される結果には、現在の終了列は含まれません。</p></li><li class="li" id="li-m05-o4d-fzb"><p class="p" id="p-axr-qid-hj6">列名は辞書順でソートされます。</p></li><li class="li" id="li-7x1-jy0-p5i"><p class="p" id="p-n61-1vo-iqg">例：テーブルに列「a」、「b」、「c」が含まれ、end_column の値が「b」の場合、読み取りは列「b」で終了し、列「a」が返されます。</p></li></ul></div></section><section class="section" id="section-wuu-acq-qnf"><h2 class="title sectiontitle" id="title-ksh-l7z-cr0">関連する操作</h2><p class="p" id="p-itt-a7a-hiq"><a title="" href="https://jp.alibabacloud.com/help/doc-detail/27310.htm">BatchGetRow</a></p></section></div></article></main>