Manage tunnels - Tablestore CLI - Tablestore - Alibaba Cloud Documentation Center

Buat dan kelola tunnel menggunakan Tablestore CLI untuk mengonsumsi data inkremental, lengkap, atau lengkap-plus-inkremental dari tabel data.

Prasyarat

Tablestore CLI telah terinstal dan kredensial akses telah dikonfigurasi. Untuk informasi selengkapnya, lihat Tablestore CLI.
Tabel data dengan Stream (fitur log perubahan data) diaktifkan. Untuk informasi selengkapnya, lihat Operasi tabel data.

Buat tunnel

Buat tunnel untuk tabel data.

create_tunnel -n <tunnelName>

Parameter	Wajib	Deskripsi
-t, --table	Tidak	Nama tabel data. Tidak diperlukan jika Anda telah memilih tabel data menggunakan perintah `use`.
-n, --name	Ya	Nama tunnel.
-m, --mode	Tidak	Jenis tunnel. Nilai yang valid: base_data_only: Mode data lengkap. Hanya mengonsumsi data yang sudah ada di tabel. stream_data_only (default): Mode data inkremental. Hanya mengonsumsi perubahan data inkremental. base_and_stream: Mode lengkap-plus-inkremental. Mengonsumsi data lengkap terlebih dahulu, lalu melanjutkan mengonsumsi data inkremental.

Contoh

Buat tunnel bernama t1 untuk tabel data.

create_tunnel -n t1

Contoh output:

New tunnel created, its id is '9933470d-8a5e-4972-a5b0-b7ae6f836460'.

Daftar tunnel

Tampilkan semua tunnel untuk tabel data.

list_tunnel

Parameter	Wajib	Deskripsi
-t, --table	Tidak	Nama tabel data. Tidak diperlukan jika Anda telah memilih tabel data menggunakan perintah `use`.

Contoh

list_tunnel

Lihat detail tunnel

Lihat detail tunnel dan channel-nya.

describe_tunnel -n <tunnelName>

Parameter	Wajib	Deskripsi
-t, --table	Tidak	Nama tabel data. Tidak diperlukan jika Anda telah memilih tabel data menggunakan perintah `use`.
-n, --name	Ya	Nama tunnel.
-o, --output	Tidak	Menyimpan output ke file lokal.

Contoh

Lihat detail tunnel t1.

describe_tunnel -n t1

Contoh output:

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 |
+-------------------------------------------------------+-------------+---------------+----------+-------------------------------+

Simulasikan konsumsi tunnel

Pratinjau format data dalam tunnel dengan menjalankan simulasi konsumsi.

consume_tunnel -n <tunnelName> -m mock_consume

Parameter	Wajib	Deskripsi
-c, --channel	Tidak	ID channel. Jika tidak ditentukan, semua channel akan dikonsumsi.
-t, --table	Tidak	Nama tabel data. Tidak diperlukan jika Anda telah memilih tabel data menggunakan perintah `use`.
-n, --name	Ya	Nama tunnel.
-m, --mode	Ya	Mode konsumsi. Nilai yang valid: shadow_copy (default): Mencerminkan traffic konsumsi tunnel online. mock_consume: Mensimulasikan konsumsi data tanpa memperbarui catatan checkpoint. real_consume: Mengonsumsi data dan memperbarui catatan checkpoint. Tidak disarankan karena memengaruhi status checkpoint tunnel produksi.

Contoh

Simulasikan konsumsi data pada tunnel t1.

consume_tunnel -n t1 -m mock_consume

Setelah menjalankan perintah tersebut, CLI akan menunggu data masuk. Saat Anda menulis data ke tabel, catatan konsumsi akan muncul di output. Contoh output:

{"Type":0,"Timestamp":1636360028961786,"SequenceInfo":{"Epoch":0,"Timestamp":1636360028961786,"RowIndex":1},"PrimaryKey":{"PrimaryKeys":[{"ColumnName":"uid","Value":"86"},{"ColumnName":"pid","Value":6771}]},"Columns":[{"Type":0,"Name":"name","Value":"redchen","Timestamp":1636360028962},{"Type":0,"Name":"country","Value":"china","Timestamp":1636360028962}]}

Hapus tunnel

Hapus tunnel.

drop_tunnel -n <tunnelName> -y

Parameter	Wajib	Deskripsi
-t, --table	Tidak	Nama tabel data. Tidak diperlukan jika Anda telah memilih tabel data menggunakan perintah `use`.
-n, --name	Ya	Nama tunnel.
-y, --yes	Ya	Mengonfirmasi penghapusan dan melewati prompt konfirmasi interaktif.

Contoh

Hapus tunnel t1.

drop_tunnel -n t1 -y