PhyTable definition - Tablestore - Alibaba Cloud Documentation Center

The PhyTable data type is a list of detailed information about the physical tables in a global table.

Data structure

message PhyTable {
  required string regionId = 1;
  required string instanceName = 2;
  required string tableName = 3;
  required bool writable = 4;

  optional PhyTableStatus status = 5;
  optional int64 statusTimestamp = 6;
  optional string tableId = 7;
  optional int32 tableHashKey = 8;
  optional string endpoint = 9;
  optional SyncStage stage = 10;
  optional int64 metaVersion = 11;
  optional bool isFailed = 12;
  optional string message = 13;
  optional string role = 14;
  optional int64 rpoNanos = 15;
}

Parameter	Type	Description
regionId	string	The ID of the region where the physical table is located.
instanceName	string	The name of the instance where the physical table is located.
tableName	string	The name of the physical table.
writable	bool	Indicates whether the table is writable.
status	PhyTableStatus	The status of the physical table.
statusTimestamp	int64	The timestamp of the last status update, in milliseconds.
tableId	string	The ID of the physical table.
tableHashKey	int32	The replica ID of the current table in the global table.
endpoint	string	The endpoint of the physical table.
stage	SyncStage	The data synchronization stage.
metaVersion	int64	The version number of the metadata.
isFailed	bool	Indicates whether the table is in a failed state. A value of `true` indicates that the table is in a failed state.
message	string	Additional information about the status of the physical table, such as the cause of a failure. If the procedure to create, attach, or detach a global table fails, this parameter displays the reason for the failure.
role	string	The role of the physical table in the service pattern. Valid values: primary: The primary table. This value is returned for the active-passive mode. secondary: A secondary table. This value is returned for the active-passive mode. primary_eligible: A secondary table that is eligible to become a primary table. This value is returned for the active-passive mode. peer: A peer table. This value is returned for the multi-write mode.
rpoNanos	int64	The Recovery Point Objective (RPO) of the current data in the physical table. This value is approximately the same as the synchronization latency. The value is an `Instant` timestamp in nanoseconds. When converted using the default time zone of the system, this value can be displayed as a string, such as `2025-06-04 17:41:14`.