Tablestore Java SDK update global table configurations - Tablestore

This topic describes how to use the Java software development kit (SDK) to update the configurations of a physical table in a global table, such as whether the table is writable.

Precautions

Data conflicts occur if multiple replicas are writable in active-passive mode. Change this configuration only when you perform an active-passive switchover.

Prerequisites

Initialize a client.

Method description

public UpdateGlobalTableResponse updateGlobalTable(UpdateGlobalTableRequest request) throws TableStoreException, ClientException

UpdateGlobalTableRequest parameters

globalTableId (Required) String: The ID of the global table.
Note
If you do not have the global table ID, you can call the DescribeTable operation to query the details of a table replica. If the table replica is part of a global table, the response from the DescribeTable operation includes the global table ID.
globalTableName (Required) String: The name of the global table. The name must be the same as the base table name.

phyTable (Required) GlobalTableTypes.UpdatePhyTable: The information about the physical table to update. This includes the following parameters:

Important

To update the configuration, modify at least one of the `writable` or `primaryEligible` properties.

Name	Type	Description
regionId (Required)	String	The ID of the region where the physical table to modify is located.
instanceName (Required)	String	The name of the instance where the physical table to modify is located.
tableName (Required)	String	The name of the physical table to modify.
writable (Optional)	Boolean	Determines whether the configuration is writable.
primaryEligible (Optional)	Boolean	Specifies whether to set the table as primary eligible. This is used for active-passive switchovers in active-passive mode. In active-passive mode, write operations are disabled by default for all non-primary tables. During an active-passive switchover, mark the secondary table as primary eligible.

Example

private static void updateGlobalTableExample(SyncClient client) {
    // Construct the configuration of the physical table to update.
    GlobalTableTypes.UpdatePhyTable phyTable = new GlobalTableTypes.UpdatePhyTable(
                // The ID of the region where the replica is located.
                "cn-shanghai",  
                // The name of the instance to which the replica belongs.
                "instance-replica-sh",  
                // The name of the replica table.
                "i-dest-test"
    );
    
    // To perform an active-passive switchover in active-passive mode, modify both writable and primaryEligible.
    phyTable.setWritable(true);          // Set this replica to be writable.
    phyTable.setPrimaryEligible(true);   // Allow this replica to be eligible to become the primary table (for active-passive switchover).

    // Construct the request.
    UpdateGlobalTableRequest request = new UpdateGlobalTableRequest(
                // The ID of the global table.
                "gt-ee1b54db-f5d9-43f3-ad36-ec44********",
                // The name of the global table.
                "t-gt-test-1",  
                phyTable
    );
    // Send the request.
    UpdateGlobalTableResponse response = client.updateGlobalTable(request);
    System.out.println("Update succeeded. Request ID: " + response.getRequestId());
}