解除綁定全域表

注意事項

解除綁定操作僅移除副本表與全域表的關聯，副本表及其資料均會保留。如需刪除副本表，請單獨調用 DeleteTable 介面。
解除綁定請求為非同步發起，完成解除綁定需要一段時間。可通過查詢全域表資訊查詢全域表狀態，當狀態返回為 active 時，表示解除綁定成功。

前提條件

方法說明

public UnbindGlobalTableResponse unbindGlobalTable(UnbindGlobalTableRequest request) throws TableStoreException, ClientException

UnbindGlobalTableRequest 參數說明

globalTableId（必選）String：全域表 ID。

說明
如需擷取全域表 ID，可調用 DescribeTable 介面查詢副本表的詳細資料。若該副本表屬於某個全域表，返回結果中會包含對應的全域表 ID。
globalTableName（必選）String：全域表名稱，須與基礎資料表名稱保持一致。

Removals（必選）List<Removal>：待移除的分布位置列表。每個 Removal 對象包含以下參數：

名稱	類型	說明
regionId（必選）	String	地區 ID。
instanceName（必選）	String	執行個體名稱。

樣本

private static void unbindGlobalTableExample(SyncClient client) {
    // 構造請求
    UnbindGlobalTableRequest request = new UnbindGlobalTableRequest(
                // 全域表 ID
                "gt-ee1b54db-f5d9-43f3-ad36-ec44********",
                // 全域表名稱
                "my-global-table"
    );
                
    // 構建待移除的副本列表（Removals）
    List<GlobalTableTypes.Removal> removals = new ArrayList<>();

    // 移除華東1（杭州）地區的副本
    GlobalTableTypes.Removal hangzhouRemoval = new GlobalTableTypes.Removal(
                // 副本所在地區 ID
                "cn-hangzhou",
                // 副本所屬執行個體名稱
                "instance-replica-hz"
    );

    // 移除華東2（上海）地區的副本
    GlobalTableTypes.Removal shanghaiRemoval = new GlobalTableTypes.Removal(
                // 副本所在地區 ID
                "cn-shanghai",
                // 副本所屬執行個體名稱
                "instance-replica-sh"
    );
    
    removals.add(hangzhouRemoval);
    removals.add(shanghaiRemoval);
    request.setRemovals(removals);

    // 發起請求
    UnbindGlobalTableResponse response = client.unbindGlobalTable(request);
    System.out.println("Unbind start. Request ID: " + response.getRequestId());
}