# DBE_ILM_ADMIN #### 接口介绍 服务于ILM策略实施，实现ADO的后台调度以及各个限流参数的控制。 表1DBE_ILM_ADMIN | 接口名称 | 描述 | |:---|:---| | CUSTOMIZE_ILM | 根据输入参数定制ILM策略属性。 | | DISABLE_ILM | 关闭后台调度。 | | ENABLE_ILM | 开启后台调度。 | ![](https://support.huaweicloud.com/centralized-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 当并发量较大时，执行DBE_ILM_ADMIN.DISABLE_ILM或DBE_ILM_ADMIN.ENABLE_ILM可能会提示资源繁忙，稍后重试即可。提示内容为"Resources are busy, please try again later."。 - DBE_ILM_ADMIN.CUSTOMIZE_ILM 根据输入参数定制ILM策略属性，原型为： ``` DBE_ILM_ADMIN.CUSTOMIZE_ILM( PARAM IN NUMBER, VAL IN NUMBER); ``` 表2DBE_ILM_ADMIN.CUSTOMIZE_ILM接口参数说明 | 参数 | 描述 | |:---|:---| | PARAM | 参数序号。 | | VAL | 参数取值。 | ![](https://support.huaweicloud.com/centralized-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 由于兼容性影响，在B或M兼容模式下，若调用DBE_ILM_ADMIN.CUSTOMIZE_ILM()时传入的VAL值为非数字的字符，例如DBE_ILM_ADMIN.CUSTOMIZE_ILM(13, '\*')，会默认将传入的VAL值赋值为0。 表3DBE_ILM_ADMIN.CUSTOMIZE_ILM接口参数范围 | 参数编号 | 参数值 | 描述 | |:---|:---|:---| | 1 | EXECUTION_INTERVAL | ADO Task的执行频率，单位分钟，默认值15。取值范围为大于等于1小于等于2147483647的整数或浮点数，作用时向下取整。 | | 2 | RETENTION_TIME | ADO相关历史的保留时长，单位天，默认值30。取值范围为大于等于1小于等于2147483647的整数或浮点数，作用时向下取整。 | | 7 | ENABLE | 后台调度的状态。该参数不支持使用DBE_ILM_ADMIN.CUSTOMIZE_ILM修改，应使用DBE_ILM_ADMIN.DISABLE_ILM和DBE_ILM_ADMIN.ENABLE_ILM修改。 | | 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 关闭后台调度，原型为： ``` gaussdb=# DBE_ILM_ADMIN.DISABLE_ILM(); ``` - DBE_ILM_ADMIN.ENABLE_ILM 开启后台调度，原型为： ``` gaussdb=# DBE_ILM_ADMIN.ENABLE_ILM(); ``` 注意：后台调度生效需要先在数据库运维平台打开guc参数：enable_ilm。 #### 示例 ``` 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) ```