トンネルサービスは、Tablestore API を使用して完全データと増分データを使用できるようにする集中型サービスです。トンネルサービスは、完全データ、増分データ、および差分データをエクスポートおよび使用するために使用されるトンネルを提供します。データテーブルのトンネルを作成した後、そのトンネルを使用してデータテーブル内の完全データと増分データを使用できます。
トンネルの作成
データテーブルのトンネルを作成します。
- コマンド構文
create_tunnel -n name次の表に、データテーブルのトンネルを作成するために構成できるパラメーターを示します。
パラメーター 必須 例 説明 -t, --table いいえ mytable データテーブルの名前。 -n, --name はい t1 トンネルの名前。 -m, --mode いいえ stream_data_only トンネルのタイプ。デフォルト値：stream_data_only。有効な値： - base_data_only：完全トンネル。完全データのみが使用および処理されます。
- stream_data_only：増分トンネル。増分データのみが使用および処理されます。
- base_and_stream：差分トンネル。完全データが使用および処理された後、増分データが使用および処理されます。
- 例
次のサンプルコードは、データテーブルに t1 という名前のトンネルを作成する方法を示しています。
create_tunnel -n t1次の結果が返されます：New tunnel created, its id is '9933470d-8a5e-4972-a5b0-b7ae6f836460'.
トンネルに関する情報のクエリ
トンネルに関するトンネル情報とチャネル情報をクエリします。
- コマンド構文
describe_tunnel -n name次の表に、トンネルに関する情報をクエリするために構成できるパラメーターを示します。
パラメーター 必須 例 説明 -t, --table いいえ mytable データテーブルの名前。 -n, --name はい t1 トンネルの名前。 -o, --output いいえ D:\\otstest\\mytunnel.txt 返された結果を格納するローカルファイル。 - 例
次のサンプルコードは、t1 という名前のトンネルに関する情報をクエリする方法を示しています。
describe_tunnel -n t1次の結果が返されます：Tunnel Info: +--------------------------------------+------------+------------+---------------+---------+ | TunnelId | TunnelName | TunnelType | Stage | Expired | +--------------------------------------+------------+------------+---------------+---------+ | 9933470d-8a5e-4972-a5b0-b7ae6f836460 | t1 | Stream | ProcessStream | false | +--------------------------------------+------------+------------+---------------+---------+ Channel Info: +-------------------------------------------------------+-------------+---------------+----------+-------------------------------+ | ChannelId | ChannelType | ChannelStatus | ClientId | ChannelRPO | +-------------------------------------------------------+-------------+---------------+----------+-------------------------------+ | cfd2c05b-54b6-48ec-aa6f-feb427f0ca57_1635771329155688 | Stream | OPEN | | 1970-01-01 08:00:00 +0800 CST | +-------------------------------------------------------+-------------+---------------+----------+-------------------------------+
トンネルのデータ消費のシミュレーション
トンネルを作成した後、トンネルのデータ消費をシミュレートして、トンネル内のデータ形式をプレビューできます。
- コマンド構文
consume_tunnel -n name -m mock_consume次の表に、トンネルのデータ消費をシミュレートするために構成できるパラメーターを示します。
パラメーター 必須 例 説明 -c, --channel いいえ cfd2c05b-54b6-48ec-aa6f-feb427f0ca57_1635771329155688 チャネルのID。このパラメーターを構成しない場合、トンネルのすべてのチャネルのデータが使用されます。 -t, --table いいえ mytable データテーブルの名前。 -n, --name はい t1 トンネルの名前。 -m, --mode はい mock_consume 消費モード。デフォルト値：shadow_copy。有効な値： - shadow_copy：オンライントンネルの消費トラフィックをコピーします。
- mock_consume：データ消費をシミュレートしますが、チェックポイント情報は更新しません。
- real_consume：データを使用し、チェックポイント情報を更新します。このモードは使用しないことをお勧めします。
- 例
次のサンプルコードは、t1 という名前のトンネルのデータ消費をシミュレートする方法を示しています。
consume_tunnel -n t1 -m mock_consumeデータ消費をシミュレートするコマンドを実行した後、データがデータテーブルに書き込まれると、データ消費レコードが表示されます。次のサンプルコードは、返された結果の例を示しています：Starting consume tunnel 't1' of table 'mytable', it may take a few seconds to start, please wait... null
トンネルの削除
不要になったトンネルを削除できます。
- コマンド構文
drop_tunnel -n name -y次の表に、トンネルを削除するために構成できるパラメーターを示します。
パラメーター 必須 例 説明 -t, --table いいえ mytable データテーブルの名前。 -n, --name はい t1 トンネルの名前。 -y, --yes はい 該当なし 確認情報が表示されるように指定します。この構成項目はコマンドに含める必要があります。 - 例
次のサンプルコードは、t1 という名前のトンネルを削除する方法を示しています。
drop_tunnel -n t1 -y