如何在Ruby on Rails中用Whenever Gem每日执行Postgres查询定时任务

一、先优化你的SQL查询（可选但推荐） #

原查询用天数除以365计算年龄会忽略闰年、月份差等问题，PostgreSQL自带的AGE函数能更准确计算周岁：

SELECT ch.person_id AS child_id,
       EXTRACT(YEAR FROM AGE(current_date, ppl.date_of_birth)) AS current_age
FROM children ch
INNER JOIN people ppl ON ch.person_id = ppl.id
WHERE EXTRACT(YEAR FROM AGE(current_date, ppl.date_of_birth)) >= 5
LIMIT 500;

二、配置Whenever Gem #

1. 安装并初始化Gem

• 在Gemfile中添加：

  gem 'whenever', require: false
  

• 执行安装：

  bundle install
  

• 生成定时任务配置文件：

  rails generate whenever:config
  

  这会在config/目录下生成schedule.rb文件。

2. 编写执行查询的Rake任务

在lib/tasks/目录下新建文件child_age.rake，把查询逻辑封装成Rake任务（Rails标准存放位置）：

namespace :children do
  desc "每日筛选年龄≥5岁的儿童"
  task filter_over_five: :environment do
    # 替换成优化后的SQL（或你原有的SQL）
    sql = <<~SQL
      SELECT ch.person_id AS child_id,
             EXTRACT(YEAR FROM AGE(current_date, ppl.date_of_birth)) AS current_age
      FROM children ch
      INNER JOIN people ppl ON ch.person_id = ppl.id
      WHERE EXTRACT(YEAR FROM AGE(current_date, ppl.date_of_birth)) >= 5
      LIMIT 500;
    SQL

    # 执行查询并获取结果
    results = ActiveRecord::Base.connection.execute(sql)

    # 根据需求处理结果：示例是写入Rails日志，也可以导出CSV/存入其他表
    results.each do |row|
      Rails.logger.info "儿童ID: #{row['child_id']}, 当前年龄: #{row['current_age']}"
    end
  end
end

3. 配置定时任务

打开config/schedule.rb，添加每日执行的规则：

# 每天凌晨3点执行任务（可自定义时间）
every 1.day, at: '3:00 am' do
  rake 'children:filter_over_five'
end

4. 同步到系统Cron

执行命令将配置同步到服务器的Cron任务列表：

# 开发环境
whenever --update-crontab

# 生产环境需指定环境
whenever --update-crontab --set environment=production

• 验证是否成功：执行crontab -l，能看到新增的定时任务条目即为配置成功。

注意事项 #

• 确保服务器的Cron服务处于运行状态
• 如果任务需要处理大量数据，建议添加日志输出或错误捕获，方便排查问题
• 生产环境中，Rails环境变量、数据库连接配置需正确设置

内容的提问来源于stack exchange，提问作者Akash