All Products
Search
Document Center

Tablestore:UpdatePhyTable

Last Updated:Jan 15, 2026

Defines the update information for a physical table in a global table.

Data structure

message UpdatePhyTable {
  required string regionId = 1;
  required string instanceName = 2;
  required string tableName = 3;
  optional bool writable = 4;
  // Marks the physical table as eligible to be a primary table. This is only required in active-passive mode.
  optional bool primaryEligible = 5;
}

Parameter

Type

Required

Description

regionId

string

Yes

The ID of the region where the physical table is located.

instanceName

string

Yes

The name of the instance where the physical table is located.

tableName

string

Yes

The name of the physical table.

writable

bool

No

Specifies whether the table is writable. The default value is false. In active-passive mode, keep the default configuration. In multi-write mode, set this parameter to true as needed.

primaryEligible

bool

No

Specifies whether the table is eligible to become a primary table. This is used for failovers in active-passive mode.

In active-passive mode, write operations are disabled by default for non-primary tables. When you perform a failover, mark the secondary table as eligible to become the primary table.