HTAP系统函数

gs_htap_tmu_data(rel_oid oid, rowgroup_id integer)

描述：查看实时事务单元TMU中的活跃事务数据。当rowgroup_id为0时，返回表中所有活跃事务数据；当rowgroup_id非0时，返回表中指定行组中的活跃事务数据。

返回值类型：record

备注：必须是系统管理员或运维管理员才能执行此函数。

本函数对OLTP业务有一定影响，仅作为运维接口使用，且不建议频繁执行。

示例：

• 当enable_htap=off时：

  gaussdb=# select * from gs_htap_tmu_data(16796,0);
  ERROR:  Query failed due to ENABLE_HTAP is not enabled.

• 当enable_htap=on时：

  gaussdb=# select * from gs_htap_tmu_data(16796,0);
   rel_oid | rowgroup_id |  xid  | ctid  | flag
  ---------+-------------+-------+-------+-------
     16796 | 1           | 78437 | (0,1) | 16385
     16796 | 1           | 78437 | (0,2) | 16385
     16796 | 1           | 78439 | (0,1) | 4097
     16796 | 1           | 78439 | (0,2) | 4097
  (4 rows)

gs_htap_tmu_chunk_meta(rel_oid oid, rowgroup_id integer)

描述：查看实时事务单元TMU元数据信息。当rowgroup_id为0时，返回所有行组中的实时事务单元TMU数据信息；当rowgroup_id非0时，返回表中指定行组中的实时事务单元TMU数据信息。

返回值类型：record

备注：必须是系统管理员或运维管理员才能执行此函数。

示例：

• 当enable_htap=off时：

  gaussdb=# select * from gs_htap_tmu_chunk_meta(16796,0);
  ERROR:  Query failed due to ENABLE_HTAP is not enabled.

• 当enable_htap=on时：

  gaussdb=# select * from gs_htap_tmu_chunk_meta(16796,0);
   rel_oid | rowgroup_id | status | row_count | buffer_count | mem_usage | inprogress | completed
  ---------+-------------+--------+-----------+--------------+-----------+------------+-----------
     16796 | 1           | 1      | 4         | 1            |     65536 | 0.00%      | 100.00%
  (1 row)

gs_imcv_bgworker_status()

描述：显示执行IMCV表重建的bgworker的状态信息。

返回值类型：record

备注：必须是系统管理员或运维管理员才能执行此函数。

示例：

• 当enable_htap=off时：

  gaussdb=# select * from gs_imcv_bgworker_status();
  ERROR:  Query failed due to ENABLE_HTAP is not enabled.

• 当enable_htap=on时：

  gaussdb=# select * from gs_imcv_bgworker_status();
   worker_pid | relation_id | worker_status | start_time
  ------------+-------------+---------------+------------
            0 |           0 | finished      |
            0 |           0 | idle          |
            0 |           0 | idle          |
  (3 rows)

gs_imcv_flush(reloid oid)

描述：对数据库中指定的IMCV表立即进行一次重建，并显示重建的结果。重建过程将刷新IMCV表，移除旧数据并同步当前表的非活跃数据。

返回值类型：text

备注：必须是系统管理员或运维管理员才能执行此函数。

当IMCV表内的数据足够新鲜时，可能会跳过重建。本函数对OLTP业务有一定影响，仅作为运维接口使用，且不建议频繁执行。

示例：

• 当enable_htap=off时：

  gaussdb=# select * from gs_imcv_flush(16796);
  ERROR:  Manual row group rebuilding failed due to ENABLE_HTAP is not enabled.

• 当enable_htap=on时：

  gaussdb=# select * from gs_imcv_flush(16796);
                   gs_imcv_flush
  ------------------------------------------------
   2 row groups rebuilt successfully, 1 skipped.
  (1 row)

gs_imcv_taskbuffer_view()

描述：gs_imcv_taskbuffer_view显示HTAP业务中重建任务队列使用情况，入参为空。

返回值类型：record

备注：必须是系统管理员或运维管理员才能执行此函数。

示例：

• 当enable_htap=off时：

  gaussdb=# select * from gs_imcv_taskbuffer_view();
  ERROR:  Query failed due to ENABLE_HTAP is not enabled.

• 当enable_htap=on时：

  gaussdb=# select * from gs_imcv_taskbuffer_view();
   buffer_is_empty | buffer_is_full | buffer_used_space | buffer_free_space
  -----------------+----------------+-------------------+-------------------
   t               | f              |                 0 |               999
  (1 row)

gs_imcu_meta(rel_name)

描述：gs_imcu_meta用于显示指定rel_name的IMCV表下的IMCU元信息。

返回值类型：record

示例：

gaussdb=# SELECT * FROM gs_imcu_meta('test2');
I reloid | relname | imcu_xmin | imcu_id | row_count | imcu_size | imcu_mode | imcu_pointer | magic | attnum 
--------+---------+-----------+---------+-----------+-----------+-----------+--------------+-------+--------
 115114 | test2   |         0 |       1 |         9 |      8192 |         1 |            0 | 74802 |      0
 115114 | test2   |         0 |       1 |         9 |      8192 |         1 |            0 | 74802 |      1
 115114 | test2   |         0 |       1 |         9 |      8192 |         1 |            0 | 74802 |      2
 115114 | test2   |         0 |       1 |         9 |      8192 |         1 |            0 | 74802 |      3
 115114 | test2   |         0 |       1 |         9 |      8192 |         0 |            0 | 74802 |      4
 115114 | test2   |         0 |       1 |         9 |      8192 |         0 |            0 | 74802 |      5
(6 rows)

备注：该示例表示共有1个行组（imcu_id为1），每一行代表一个cu（其中attnum为0的列为ctid列），每个cu行数为9行。

gs_imcv_status()

描述：gs_imcv_status函数用于显示当前所有IMCV表的状态信息。

返回值类型：record

示例：

gaussdb=# SELECT * FROM gs_imcv_status();
 reloid | relname |  dbname  | username | parentoid | imcvstatus | imcvnattr |  imcvkey  | priority | rowgroup_num | cu_num_in_mem | cu_mem_size | cu_num_in_disk | cu_disk_size 
--------+---------+----------+----------+-----------+------------+-----------+-----------+----------+--------------+---------------+-------------+----------------+--------------
 115114 | test2   | postgres | lqy      |         0 | F          |         5 | 1 2 3 4 5 |        1 |            1 |             6 |       49152 |              0 |            0
(1 row)

gs_imcu_slot_status()

描述：gs_imcu_slot_status记录了IMCV表下的IMCU对应的缓存slot信息。

返回值类型：record

示例（flag为\x01表示缓存slot包含有效数据）：

gaussdb=# SELECT * FROM gs_imcu_slot_status();
 reloid | cu_id | col_id | slot_id | block_size | flag 
--------+-------+--------+---------+------------+------
 115114 |     1 |      1 |       0 |       8192 | \x01
 115114 |     1 |      2 |       1 |       8192 | \x01
 115114 |     1 |      3 |       2 |       8192 | \x01
 115114 |     1 |      4 |       3 |       8192 | \x01
 115114 |     1 |      5 |       4 |       8192 | \x01
 115114 |     1 |      0 |       5 |       8192 | \x01
(6 rows)