更新时间:2024-08-20 GMT+08:00

DBE_ILM_ADMIN

接口介绍

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

表1 DBE_ILM_ADMIN

接口名称

描述

CUSTOMIZE_ILM

根据输入参数定制ILM策略属性。

DISABLE_ILM

关闭后台调度。

ENABLE_ILM

开启后台调度。

当并发量较大时,执行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 (
       parameter            IN       int8,
       value                IN       int8);
    
    表2 DBE_ILM_ADMIN.CUSTOMIZE_ILM接口参数说明

    参数

    描述

    parameter

    参数序号。

    value

    参数取值。

    表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。

  • 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
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
(8 rows)