全部产品
Search
文档中心

Tablestore:Melepas tabel global

更新时间:Jan 09, 2026

Topik ini menjelaskan cara menggunakan kit pengembangan perangkat lunak (SDK) Java untuk menghapus satu atau beberapa lokasi distribusi dari tabel global.

Catatan

  • Operasi detach hanya menghapus asosiasi antara tabel replika dan tabel global. Tabel replika beserta datanya tetap dipertahankan. Anda dapat memanggil operasi DeleteTable untuk menghapus tabel replika tersebut secara terpisah.

  • Operasi ini hanya menginisiasi permintaan detach. Prosedur detach memerlukan waktu untuk diselesaikan. Untuk memastikan prosedur telah selesai, Anda dapat memanggil operasi Query global table information guna memeriksa status tabel global. Detach berhasil ketika status tabel global berubah menjadi `active`.

Prasyarat

Initialize a client.

Deskripsi metode

public UnbindGlobalTableResponse unbindGlobalTable(UnbindGlobalTableRequest request) throws TableStoreException, ClientException

Parameter UnbindGlobalTableRequest

  • 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 tabel tersebut termasuk dalam tabel global, respons dari operasi `DescribeTable` akan berisi ID tabel global yang sesuai.

  • globalTableName (Wajib) String: Nama tabel global. Nama ini harus sama dengan nama tabel dasar.

  • Removals (Wajib) List<Removal>: Daftar lokasi distribusi yang akan dihapus. Daftar ini berisi parameter berikut:

    Name

    Type

    Description

    regionId (Wajib)

    String

    ID wilayah.

    instanceName (Wajib)

    String

    Nama instans.

Contoh

private static void unbindGlobalTableExample(SyncClient client) {
    // Membuat permintaan.
    UnbindGlobalTableRequest request = new UnbindGlobalTableRequest(
                // ID tabel global.
                "gt-ee1b54db-f5d9-43f3-ad36-ec44********",
                // Nama tabel global.
                "my-global-table"
    );
                
    // Membuat daftar replika yang akan dihapus (Removals).
    List<GlobalTableTypes.Removal> removals = new ArrayList<>();

    // Contoh: Rencana menghapus replika di wilayah China (Hangzhou).
    GlobalTableTypes.Removal hangzhouRemoval = new GlobalTableTypes.Removal(
                // ID wilayah tempat replika berada.
                "cn-hangzhou",
                // Nama instans tempat replika berada.
                "instance-replica-hz"
    );

    // Contoh: Rencana menghapus replika di wilayah China (Shanghai).
    GlobalTableTypes.Removal shanghaiRemoval = new GlobalTableTypes.Removal(
                // ID wilayah tempat replika berada.
                "cn-shanghai",
                // Nama instans tempat replika berada.
                "instance-replica-sh"
    );
    
    removals.add(hangzhouRemoval);
    removals.add(shanghaiRemoval);
    request.setRemovals(removals);

    // Mengirim permintaan.
    UnbindGlobalTableResponse response = client.unbindGlobalTable(request);
    System.out.println("Unbind start. Request ID: " + response.getRequestId());
}