全部产品
Search
文档中心

Tablestore:Menanyakan informasi tentang semua terowongan dari tabel data

更新时间:Jul 02, 2025

Setelah membuat terowongan, Anda dapat memanggil operasi ListTunnel untuk menanyakan informasi tentang semua terowongan dari sebuah tabel, termasuk nama terowongan, tipe, ID, tahap, serta status kedaluwarsa data.

Prasyarat

  • Sebuah instance TunnelClient telah diinisialisasi.

  • Sebuah terowongan telah dibuat untuk tabel data. Untuk informasi lebih lanjut, lihat Buat Terowongan.

Parameter

Parameter permintaan

Parameter

Deskripsi

TableName

Nama tabel data yang ingin Anda tanyakan informasi terowongannya.

Parameter respons

Parameter

Deskripsi

List<TunnelInfo>

Informasi tentang terowongan. Informasi berikut ini disertakan dalam respons:

  • TunnelId: ID terowongan.

  • TunnelType: tipe terowongan. Nilai valid: BaseData, Stream, dan BaseAndStream. Tipe BaseData menunjukkan bahwa terowongan digunakan untuk mengonsumsi data penuh dari tabel data. Tipe Stream menunjukkan bahwa terowongan digunakan untuk mengonsumsi data tambahan dari tabel data. Tipe BaseAndStream menunjukkan bahwa terowongan digunakan untuk mengonsumsi data diferensial dari tabel data.

  • TableName: nama tabel data tempat terowongan dibuat.

  • InstanceName: nama instance tempat terowongan berada.

  • Stage: tahap terowongan. Nilai valid: InitBaseDataAndStreamShard, ProcessBaseData, dan ProcessStream. Tahap InitBaseDataAndStreamShard menunjukkan bahwa terowongan sedang diinisialisasi. Tahap ProcessBaseData menunjukkan bahwa terowongan sedang digunakan untuk mengonsumsi data penuh. Tahap ProcessStream menunjukkan bahwa terowongan sedang digunakan untuk mengonsumsi data tambahan.

  • Expired: menunjukkan apakah data telah kedaluwarsa.

    Jika true dikembalikan, hubungi dukungan teknis Tablestore melalui DingTalk sesegera mungkin.

ResponseInfo

Bidang lainnya yang dikembalikan dalam permintaan, termasuk bidang RequestId dalam permintaan. RequestId secara unik mengidentifikasi permintaan.

Contoh

Kode sampel berikut menunjukkan cara menanyakan informasi tentang semua terowongan dari sebuah tabel:

req := &tunnel.ListTunnelRequest{
    TableName: "<TABLE_NAME>",
}
resp, err := tunnelClient.ListTunnel(req)
if err != nil {
    log.Fatal("List tunnel gagal", err)
} else {
    for i := 0; i < len(resp.Tunnels); i++ {
        log.Println(resp.Tunnels[i].TableName, resp.Tunnels[i].TunnelName, resp.Tunnels[i].TunnelId)
    }
}

Referensi

  • Untuk detail operasi API yang dapat dipanggil untuk menanyakan informasi tentang semua terowongan dari tabel data, lihat ListTunnel.

  • Untuk segera menggunakan Layanan Terowongan guna mengonsumsi data, lihat Memulai.

  • Untuk menanyakan informasi tentang sebuah terowongan secara spesifik, lihat Menanyakan Informasi tentang Sebuah Terowongan.

  • Untuk menghapus terowongan yang tidak diperlukan lagi, lihat Hapus Terowongan.