Kueri informasi tabel global menggunakan Tablestore Java SDK - Tablestore

Topik ini menjelaskan cara melakukan kueri detail tabel global menggunakan Java SDK.

Prasyarat

Metode

public DescribeGlobalTableResponse describeGlobalTable(DescribeGlobalTableRequest request) throws TableStoreException, ClientException

Parameter DescribeGlobalTableRequest

globalTableId (Wajib) String: ID tabel global.
Catatan
Jika Anda tidak memiliki ID tabel global, Anda dapat memanggil operasi DescribeTable untuk mengkueri detail replika tabel. Jika replika tersebut merupakan bagian dari tabel global, respons akan berisi ID tabel global.
globalTableName (Wajib) String: Nama tabel global. Nama ini harus sama dengan nama tabel dasar.
returnRpo (Opsional) boolean: Menentukan apakah Recovery Point Objective (RPO) dikembalikan. Nilai default-nya adalah false. Pengambilan RPO memerlukan waktu lama; jangan aktifkan parameter ini kecuali benar-benar diperlukan.
phyTable (Opsional) GlobalTableTypes.PhyTable: Kondisi untuk memfilter tabel fisik. Parameter ini berisi anggota berikut:
Nama
Tipe
Deskripsi
regionId (Opsional)
String
ID wilayah tempat tabel fisik berada.
instanceName (Opsional)
String
Nama instans tempat tabel fisik berada.

Nilai kembali DescribeGlobalTableResponse

globalTableId (Wajib) String: ID tabel global.

status (Wajib) GlobalTableTypes.GlobalTableStatus: Status tabel global. Nilai yang valid:

Status	Deskripsi
INIT	Menginisialisasi. Tabel global memasuki status ini setelah dibuat.
RE_CONF	Mengonfigurasi ulang. Seluruh atau sebagian replika tabel global sedang dikonfigurasi. Konfigurasi ini dapat disebabkan oleh pembuatan tabel, sinkronisasi data historis, atau menyambungkan atau melepaskan anggota tabel global.
ACTIVE	Aktif.

phyTables (Wajib) List<PhyTable>: Daftar tabel fisik. Setiap objek dalam daftar berisi anggota berikut:

Nama	Tipe	Deskripsi
regionId (Wajib)	String	ID wilayah tempat tabel fisik berada.
instanceName (Wajib)	String	Nama instans tempat tabel fisik berada.
tableName (Wajib)	String	Nama tabel fisik.
status (Wajib)	PhyTableStatus	Status tabel fisik. Nilai yang valid: PENDING: Dalam antrean. Sistem sedang menunggu konfigurasi tabel replika lainnya. INIT: Menginisialisasi. Tabel replika sedang dibuat atau dikonfigurasi. SYNCDATA: Menyinkronkan. Data historis sedang disinkronkan dan sinkronisasi data inkremental diaktifkan. READY: Siap. Sinkronisasi data historis telah selesai dan terowongan tambahan diaktifkan. Tabel belum dapat ditulis. ACTIVE: Aktif dan menyinkronkan. Tabel replika dapat dibaca dan ditulis. UNBINDING: Melepas. Tabel replika sedang dilepaskan dari tabel global. Tabel replika dan datanya tidak dihapus selama proses ini. UNBOUND: Telah dilepas. Tabel replika telah dilepaskan dari tabel global. Tabel replika dan datanya tidak dihapus selama proses ini.
statusTimestamp (Opsional)	long	Timestamp pembaruan status terakhir. Satuan: milidetik.
writable (Wajib)	boolean	Menentukan apakah tabel dapat ditulis.
role (Opsional)	String	Peran tabel fisik dalam model layanan.
rpo (Opsional)	Instant	RPO data dalam tabel fisik.
tableId (Opsional)	String	ID tabel fisik.
stage (Opsional)	SyncStage	Tahap sinkronisasi data.
isFailed (Wajib)	boolean	Menentukan apakah tabel berada dalam status gagal.
message (Opsional)	String	Informasi tambahan mengenai status tabel fisik, seperti penyebab kegagalan. Jika pembuatan tabel global atau penyambungan/pelepasan hubungan sinkronisasi gagal, `isFailed` bernilai true dan parameter ini menampilkan alasannya.

Contoh

private static void describeGlobalTableExample(SyncClient client) {
    // Membuat permintaan.
    DescribeGlobalTableRequest req = new DescribeGlobalTableRequest(
        // ID tabel global.
        "gt-ee1b54db-f5d9-43f3-ad36-ec44********",
        // Nama tabel global.
        "t-gt-test-1"
    );

    // Mengirim permintaan.
    DescribeGlobalTableResponse descResp = client.describeGlobalTable(req);

    // Mencetak informasi dasar tabel global.
    System.out.println("Status: " + descResp.getStatus());
    System.out.println("ID Tabel Global: " + descResp.getGlobalTableId());

    // Mencetak informasi penerapan replika (Placement).
    List<GlobalTableTypes.PhyTable> placements = descResp.getPhyTables();
    for (GlobalTableTypes.PhyTable p : placements) {
        System.out.println("Replika di " + p.getRegionId() +
                ", Instans: " + p.getInstanceName() +
                ", Dapat Ditulis: " + p.isWritable());
    }
}