文档首页/ 数据仓库服务 GaussDB(DWS)/ 开发指南/ 标准数仓开发指南(8.1.3.x)/ 创建和管理GaussDB(DWS)数据库对象/ 创建和管理GaussDB(DWS)定时任务
更新时间：2024-10-10 GMT+08:00
查看PDF
分享

创建和管理GaussDB(DWS)定时任务

GaussDB(DWS)支持用户创建定时任务，当设置的任务时间点到达后可以自动触发任务的执行，从而可以减少用户运维的工作量。

数据库兼容Oracle定时任务功能主要通过DBMS.JOB高级包提供的接口，可以实现定时任务的创建、任务到期自动执行、任务删除、修改任务属性（包括：任务id、任务的关闭开启、任务的触发时间、触发时间间隔、任务内容等）。

  • 实时数仓（单机部署）暂不支持定时任务功能。
  • 定时任务的执行语句暂不记录到系统的实时TopSQL日志中，仅8.2.1及以上集群版本支持记录。
  • GaussDB(DWS) 时间设置默认为UTC时间，定时任务的执行时间需根据用户所在时区差进行转换。

定时任务管理

  1. 创建测试表： 

    1
    		 
    CREATE TABLE test(id int, time date);

    当结果显示为如下信息，则表示创建成功。

    1
    		 
    CREATE TABLE

  2. 创建自定义存储过程： 

    1
2
3
4
5
6
7
8
9
    		 
    CREATE OR REPLACE PROCEDURE PRC_JOB_1()
AS
N_NUM integer :=1;
BEGIN
FOR I IN 1..1000 LOOP
INSERT INTO test VALUES(I,SYSDATE);
END LOOP;
END;
/

    当结果显示为如下信息，则表示创建成功。

    1
    		 
    CREATE PROCEDURE

  3. 创建任务：

    • 新创建的任务（未指定job_id）表示每隔1分钟执行一次存储过程PRC_JOB_1。 
      1
2
3
4
5
      		 
      call dbms_job.submit('call public.prc_job_1(); ', sysdate, 'interval ''1 minute''', :a);
job
-----
1
(1 row)
    • 指定job_id创建任务。 
      1
2
3
4
5
      		 
      call dbms_job.isubmit(2,'call public.prc_job_1(); ', sysdate, 'interval ''1 minute''');
isubmit
---------

(1 row)

  4. 通过USER_JOBS视图查看当前用户已创建的任务信息。

    需要有系统管理员权限才可以访问此系统视图，字段说明详见表1。

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
    		 
    select job,dbname,start_date,last_date,this_date,next_date,broken,status,interval,failures,what from user_jobs;
 job |  dbname  |         start_date         |         last_date          |         this_date          |      next_date      | broken | status |      interval       | failures |           what

-----+----------+----------------------------+----------------------------+----------------------------+---------------------+--------+--------+---------------------+----------+----------------
-----------
   1 | db_demo | 2022-03-25 07:58:01.829436 | 2022-03-25 07:58:03.174817 | 2022-03-25 07:58:01.829436 | 2022-03-25 07:59:01 | n      | s      | interval '1 minute' |        0 | call public.prc
_job_1();
   2 | db_demo | 2022-03-25 07:58:15.893383 | 2022-03-25 07:58:16.608959 | 2022-03-25 07:58:15.893383 | 2022-03-25 07:59:15 | n      | s      | interval '1 minute' |        0 | call public.prc
_job_1();
(2 rows)

  5. 停止任务。 

    1
2
3
4
5
    		 
    call dbms_job.broken(1,true);
broken
--------

(1 row)

  6. 启动任务。 

    1
2
3
4
5
    		 
    call dbms_job.broken(1,false);
broken
--------

(1 row)

  7. 修改任务属性。

    • 修改JOB的Next_date参数信息。例如，修改Job1的Next_date为1小时以后开始执行。 
      1
2
3
4
5
      		 
      call dbms_job.next_date(1, sysdate+1.0/24);
next_date
-----------

(1 row)
    • 修改JOB的Interval参数信息。例如，修改Job1的Interval为每隔1小时执行一次。 
      1
2
3
4
5
      		 
      call dbms_job.interval(1,'sysdate + 1.0/24');
interval
----------

(1 row)
    • 修改JOB的What参数信息。例如，修改Job1的What为执行SQL语句“insert into public.test values(333, sysdate+5);”。 
      1
2
3
4
5
      		 
      call dbms_job.what(1,'insert into public.test values(333, sysdate+5);');
what
------

(1 row)
    • 同时修改JOB的Next_date、Interval、What等多个参数信息。 
      1
2
3
4
5
      		 
      call dbms_job.change(1, 'call public.prc_job_1();', sysdate, 'interval ''1 minute''');
change
--------

(1 row)

  8. 删除JOB。 

    1
2
3
4
5
    		 
    call dbms_job.remove(1);
remove
--------

(1 row)

  9. JOB的权限控制。

    • 当创建一个JOB时，该JOB会和创建该JOB的数据库和用户绑定（即：pg_job系统视图新增的JOB记录中的dbname和log_user）。
    • 如果当前用户是DBA用户、系统管理员、该JOB的创建用户（即：pg_job中的log_user），那么该用户有权限通过高级包接口remove、change、next_data、what、interval删除或修改JOB的参数信息。否则，会提示当前用户没有权限操作该JOB。
    • 如果当前数据库是该JOB创建所属的数据库（即：为pg_job系统视图中的dbname），那么连接到当前数据库上可以通过高级包接口remove、change、next_data、what、interval删除或修改JOB的参数信息。
    • 当删除JOB所属的数据库（即：为pg_job系统视图中的dbname）时，系统会关联删除该数据库从属的JOB记录。
    • 当删除JOB所属的用户（即：为pg_job系统视图中的log_user）时，系统会关联删除该用户从属的JOB记录。