Help Center/ GaussDB/ Developer Guide(Centralized_V2.0-2.x)/ System Catalogs and System Views/ System Catalogs/ PGXC_NODE
Updated on 2025-08-19 GMT+08:00
View PDF

PGXC_NODE

PGXC_NODE stores information about database instance nodes. PGXC_NODE can only be used to query table definitions in centralized mode.

Table 1 PGXC_NODE columns

Name

Type

Description

oid

oid

Row identifier (hidden attribute, which must be specified)

node_name

name

Node name

node_type

"char"
Node type
  • C: CN
  • D: DN
  • S: standby node

node_port

integer

Port number of the node

node_host

name

Host name or IP address of a node. (If a virtual IP address is configured, its value is a virtual IP address.)

node_port1

integer

Port number of a replication node

node_host1

name

Host name or IP address of a replication node. (If a virtual IP address is configured, its value is a virtual IP address.)

hostis_primary

boolean

Specifies whether a primary/standby switchover occurs on the current node.

  • t (true): yes
  • f (false): no

nodeis_primary

boolean

Specifies whether the current node is preferred to execute non-query operations in the replication table.

  • t (true): yes
  • f (false): no

nodeis_preferred

boolean

Specifies whether the current node is preferred to execute queries in the replication table.

  • t (true): yes
  • f (false): no

node_id

integer

Node ID. The value is obtain by calculating the value of node_name using the hash function.

sctp_port

integer

Port used by the TCP proxy communications library of the primary node to listen to the data channel. (The SCTP communications library is no longer supported in the current version.)

control_port

integer

Port used by the TCP proxy communications library of the primary node to listen to the control channel

sctp_port1

integer

Port used by the TCP proxy communications library of the standby node to listen to the data channel. (The SCTP communications library is no longer supported in the current version.)

control_port1

integer

Port used by the TCP proxy communications library of the standby node to listen to the control channel

nodeis_central

boolean

Specifies whether the current node is a CN. It is invalid for DNs.

  • t (true): yes
  • f (false): no

nodeis_active

boolean

Specifies whether the current node is normal. It is invalid for DNs.

  • t (true): yes
  • f (false): no
Parent topic: System Catalogs