全部产品
Search
文档中心

Tablestore:Layanan Tunnel

更新时间:Jun 24, 2025

Layanan Tunnel adalah layanan terpusat yang menggunakan API Tablestore untuk mengonsumsi data secara penuh dan inkremental. Layanan ini menyediakan tunnel untuk mengekspor serta mengonsumsi data penuh, inkremental, dan diferensial. Setelah membuat tunnel untuk tabel data, Anda dapat menggunakannya untuk mengonsumsi data penuh dan inkremental dari tabel tersebut.

Buat tunnel

Buat tunnel untuk tabel data.

  • Sintaksis Perintah
    create_tunnel -n nama

    Tabel berikut menjelaskan parameter yang dapat dikonfigurasi untuk membuat tunnel pada tabel data.

    ParameterDiperlukanContohDeskripsi
    -t, --tableTidakmytableNama tabel data.
    -n, --nameYat1Nama tunnel.
    -m, --modeTidakstream_data_onlyJenis tunnel. Nilai default: stream_data_only. Nilai valid:
    • base_data_only: tunnel penuh. Hanya data penuh yang dikonsumsi dan diproses.
    • stream_data_only: tunnel inkremental. Hanya data inkremental yang dikonsumsi dan diproses.
    • base_and_stream: tunnel diferensial. Setelah data penuh dikonsumsi dan diproses, data inkremental dikonsumsi dan diproses.
  • Contoh

    Kode sampel berikut menunjukkan cara membuat tunnel bernama t1 untuk tabel data:

    create_tunnel -n t1
    Hasil berikut akan dikembalikan:
    Tunnel baru dibuat, id-nya adalah '9933470d-8a5e-4972-a5b0-b7ae6f836460'.

Kueri informasi tentang tunnel

Menanyakan informasi tunnel dan detail saluran terkait.

  • Sintaksis Perintah
    describe_tunnel -n nama

    Tabel berikut menjelaskan parameter yang dapat dikonfigurasi untuk menanyakan informasi tentang tunnel.

    ParameterDiperlukanContohDeskripsi
    -t, --tableTidakmytableNama tabel data.
    -n, --nameYat1Nama tunnel.
    -o, --outputTidakD:\\otstest\\mytunnel.txtFile lokal tempat Anda ingin menyimpan hasil yang dikembalikan.
  • Contoh

    Kode sampel berikut menunjukkan cara menanyakan informasi tentang tunnel bernama t1:

    describe_tunnel -n t1
    Hasil berikut akan dikembalikan:
    Informasi Tunnel:
    +--------------------------------------+------------+------------+---------------+---------+
    | TunnelId                             | TunnelName | TunnelType | Stage         | Expired |
    +--------------------------------------+------------+------------+---------------+---------+
    | 9933470d-8a5e-4972-a5b0-b7ae6f836460 | t1         | Stream     | ProcessStream | false   |
    +--------------------------------------+------------+------------+---------------+---------+
    
    Informasi Saluran:
    +-------------------------------------------------------+-------------+---------------+----------+-------------------------------+
    | ChannelId                                             | ChannelType | ChannelStatus | ClientId | ChannelRPO                    |
    +-------------------------------------------------------+-------------+---------------+----------+-------------------------------+
    | cfd2c05b-54b6-48ec-aa6f-feb427f0ca57_1635771329155688 | Stream      | OPEN          |          | 1970-01-01 08:00:00 +0800 CST |
    +-------------------------------------------------------+-------------+---------------+----------+-------------------------------+

Simulasikan konsumsi data tunnel

Setelah membuat tunnel, Anda dapat mensimulasikan konsumsi data tunnel untuk melihat pratinjau format datanya.

  • Sintaksis Perintah
    consume_tunnel -n nama -m mock_consume

    Tabel berikut menjelaskan parameter yang dapat dikonfigurasi untuk simulasi konsumsi data tunnel.

    ParameterDiperlukanContohDeskripsi
    -c, --channelTidakcfd2c05b-54b6-48ec-aa6f-feb427f0ca57_1635771329155688ID saluran. Jika Anda tidak mengonfigurasi parameter ini, data di semua saluran tunnel dikonsumsi.
    -t, --tableTidakmytableNama tabel data.
    -n, --nameYat1Nama tunnel.
    -m, --modeYamock_consumeMode konsumsi. Nilai default: shadow_copy. Nilai valid:
    • shadow_copy: menyalin lalu lintas konsumsi tunnel online.
    • mock_consume: mensimulasikan konsumsi data tetapi tidak memperbarui informasi checkpoint.
    • real_consume: mengonsumsi data dan memperbarui informasi checkpoint. Kami sarankan Anda tidak menggunakan mode ini.
  • Contoh

    Kode sampel berikut menunjukkan cara mensimulasikan konsumsi data tunnel bernama t1:

    consume_tunnel -n t1 -m mock_consume
    Setelah menjalankan perintah simulasi konsumsi data, catatan konsumsi data akan ditampilkan saat data ditulis ke tabel. Kode sampel berikut menunjukkan contoh hasil yang dikembalikan:
    Memulai konsumsi tunnel 't1' dari tabel 'mytable', mungkin memerlukan beberapa detik untuk memulai, harap tunggu...
    null

Hapus tunnel

Anda dapat menghapus tunnel yang tidak lagi dibutuhkan.

  • Sintaksis Perintah
    drop_tunnel -n nama -y

    Tabel berikut menjelaskan parameter yang dapat dikonfigurasi untuk menghapus tunnel.

    ParameterDiperlukanContohDeskripsi
    -t, --tableTidakmytableNama tabel data.
    -n, --nameYat1Nama tunnel.
    -y, --yesYaT/AMenentukan bahwa informasi konfirmasi muncul. Item konfigurasi ini harus disertakan dalam perintah.
  • Contoh

    Kode sampel berikut menunjukkan cara menghapus tunnel bernama t1:

    drop_tunnel -n t1 -y