citus 常用功能与api——元数据/配置信息部分（翻译自v9.3）

翻译为个人兴趣，仅供学习参考，侵删

官方原文连接：http://docs.citusdata.com/en/v9.3/develop/api_metadata.html#coordinator-metadata

 

 

Metadata / Configuration Information

master_add_node

master_add_node（）函数在Citus元数据表pg_dist_node中的集群中注册一个新节点。 它还会将参考表复制到新节点。

参数

node_name: 要添加的新节点的DNS名称或IP地址。

node_port: PostgreSQL在工作程序节点上侦听的端口。

group_id: 一组由一台主服务器和零个或多个辅助服务器组成的组，仅与流复制相关。 默认值-1

node_role: 是“primary”还是“secondary”。 默认的“primary”。

node_cluster: 集群名称。 默认‘default’

返回值

表pg_dist_node中新插入的行的nodeid列。

举例

select * from master_add_node('new-node', 12345);
 master_add_node
-----------------
               7
(1 row)

master_update_node

master_update_node（）函数用来更改在Citus元数据表pg_dist_node中注册的节点的主机名和端口。

参数

node_id: pg_dist_node表中的节点ID。

node_name: 节点将要更新的DNS名称或IP地址。

node_port: PostgreSQL在工作节点上侦听的端口。

返回值

无

举例

select * from master_update_node(123, 'new-address', 5432);

master_set_node_property

master_set_node_property（）函数更改Citus元数据表pg_dist_node中的属性。 当前，它只能更改shouldhaveshards属性。

参数

node_name: 节点的DNS名称或IP地址。

node_port: PostgreSQL在工作节点上侦听的端口。

property: pg_dist_node中要更改的列，当前仅支持修改shouldhaveshard。

value: 列的新值

返回值

无

举例

SELECT * FROM master_set_node_property('localhost', 5433, 'shouldhaveshards', false);

master_add_inactive_node

与master_add_node相似，master_add_inactive_node函数在pg_dist_node中注册一个新节点。 但是，它将新节点标记为不活动（inactive），这意味着将不会在其中放置任何碎片。 此外，它不会将参考表复制到新节点。

参数

node_name: 要添加的新节点的DNS名称或IP地址。

node_port: PostgreSQL在工作程序节点上侦听的端口。

group_id: 一组由一台主服务器和零个或多个辅助服务器组成的组，仅与流复制相关。 默认值-1

node_role: 是“primary”还是“secondary”。 默认的“primary”。

node_cluster: 集群名称。 默认‘default’

返回值

表pg_dist_node中新插入的行的nodeid列。

举例

select * from master_add_inactive_node('new-node', 12345);
 master_add_inactive_node
--------------------------
                        7
(1 row)

master_activate_node

master_activate_node函数在Citus元数据表pg_dist_node中将节点标记为活动节点，并将参考表复制到该节点。 对于通过master_add_inactive_node添加的节点很有用。

参数

node_name: 要添加的新节点的DNS名称或IP地址。

node_port: PostgreSQL在工作程序节点上侦听的端口。

返回值

表pg_dist_node中新插入的行的nodeid列。

举例

select * from master_activate_node('new-node', 12345);
 master_activate_node
----------------------
                    7
(1 row)

master_disable_node

master_disable_node函数与master_activate_node相反。 它在Citus元数据表pg_dist_node中将节点标记为不活动，从而将其暂时从集群中删除。并且在禁用的节点中删除所有参考表。 要重新激活该节点，只需再次运行master_activate_node函数。

参数

node_name: 节点的DNS名称或IP地址。

node_port: PostgreSQL在工作程序节点上侦听的端口。

返回值

无

举例

select * from master_disable_node('new-node', 12345);

master_add_secondary_node

master_add_secondary_node（）函数在群集中为现有的主节点注册一个新的辅助节点。函数将更新Citus元数据表pg_dist_node。

参数

node_name: 要添加的新节点的DNS名称或IP地址。

node_port: PostgreSQL在工作程序节点上侦听的端口。

primary_name: 新建辅助节点对应的主节点的DNS名称或IP地址。

primary_port: PostgreSQL在主节点上侦听的端口。

node_cluster: 集群名称。 默认‘default’

返回值

新插入pg_dist_node表中的数据，辅助节点对应的nodeid列。

举例

select * from m