bucket系统函数

描述：获取某个hashbucket表的数据分布情况。

参数说明：

返回值说明：

示例：

gaussdb=# select * from gs_bucket_get_data_distribution('bucket_table', 0, true);

 node_name | bucketnode | used_blocks | allocated_blocks 
-----------+------------+-------------+------------------
 datanode1 |          0 | 1           | 8
 datanode1 |          1 | 1           | 8
 datanode1 |          2 | 1           | 8
 datanode1 |          3 | 1           | 8
 datanode1 |          4 | 1           | 8
 datanode1 |          5 | 1           | 8
 datanode1 |          6 | 1           | 8
 datanode1 |          7 | 1           | 8
 datanode1 |          8 | 1           | 8
 datanode1 |          9 | 1           | 8
 datanode1 |         10 | 1           | 8
 datanode1 |         11 | 1           | 8
 datanode1 |         12 | 1           | 8
 datanode1 |         13 | 1           | 8
 datanode1 |         14 | 1           | 8
 datanode1 |         15 | 1           | 8
 datanode1 |         16 | 1           | 8
 datanode1 |         17 | 1           | 8
 datanode1 |         18 | 1           | 8
 datanode1 |         19 | 1           | 8
 datanode1 |         20 | 1           | 8
 datanode1 |         21 | 1           | 8
 datanode1 |         22 | 1           | 8
 datanode1 |         23 | 1           | 8
 datanode1 |         24 | 1           | 8
...(数据较多，仅展示部分) 

描述：获取完整的迁移计划。只支持在扩容期间内部调用，且只支持在CN上调用。

参数说明：

返回值说明：

描述：获取日志流传输状态。只支持在扩容期间内部调用。

参数：void

返回值说明：

描述：设置当前正在hashbucket重分布的数据库。只支持在扩容期间内部调用，且只支持在DN上调用。

参数说明：

• db_name：本次要重分布的数据库库名。
• bucketgroup：本次要重分布的bucketgroup，当前版本暂无任何作用。

返回值说明：void

gs_redis_parse_slicebucket_tranfer_file(plan_json CSTRING, type CSTRING)

描述：用于获取slicebucket搬迁计划。只支持在扩容期间内部调用，且只支持在CN上调用，当前版本暂不支持。

参数说明：

返回值类型：

gs_redis_get_slicebucket_plan()

描述：用于获取当前库的slicebucket迁移计划。只支持在扩容期间内部调用，且只支持在CN上调用，当前版本暂不支持。

参数：void

返回值说明：

描述：更新当前数据库所有hashbucket表的header。只支持在扩容期间内部调用，且只支持在CN上调用。

参数说明：

返回值类型：Boolean

描述：获取段页式表header。只支持在DN上调用。

参数说明：

返回值类型：header_info

示例：

gaussdb=#  SELECT * FROM gs_redis_local_get_segment_header('mytable', '256');
 gs_redis_local_get_segment_header
----------------------------------------------------------------------------------------------------------------------------
4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,...(数据较多，仅展示部分) 
(1 row)

描述：更新段页式表header。只支持在DN上调用。

参数说明：

返回值类型：void

示例：

gaussdb=#  SELECT * FROM gs_redis_local_update_segment_header('mytable', '4294967295,4294967295,4294967295,4294967295,....'); (数据较多，仅展示部分)
 gs_redis_local_update_segment_header
-------------------------------------------
 0 
(1 row)

描述：更新当前db所有hashbucket表本批次bucket的反向指针。只支持在扩容期间内部调用，且只支持在CN上调用。

参数说明：

返回值类型：void

描述：获取反向指针。只支持在扩容期间内部调用，且只支持在DN上调用。

参数说明：

返回值类型：void

描述：记录更新反向指针的Xlog。只支持在扩容期间内部调用，且只支持在DN上调用。

参数说明：

返回值类型：void

描述：修改hashbucket表在系统表中的relfrozenxid64值。只支持在扩容期间内部调用，且只支持在DN上调用。

参数说明：void

返回值类型：void

描述：修改新DN节点hashbucket表在系统表中的relfrozenxid64值。只支持在扩容期间内部调用，且只支持在CN上调用。

参数说明：

返回值类型：void

描述：修改DN节点next_xid值。只支持在扩容期间内部调用，且只支持在DN上调用。

参数说明：xid：预期next_xid的值

返回值类型：void

gs_redis_set_csn(csn BIGINT)

描述：修改DN节点next_csn值。只支持在扩容期间内部调用，且只支持在GTM_FREE模式下和DN上调用。

参数说明：

• csn：预期next_csn的值。

返回值类型：void

gs_redis_check_bucket_flush(dn_array NAME[])

描述：查询RTO回放私有buffer是否全部刷下去。只支持在扩容期间内部调用。

参数说明：

• dn_array：DN节点名称列表。

返回值类型：Boolean

描述：查询bucket扩容回放的刷页信息。

权限：只支持debug版本调用，只支持在扩容期间内部调用。

参数说明：

• isclean：BOOLEAN类型，是否清理刷页信息。

gs_redis_show_bucketxid(bucketid_list OIDVECTOR_EXTEND)

描述：查询指定bucket对应的bucketxid。只支持在扩容期间内部调用，且只支持在DN上调用。

参数说明：

• bucketid_list：bucket列表。

返回值类型：CSTRING

gs_redis_drop_bucket_files(plan_json CSTRING)

描述：删除源节点已经物理搬迁的rangebucket文件。只支持在扩容期间内部调用，且只支持在CN上调用，当前版本暂不支持。

参数说明：

返回值类型：BOOLEAN

gs_redis_drop_bucket_files(origin_group_id OID, target_group_id OID)

描述：删除源节点已经物理搬迁的文件。只支持在扩容期间内部调用，且只支持在CN上调用。

参数说明：

返回值类型：BOOLEAN

gs_redis_local_drop_bucket_files(bucketlist CSTRING, bucketnum SMALLINT)

描述：删除对应的bucket list。只支持在扩容期间内部调用，且只支持在DN上调用。

参数说明：

返回值类型：Boolean

描述：用于rangebucket表删除对应db的bucket list。只支持在扩容期间内部调用，且只支持在DN上调用，当前版本暂不支持。

参数说明：

返回值类型：Boolean

描述：更新当前数据库所有slicebucket表的header。只支持在扩容期间内部调用，且只支持在CN上调用，当前版本暂不支持。

入参：void

返回值类型：Boolean

描述：获取扩容重分布期间的UNDO回滚状态。仅支持在扩容期间内部调用。

参数说明：

返回值state为INT4类型，表示查询到的扩容重分布期间的UNDO回滚状态。根据参数值不同的返回值含义如下：

• 当mode=0时：
  • state = 0表示无待回滚事务，xmin > 监控点next_xid。
  • state = 1表示无待回滚事务，xmin <= 监控点next_xid。
  • state = 2表示有待回滚事务。
• 当mode=1时：
  • state=0表示无监控点next_xid之前的新增回滚事务。
  • state=1表示有监控点next_xid之前的新增回滚事务。
• 当mode=2时：
  • state=0表示无监控点next_xid之后的待回滚事务。
  • state=1表示有监控点next_xid之后的待回滚事务。