DBE_ILM_ADMIN

接口介绍

服务于ILM策略实施，实现ADO的后台调度以及各个限流参数的控制。

当并发量较大时，执行DBE_ILM_ADMIN.DISABLE_ILM或DBE_ILM_ADMIN.ENABLE_ILM可能会提示资源繁忙，稍后重试即可。提示内容为“Resources are busy, please try again later.”。

• DBE_ILM_ADMIN.CUSTOMIZE_ILM

  根据输入参数定制ILM策略属性，原型为：

  1 2 3

  DBE_ILM_ADMIN.CUSTOMIZE_ILM( PARAM IN NUMBER, VAL IN NUMBER);

  表2 DBE_ILM_ADMIN.CUSTOMIZE_ILM接口参数说明

  参数	描述
  PARAM	参数序号。
  VAL	参数取值。

  表3 DBE_ILM_ADMIN.CUSTOMIZE_ILM接口参数范围

  参数编号	参数值	描述
  1	EXECUTION_INTERVAL	ADO Task的执行频率，单位分钟，默认值15。取值范围为大于等于1小于等于2147483647的整数或浮点数，作用时向下取整。
  2	RETENTION_TIME	ADO相关历史的保留时长，单位天，默认值30。取值范围为大于等于1小于等于2147483647的整数或浮点数，作用时向下取整。
  7	ENABLE	后台调度的状态，不支持在该接口中修改，提示Invalid argument value, ENABLED should be change by calling DBE_ILM_ADMIN.ENABLE_ILM and DBE_ILM_ADMIN.DISABLE_ILM。应使用disable_ilm()和enable()修改。
  11	POLICY_TIME	控制ADO的条件单位是天还是秒，秒仅用来做测试用。取值为： 0: ILM_POLICY_IN_DAYS（默认值） 1:ILM_POLICY_IN_SECONDS
  12	ABS_JOBLIMIT	控制一次ADO Task最多生成多少个ADO Job。取值范围为大于等于0小于等于2147483647的整数或浮点数，作用时向下取整。
  13	JOB_SIZELIMIT	控制单个ADO Job可以处理的最大字节数，单位兆。取值范围为大于等于1小于等于2147483647的整数或浮点数，作用时向下取整。
  14	WIND_DURATION	维护窗口持续时长，单位分钟，默认240分钟（4小时）；取值范围为大于等于0小于1440（24小时）的整数。
  15	BLOCK_LIMITS	控制实例级的行存压缩速率上限，默认是40；取值范围是0到10000（0表示不限制）；单位是block/ms，表示每毫秒最多压缩多少个block。
  16	ENABLE_META_COMPRESSION	是否开启header压缩，默认为0，取值范围为0（关闭）和1（开启）。 说明： 设置此参数为1时，对于单行数据较短的表，压缩率会有一定提升，但是访问压缩行的性能会有较大幅度的下降。若数据库多是单行数据较长的表，不建议开启此参数。
  17	SAMPLE_MIN	常量编码和等值编码采样步长最小值，默认为10，取值范围[1, 100]，支持小数输入，小数会自动向下取整。
  18	SAMPLE_MAX	常量编码和等值编码采样步长最大值，默认为10，取值范围[1, 100]，支持小数输入，小数会自动向下取整。
  19	CONST_PRIO	常量编码优先级，默认为40，取值范围[0, 100]，100表示关闭常量编码，支持小数输入，小数会自动向下取整。
  20	CONST_THRESHOLD	常量编码阈值，默认为90，取值范围[1, 100]，表示一列常量值的占比超过该阈值时进行常量编码，支持小数输入，小数会自动向下取整。
  21	EQVALUE_PRIO	等值编码优先级，默认为60，取值范围[0, 100]，100表示关闭等值编码，支持小数输入，小数会自动向下取整。
  22	EQVALUE_THRESHOLD	等值编码阈值，默认为80，取值范围[1, 100]，表示两列数据的等值比例超过该阈值时进行等值编码，支持小数输入，小数会自动向下取整。
  23	ENABLE_DELTA_ENCODE_SWITCH	差值编码开关，默认为1，支持小数输入，0表示关闭，1表示开启，小数会自动向下取整。
  24	LZ4_COMPRESSION_LEVEL	lz4压缩等级，默认为0，取值范围[0, 16]，支持小数输入，小数会自动向下取整。
  25	ENABLE_LZ4_PARTIAL_DECOMPRESSION	部分解压开关，默认为1，支持小数输入，0表示关闭，1表示开启，小数会自动向下取整。

• DBE_ILM_ADMIN.DISABLE_ILM

  关闭后台调度，原型为：

  1	gaussdb=# DBE_ILM_ADMIN.DISABLE_ILM();

• DBE_ILM_ADMIN.ENABLE_ILM

  开启后台调度，原型为：

  1	gaussdb=# DBE_ILM_ADMIN.ENABLE_ILM();

  注意：后台调度生效需要先在数据库运维平台打开guc参数：enable_ilm。

示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

gaussdb=# CALL DBE_ILM_ADMIN.CUSTOMIZE_ILM(1, 15);
 customize_ilm 
---------------

(1 row)
gaussdb=# select * from gs_adm_ilmparameters;
               name               | value 
----------------------------------+-------
 EXECUTION_INTERVAL               |    15
 RETENTION_TIME                   |    30
 ENABLED                          |     1
 POLICY_TIME                      |     0
 ABS_JOBLIMIT                     |    10
 JOB_SIZELIMIT                    |  1024
 WIND_DURATION                    |   240
 BLOCK_LIMITS                     |    40
 ENABLE_META_COMPRESSION          |     0
 SAMPLE_MIN                       |    10
 SAMPLE_MAX                       |    10
 CONST_PRIO                       |    40
 CONST_THRESHOLD                  |    90
 EQVALUE_PRIO                     |    60
 EQVALUE_THRESHOLD                |    80
 ENABLE_DELTA_ENCODE_SWITCH       |     1
 LZ4_COMPRESSION_LEVEL            |     0
 ENABLE_LZ4_PARTIAL_DECOMPRESSION |     1
(18 rows)