Gunakan Tablestore SDK untuk Go untuk menanyakan informasi tentang sebuah terowongan - Tablestore

Setelah membuat terowongan, Anda dapat memanggil operasi DescribeTunnel untuk menanyakan informasi terkait, seperti detail saluran dalam terowongan.

Prasyarat

Instance TunnelClient telah diinisialisasi.
Terowongan telah dibuat untuk tabel data. Untuk informasi lebih lanjut, lihat Buat Sebuah Terowongan.

Parameter

Parameter permintaan

Parameter	Deskripsi
TableName	Nama tabel data yang ingin Anda tanyakan informasi terowongannya.
TunnelName	Nama terowongan.

Parameter respons

Parameter	Deskripsi
TunnelRPO	Waktu terbaru ketika terowongan digunakan untuk mengonsumsi data tambahan. Waktu ini adalah titik waktu ketika saluran paling lambat dalam terowongan digunakan untuk mengonsumsi data. Nilai default: 1 Januari 1970 (UTC).
List<TunnelInfo>	Informasi tentang terowongan. Informasi berikut termasuk dalam respons: TunnelId: ID terowongan. TunnelName: nama terowongan. TunnelType: jenis terowongan. Nilai valid: BaseData, Stream, dan BaseAndStream. Jenis BaseData menunjukkan bahwa terowongan digunakan untuk mengonsumsi data lengkap dari tabel data. Jenis Stream menunjukkan bahwa terowongan digunakan untuk mengonsumsi data tambahan dari tabel data. Jenis BaseAndStream menunjukkan bahwa terowongan digunakan untuk mengonsumsi data diferensial dari tabel data. TableName: nama tabel data tempat terowongan dibuat. InstanceName: nama instansi 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 lengkap. Tahap ProcessStream menunjukkan bahwa terowongan sedang digunakan untuk mengonsumsi data tambahan. Expired: menunjukkan apakah data kedaluwarsa. Jika true dikembalikan, hubungi dukungan teknis Tablestore menggunakan DingTalk sesegera mungkin.
List<ChannelInfo>	Informasi tentang saluran dalam terowongan. Informasi berikut termasuk dalam respons: ChannelId: ID saluran. ChannelType: jenis saluran. Nilai valid: Base dan Stream. ChannelStatus: status saluran. Nilai valid: WAIT, OPEN, CLOSING, CLOSE, dan TERMINATED. ClientId: ID klien terowongan. Secara default, ID klien menggabungkan nama host klien dan string acak. Nama host klien dapat ditentukan menggunakan TunnelWorkerConfig. ChannelRPO: waktu terbaru ketika saluran digunakan untuk mengonsumsi data tambahan. Nilai default: 1 Januari 1970 (UTC). Parameter ini tidak berlaku untuk saluran jenis Base.
ResponseInfo	Bidang lain yang dikembalikan dalam permintaan, termasuk bidang RequestId dalam permintaan. RequestId secara unik mengidentifikasi permintaan.

Contoh

Kode sampel berikut menunjukkan cara menanyakan informasi tentang terowongan, termasuk waktu terakhir penggunaan terowongan untuk mengonsumsi data tambahan dan informasi saluran dalam terowongan:

req := &tunnel.DescribeTunnelRequest{
   TableName:  "<TABLE_NAME>",
   TunnelName: "TUNNEL_NAME",
}
resp, err := tunnelClient.DescribeTunnel(req)
if err != nil {
   log.Fatal("describe tunnel failed", err)
}
log.Println("tunnel id is", resp.Tunnel.TunnelId)

Referensi

Untuk detail operasi API yang dapat dipanggil guna menanyakan informasi terowongan, lihat DescribeTunnel.
Jika ingin segera menggunakan Layanan Terowongan untuk mengonsumsi data, lihat Memulai.
Anda dapat menanyakan informasi tentang semua terowongan dalam tabel. Untuk informasi lebih lanjut, lihat Menanyakan Informasi tentang Semua Terowongan Sebuah Tabel Data.
Anda dapat menghapus terowongan yang tidak lagi diperlukan. Untuk informasi lebih lanjut, lihat Hapus Sebuah Terowongan.