云数据库 GAUSSDB-DBE_HEAT_MAP:接口介绍

时间：2024-11-13 14:46:40

云数据库 GAUSSDB

接口介绍

根据输入的参数，返回目标数据块中行的最后修改时间等信息，用于直观浏览每一行被判定为冷、热行的依据。该接口属于运维类接口，不做可见性判断，即传入的ctid为已删除的行时，该接口依然会返回当前行在页面上最新的状态。

表1 DBE_HEAT_MAP
接口名称	描述
ROW_HEAT_MAP	根据对象所属Schema、数据对象名称、数据对象分区名及ctid获取行的最后修改时间等信息。

DBE_HEAT_MAP.ROW_HEAT_MAP

根据对象所属Schema、数据对象名称、数据对象分区名及ctid获取行的最后修改时间等信息，原型为：

    
         DBE_HEAT_MAP.ROW_HEAT_MAP(
OWNER           IN VARCHAR2,
SEGMENT_NAME    IN VARCHAR2,
PARTITION_NAME  IN VARCHAR2     DEFAULT NULL,
CTID            IN TEXT,
V_DEBUG         IN BOOL         DEFAULT FALSE);

表2 DBE_HEAT_MAP.ROW_HEAT_MAP接口参数说明
参数	描述
OWNER	数据对象所属Schema。
SEGMENT_NAME	数据对象名称。
PARTITION_NAME	数据对象分区名，可选参数，默认为 NULL。
CTID	目标行的ctid，即block_id或row_id。
V_DEBUG	debug调试，增加日志打印。

表3 DBE_HEAT_MAP.ROW_HEAT_MAP输出参数
参数	描述
OWNER	数据对象的所有者。
SEGMENT_NAME	数据对象名称。
PARTITION_NAME	数据对象分区名称，可选参数。
TABLESPACE_NAME	数据所属的表空间名称。
FILE_ID	行所属的绝对文件ID。
RELATIVE_FNO	行所属的相对文件ID（ GaussDB 中无此逻辑，因此取值同上）。
CTID	行的ctid，即block_id或row_id。
WRITETIME	行的最后修改时间。