-
pg_collation_actual_version (oid) 描述：返回当前安装在操作系统中的该排序规则对象的实际版本，目前仅对case_insensitive有效。 返回值类型：text 示例： 1
2
3
4
5
6
7
8
9
10
11 SELECT oid FROM pg_collation WHERE collname ='case_insensitive';
oid
------
3300
(1 row)
SELECT pg_collation_actual_version(3300);
pg_collation_actual_version
-----------------------------
153.14
(1 row)
-
pg_database_size(name) 描述：指定名称的数据库使用的磁盘空间。 返回值类型：bigint 备注：pg_database_size接受一个数据库的OID或者名称，然后返回该对象使用的全部磁盘空间。 示例： 1
2
3
4
5 gaussdb=# SELECT pg_database_size('testdb');
pg_database_size
------------------
51590112
(1 row)
pg_database_size(oid/name)函数的查询耗时与该oid/name所对应数据库中的对象文件数目相关，基本呈线性关系。如需进行耗时评估，可参考以下步骤： 由于耗时与软硬件环境有关，因此需要以某个库（所选择库的对象文件数目不宜过多）的测试结果为基准。根据查询耗时和库中对象文件数目，计算出单个对象文件的耗时database_size_t。 使用select oid,* from pg_database where datname = 'database';查询获取需要查询库的OID，在表空间base和pg_tblspc目录下统计该OID目录下的所有文件数目database_obj_num。如果该目录中包含子目录，则需要进入查看对象文件数目，依次类推；使用ls | wc -l查询目录下文件数目。 根据基准测试结果中的单文件耗时database_size_t和数据库下所有对象文件数目database_obj_num计算预估总耗时，总耗时 = database_size_t * database_obj_num。如果预估时延过长，需考虑调整执行超时阈值，避免出现不必要的告警。
-
datalength(any) 描述：计算一个指定的数据需要的字节数（不考虑数据的管理空间和数据压缩，数据类型转换等情况）。 返回值类型：int 备注：datalength用于计算某个独立数据值的空间。 示例： gaussdb=# SELECT datalength(1);
datalength
------------
4
(1 row) 目前支持的数据类型及计算方式见下表： 数据类型 存储空间 数值类型 整数类型 TINYINT 1 SMALLINT 2 INTEGER 4 BINARY_INTEGER 4 BIGINT 8 任意精度型 DECIMAL 每4位十进制数占两个字节，小数点前后数字分别计算。 NUMERIC 每4位十进制数占两个字节，小数点前后数字分别计算。 NUMBER 每4位十进制数占两个字节，小数点前后数字分别计算。 序列整型 SMALLSERIAL 2 SERIAL 4 BIGSERIAL 8 LARGESERIAL 每4位十进制数占两个字节，小数点前后数字分别计算。 浮点类型 FLOAT4 4 DOUBLE PRECISION 8 FLOAT8 8 BINARY_DOUBLE 8 FLOAT[(p)] 每4位十进制数占两个字节，小数点前后数字分别计算。 DEC[(p[,s])] 每4位十进制数占两个字节，小数点前后数字分别计算。 INTEGER[(p[,s])] 每4位十进制数占两个字节，小数点前后数字分别计算。 布尔类型 布尔类型 BOOLEAN 1 字符类型 字符类型 CHAR n CHAR(n) n CHARACTER(n) n NCHAR(n) n VARCHAR(n) n CHARACTER 字符实际字节数。 VARYING(n) 字符实际字节数。 VARCHAR2(n) 字符实际字节数。 NVARCHAR(n) 字符实际字节数。 NVARCHAR2(n) 字符实际字节数。 TEXT 字符实际字节数。 CLOB 字符实际字节数。 时间类型 时间类型 DATE 8 TIME 8 TIMEZ 12 TIMESTAMP 8 TIMESTAMPZ 8 SMALLDATETIME 8 INTERVAL DAY TO SECOND 16 INTERVAL 16 RELTIME 4 ABSTIME 4 TINTERVAL 12
-
get_db_source_datasize() 描述：估算当前数据库非压缩态的数据总容量。 返回值类型：bigint 备注：调用该函数前需要做analyze。 示例： 1
2
3
4
5
6
7 gaussdb=# analyze;
ANALYZE
gaussdb=# SELECT get_db_source_datasize();
get_db_source_datasize
------------------------
35384925667
(1 row)
-
pg_relation_filenode(relation regclass) 描述：指定关系的文件节点数。 返回值类型：oid 备注：pg_relation_filenode接受一个表、索引、序列或压缩表的OID或者名称，并且返回当前分配给它的“filenode”数。文件节点是关系使用的文件名称的基本组件。对大多数表来说，结果和pg_class.relfilenode相同，但对确定的系统目录来说， relfilenode为0而且这个函数必须用来获取正确的值。如果传递一个没有存储的关系，比如一个视图，那么这个函数返回NULL。
-
pg_partition_filepath(partition_oid) 描述：指定分区的文件路径名。只能用于非段页式关系。 返回值类型：text 备注：段页式关系建议使用段页式相关函数或视图，例如： SELECT e.*, f.file_name
FROM gs_seg_extents e, gs_seg_datafiles f
WHERE e.tablespace_name = f.tablespace_name ADN e.bucketnode = f.bucketnode ADN e.file_id = f.file_id ADN e.forknum = f.forknum;
-
pg_relation_filepath(relation regclass) 描述：指定关系的文件路径名。只能用于非段页式关系。 返回值类型：text 备注：pg_relation_filepath类似于pg_relation_filenode，但是它返回关系的整个文件路径名（相对于数据库集群的数据目录PGDATA）。 段页式关系建议使用段页式相关函数或视图，例如： SELECT e.*, f.file_name
FROM gs_seg_extents e, gs_seg_datafiles f
WHERE e.tablespace_name = f.tablespace_name AND e.bucketnode = f.bucketnode ADN e.file_id = f.file_id ADN e.forknum = f.forknum;
-
pg_obs_file_size(text, text) 描述：指定列存V3版本表(主表名,分区表)的某个分区，返回其在OBS上存储的CU文件大小、文件名、bucket号。该函数仅9.1.0及以上集群版本支持。 参数：入参可以是表的OID或者表名，分区名则直接使用分区名。 返回值类型：record 名称 类型 描述 bucketid integer CU文件存储的bucket号 filename text CU文件名 size bigint CU文件大小，单位为字节
-
get_db_source_datasize() 描述：估算当前数据库非压缩态的数据总容量。 返回值类型：bigint 备注：（1）调用该函数前需要做analyze；（2）通过估算列存的压缩率计算非压缩态的数据总容量。 示例： 1
2
3
4
5
6
7 analyze;
ANALYZE
SELECT get_db_source_datasize();
get_db_source_datasize
------------------------
35384925667
(1 row)
-
pg_obs_file_size(regclass) 描述：指定列存V3版本表OID或者表名字，获取其在OBS上存储的CU文件大小、文件名、bucket号。该函数仅9.1.0及以上集群版本支持。 参数：入参可以是表的OID或者表名。 返回值类型：record 表1 返回字段 名称 类型 描述 bucketid integer CU文件存储的bucket号。 filename text CU文件名。 size bigint CU文件大小，单位为字节。 示例： 1
2
3
4
5
6
7
8 SELECT * FROM pg_obs_file_size('t3_col_part_dif_partition');
bucketid | filename | size
----------+------------------+------
9 | 23488119324673.0 | 512
22 | 23488102760449.0 | 512
21 | 23488119521281.0 | 512
16 | 23488102662145.0 | 512
(4 rows)
-
pg_database_size(name) 描述：指定名称的数据库使用的磁盘空间。 返回值类型：bigint 备注：pg_database_size接收一个数据库的OID或者名字，然后返回该对象使用的全部磁盘空间。 示例： 1
2
3
4
5 SELECT pg_database_size('gaussdb');
pg_database_size
------------------
51590112
(1 row)
-
reload_cold_partition(relname text，partname text) 描述：用于将指定冷热表的特定冷分区转换成热分区。返回的数值为执行该函数切换分区的个数。该函数仅8.3.0及以上版本支持。 参数： relname：表名（指定冷热表的表名，使用其他非冷热表的表名，并不会报错，返回值为0）。 partname：分区名（指定冷热表下的分区名）。 返回值类型：integer 12345 SELECT reload_cold_partition('multi_temper_table','p1'); reload_cold_partition--------------------- 1(1 row)
-
refresh_hot_storage(relname text) 描述：用于将指定冷热表的所有分区数据全部刷到OBS上。返回的数值为执行该函数切换分区的个数。该函数仅8.2.1.100及以上版本支持。 参数： relname：表名(指定冷热表的表名，使用其他非冷热表的表名，并不会报错，返回值为0) 返回值类型：integer 12345 SELECT refresh_hot_storage('multi_temper_table'); refresh_hot_storage--------------------- 4(1 row)
-
refresh_hot_storage(relname text，partname text) 描述：用于将指定冷热表的分区数据刷到OBS上。返回的数值为执行该函数切换分区的个数。该函数仅8.2.1.100及以上版本支持。 参数： relname：表名（指定冷热表的表名，使用其他非冷热表的表名，并不会报错，返回值为0）。 partname：分区名（指定冷热表下的分区名）。 返回值类型：integer 12345 SELECT refresh_hot_storage('multi_temper_table','p1'); refresh_hot_storage--------------------- 1(1 row)
-
reload_cold_partition(relname text) 描述：用于将指定冷热表的所有冷分区转换成热分区。返回的数值为执行该函数切换分区的个数。该函数仅8.3.0及以上版本支持。 参数： relname：表名（指定冷热表的表名，使用其他非冷热表的表名，并不会报错，返回值为0）。 返回值类型：integer 12345 SELECT reload_cold_partition('multi_temper_table'); reload_cold_partition--------------------- 4(1 row)
