PostgreSQL Oracle 兼容性之 - DBMS_JOBS - Daily Maintenance - Timing Tasks(pgagent)

2 minute read

背景

在PostgreSQL中跑JOB任务的方法。

用到三个组件:

1、pgagent客户端,用于定时连接到PG数据库执行任务。

2、PostgreSQL pgagent数据库插件,必须在PostgreSQL数据库端编译安装pgagent 或 pgadmin(内部打包了pgagent)。包括一些表、函数、视图,被用于管理pgagent任务。

3、pgadmin GUI,结合pgagent数据库插件,可以使用pgadmin连接到pg数据库,并管理JOB任务。

调度信息存在哪里?

连接到目标库的postgres库中,执行create extension pgagent。

有哪些连接串,分别在哪里?

1、调度库postgres的连接串,也就是pgagent客户端连接数据库的连接串。

2、执行目标任务的数据库的连接串,也就是pgagent存在调度库postgres中的,每个任务中的连接串。

pic

http://www.postgresql.org/docs/current/static/libpq.html#libpq-connect

密码存在哪里更安全?

建议将数据库密码存在.pgpass或PGPASSFILE环境变量定义的密码文件中。

如果不存在密码文件中,你需要在连接串中配置,会显示出来。

pgagent 介绍

PostgreSQL 定时任务可以通过操作系统的定时任务功能来实现, 例如Linux 的crontab.

也可以通过pgagent插件来实现, pgagent插件可以安装在数据库端,也可以安装在远端.

pgagent的调度信息存储在PostgreSQL数据库的postgres库中, 可以通过pgadmin可以在图形化界面来配置调度表.

pgagent是一个后台进程, 会定期的读取配置好的调度信息, 根据调度信息执行job, 并记录执行日志.

一般来说建议将pgagent安装在本地数据库服务器中, 调度信息也存放在本地数据库的postgres库中, 那么在执行job时, pgagent连接本地数据库即可. 否则的话还需要配置目标库的密码, 建议用.pgpass来配置(并配置文件权限), 如果配置在命令行中可以被ps进程查看. 当然还是配置在数据库端最安全。

为了更方便的管理pgagent任务,可以使用pgadmin+pgagent插件来进行管理。

pgagent客户端的安装

首先下载pgagent :

http://git.postgresql.org/gitweb/?p=pgagent.git;a=summary

阅读README, 编译pgagent需要先安装以下软件 :

- A C/C++ compiler, such as GCC or Microsoft Visual C++ on Windows.    
- CMake 2.6 (from www.cmake.org)    
- A wxWidgets 2.8.x installation, configured per the requirements for    
  pgAdmin:    
  http://git.postgresql.org/gitweb/?p=pgadmin3.git;a=blob_plain;f=INSTALL;hb=HEAD    
- A PostgreSQL 8.3 or higher installation    

安装gcc

rpm -ivh gcc-4.1.2-51.el5    

安装cmake

tar -zxvf cmake-2.8.8.tar.gz    
cd cmake-2.8.8    
./bootstrap --prefix=/opt/cmake2.8.8    
gmake    
gmake install    

安装好后将cmake的bin目录放到PATH变量.

vi ~/.bash_profile    
export PATH=/opt/cmake2.8.8/bin:$PATH    
. ~/.bash_profile    

安装wxWidgets

wget http://prdownloads.sourceforge.net/wxwindows/wxGTK-2.8.12.tar.gz    
tar -zxvf wxGTK-2.8.12.tar.gz    
cd wxGTK-2.8.12    
./configure --enable-shared=no --enable-unicode=yes --prefix=/opt/wxGTK-2.8.12    
make    
make install    

将bin加入PATH

vi ~/.bash_profile    
export PATH=/opt/wxGTK-2.8.12/bin:$PATH    
export LD_LIBRARY_PATH=/opt/wxGTK-2.8.12/lib:$LD_LIBRARY_PATH    
. ~/.bash_profile    

安装PostgreSQL, 略.

PostgreSQL 10 on CentOS 6.x x64

yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm    
yum install -y https://download.postgresql.org/pub/repos/yum/10/redhat/rhel-6-x86_64/pgdg-centos10-10-2.noarch.rpm    
yum install -y postgresql10*      

PostgreSQL 10 on CentOS 7.x x64

yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm    
yum install -y https://download.postgresql.org/pub/repos/yum/10/redhat/rhel-7-x86_64/pgdg-centos10-10-2.noarch.rpm    
yum install -y postgresql10*      

将pg_config加入PATH

vi ~/.bash_profile    
export PATH=/opt/pgsql9.3/bin:$PATH    
. ~/.bash_profile    

安装pgagent

tar -zxvf pgagent-d6c5a80.tar.gz    
cd pgagent-d6c5a80    
ccmake ./    
  
生成配置    
 CMAKE_BUILD_TYPE                                                                                                                      
 CMAKE_INSTALL_PREFIX             修改为此项 /opt/pgagent                                                                                         
 PG_CONFIG_PATH                   /opt/pgsql9.3/bin/pg_config                                                                          
 STATIC_BUILD                     ON                                                                                                   
 WX_CONFIG_PATH                   /opt/wxGTK-2.8.12/bin/wx-config                                                                      
 WX_DEBUG                         OFF    
    
按c配置,然后按g产生配置    
    
接下来就可以编译安装了    
    
make    
make install    

配置.bash_profile

vi ~/.bash_profile    
export PATH=/opt/pgagent/bin:$PATH    
. ~/.bash_profile    

在本地库的postgres库中创建调度信息, 表, 函数 :

psql -h 127.0.0.1 -p 1999 -U postgres -d postgres -f /opt/pgagent/share/pgagent.sql    

安装好后, 使用pgadmin连接到本地库就可以看到jobs选项 :

pic

pgagent 详细使用文档

https://www.pgadmin.org/docs/pgadmin4/1.x/pgagent.html

pgagent 配置举例

安装pgagent插件

create extensioin pgagent;  
  
create extension plpgsql;  -- 通常plpgsql默认已经安装了  

创建pgagent插件后就可以使用pgadmin配置job了.

启动pgagent客户端.

pgagent是一个后台进程, 时刻要去读取存储在数据库中的调度信息以执行定时任务. 所以首先要启动pgagent.

[root@db-172-16-3-33 ~]# pgagent --help    
  
Usage:  
  /path/to/pgagent [options] <connect-string>  
  
options:  
  -f run in the foreground (do not detach from the terminal)  
  -t <poll time interval in seconds (default 10)>  
  -r <retry period after connection abort in seconds (>=10, default 30)>  
  -s <log file (messages are logged to STDOUT if not specified)>  
  -l <logging verbosity (ERROR=0, WARNING=1, DEBUG=2, default 0)>  

例如, -t 1表示每秒读取一次调度数据 :

pgagent -t 1 -l 2 -s /var/log/pgagent.log hostaddr=127.0.0.1 port=1999 dbname=postgres user=postgres    

建议不要把password配置在命令行中, 尽量配置在密码文件中,例如 :

vi ~/.pgpass    
  
127.0.0.1:1999:postgres:postgres:postgres    
chmod 400 ~/.pgpass    

案例1 :

需求 : 在本地数据库中定时执行sql

job配置

https://www.pgadmin.org/docs/pgadmin4/1.x/pgagent_jobs.html

1. 在pgadmin的jobs上右键新建job.

2. 在属性栏配置job name, 例如j1.

3. 在steps中新建并配置step name, 本地库名;

在定义栏配置要执行的sql :

create table if not exists test_sum(sdate date, cnt int8);    
insert into test_sum select current_date,count(*) from pg_class group by current_date;    

可以配置多个step, 执行时按名称以及step id排序执行 :

// job.cpp - pgAgent job    
    
int Job::Execute()    
{    
        int rc = 0;    
        bool succeeded = false;    
        DBresult *steps = threadConn->Execute(    
                              wxT("SELECT * ")    
                              wxT("  FROM pgagent.pga_jobstep ")    
                              wxT(" WHERE jstenabled ")    
                              wxT("   AND jstjobid=") + jobid +    
                              wxT(" ORDER BY jstname, jstid"));    

4. 在schedule栏中新建并配置调度名, 开始时间, 如果有结束时间的话还需要配置结束时间.

days中可以配置周, 月, 日

times中可以配置小时, 分钟.

exceptions中配置排他.

配置完后, 在steps以及jos的统计信息栏可以看到每次JOB或者step执行的情况.

案例2 :

需求 : 定时执行脚本(batch)

脚本配置

[root@db-172-16-3-33 ~]# cat /root/b.sh    
#!/bin/bash    
psql -h 127.0.0.1 -p 1999 -U postgres postgres <<EOF    
create table if not exists t(id int);    
insert into t values (1);    
EOF    
exit $?    
chmod 500 b.sh    

以上假设pgagent是以root用户执行的. 否则要考虑脚本的可执行权限.

job配置, 同上

schedule配置, 同上

step配置, 选择batch, 不需要选择数据库. 定义中输入/root/b.sh .其他同上.

案例3 :

需求 : 在远程数据库中定时执行SQL

job配置, 同上.

schedule配置, 同上.

step配置, 需要输入远程数据库的连接信息. 密码配置在conn string中. 所以不安全.

例如 :

hostaddr=172.16.3.150 port=1000 user=postgres dbname=postgres password=pwd    

这里支持.pgpass. 所以建议不要使用远程定时任务.

连接信息参考 :

http://www.postgresql.org/docs/devel/static/libpq-connect.html

EnterpriseDB (EDB PPAS)

如果你用的是ppas,请下载ppas的版本。 用法与上面类似。

https://www.enterprisedb.com/software-downloads-postgres

https://www.enterprisedb.com/tut-how-use-pgagent-postgres-plus

pg_cron

pg_cron也是一个PG的JOB管理插件,启动work process进行管理,不需要再部署一台pgagent客户端了。

https://github.com/citusdata/pg_cron

参考

1. http://www.postgresql.org/docs/devel/static/libpq-connect.html

2. http://pgadmin.org/

3. https://www.pgadmin.org/docs/pgadmin4/1.x/pgagent.html

4. http://www.postgresonline.com/journal/archives/19-Setting-up-PgAgent-and-Doing-Scheduled-Backups.html

5. https://www.2cto.com/database/201305/208271.html

Flag Counter

digoal’s 大量PostgreSQL文章入口