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

时间：2024-11-01 17:13:53

云数据库 GAUSSDB

接口介绍

根据输入的参数，评估指定数据对象的采样压缩率或者获取指定行数据的压缩类型。

表1 DBE_COMPRESSION
接口名称	描述
GET_COMPRESSION_RATIO	根据输入参数评估指定数据对象的采样压缩率。
GET_COMPRESSION_TYPE	根据输入参数获取指定行数据的压缩类型。

GET_COMPRESSION_TYPE接口只支持分布式数据库中数据节点（DN），其他节点暂不支持。

DBE_COMPRESSION.GET_COMPRESSION_RATIO

根据输入参数评估指定数据对象的采样压缩率，原型为：

    
         DBE_COMPRESSION.GET_COMPRESSION_RATIO (
scratchtbsname   IN  TEXT,
ownname          IN  TEXT,
objname          IN  TEXT,
subobjname       IN  TEXT,
comptype         IN  INTEGER,
blkcnt_cmp       OUT INTEGER,
blkcnt_uncmp     OUT INTEGER,
row_cmp          OUT INTEGER,
row_uncmp        OUT INTEGER,
cmp_ratio        OUT NUMBER,
comptype_str     OUT VARCHAR2,
sample_ratio     IN  NUMBER  DEFAULT 20, 
objtype          IN  INTEGER DEFAULT 1);

表2 DBE_COMPRESSION.GET_COMPRESSION_RATIO接口参数说明
参数	描述
scratchtbsname	数据对象所属表空间。
ownname	数据对象所有者（所属模式）。
objname	数据对象名称。
subobjname	数据子对象名称。
comptype	压缩类型，支持： 1：未压缩 2：高级压缩。
blkcnt_cmp	采样行行压缩后占页面数。
blkcnt_uncmp	采样行未压缩时占页面数。
row_cmp	单页面容纳压缩行数。
row_uncmp	单页面容纳非压缩行数量。
cmp_ratio	压缩率。
comptype_str	压缩类型字符串。
sample_ratio	采样率。
objtype	对象类型，支持： 1：表对象。

DBE_COMPRESSION.GET_COMPRESSION_TYPE

根据输入参数获取指定行数据的压缩类型，该接口属于运维类接口，不做可见性判断，即传入的ctid为已删除的行时，该接口依然会返回当前行在页面上最新的状态，原型为：

    
         DBE_COMPRESSION.GET_COMPRESSION_TYPE (
ownname          IN  TEXT,
tablename        IN  TEXT,
ctid             IN  INTEGER,
subobjname       IN  TEXT    DEFAULT NULL,
comptype         OUT INTEGER);

表3 DBE_COMPRESSION.GET_COMPRESSION_TYPE接口参数说明
参数	描述
ownname	数据对象所有者（所属模式）。
tablename	数据对象名称。
ctid	目标行ctid。
subobjname	数据子对象名称。
comptype	压缩类型，支持： 1：未压缩 2：高级压缩。