APScheduler任务调度快速入门实践_apscheduler中文文档

link之家

链接快照平台

输入网页链接，自动生成快照
标签化管理网页链接

什么是APScheduler

APScheduler是一个用于任务调度和定时任务管理的Python库。它提供了一个简单而灵活的方式来定义、调度和执行任务。

APScheduler的架构由以下几个核心组件组成：

调度器（Scheduler）：调度器负责管理任务的调度和执行。它可以根据预定的时间表触发任务的运行，支持不同类型的调度器（如定时、间隔、CRON表达式等）。
触发器（Trigger）：触发器定义了任务运行的时间触发条件。APScheduler提供了多种内置触发器，例如date触发器、interval触发器和cron触发器，用于定义不同类型的时间表。
作业（Job）：作业是需要调度和执行的任务。你可以定义自己的作业类，并在其中指定要执行的任务逻辑。
执行器（Executor）：执行器定义了任务的执行方式。APScheduler提供了不同的执行器，包括默认的线程执行器和进程执行器，以及基于异步框架的执行器（如Tornado、Twisted和Asyncio）。

如何正确选择

选择正确的调度器（scheduler）、作业存储（job store）、执行器（executor）和触发器（trigger）取决于环境以及如何使用APScheduler。根据应用程序使用的框架和技术，选择相应的调度器来与应用程序集成。下面是选择调度器的简要指南：

BlockingScheduler：当调度器是进程中唯一运行的内容时使用。
BackgroundScheduler：当没有使用下面提到的任何框架，并且希望调度器在应用程序内后台运行时使用。
AsyncIOScheduler：当应用程序使用asyncio模块时使用。
GeventScheduler：当应用程序使用gevent时使用。
TornadoScheduler：当正在构建一个Tornado应用程序时使用。
TwistedScheduler：当正在构建一个Twisted应用程序时使用。
QtScheduler：当正在构建一个Qt应用程序时使用。

其中，BlockingScheduler是最常用的调度器，适用于调度器是进程中唯一运行的情况。BackgroundScheduler适用于希望在应用程序内部以后台方式运行调度器的情况。而其他调度器如AsyncIOScheduler、GeventScheduler、TornadoScheduler、TwistedScheduler和QtScheduler适用于特定的框架和应用程序类型。

当安排一个作业时，需要选择一个触发器（trigger）。触发器确定作业运行时计算日期/时间的逻辑。APScheduler提供了三种内置的触发器类型：

date（日期）：在特定的时间点运行作业时使用。
interval（间隔）：在固定的时间间隔内运行作业时使用。
cron（定时）：在每天的特定时间点周期性地运行作业时使用。

还可以将多个触发器组合成一个触发器，它会在所有参与的触发器所约定的时间点触发，或者当任何一个触发器触发时激活。有关组合触发器的更多信息，请参阅相关文档。

添加作业/任务

有两种方法可以向调度器添加作业：

通过调用add_job()函数
通过使用@scheduled_job()装饰函数

add_job()方法是最常用的方法。@scheduled_job()方法主要是为了方便声明在应用程序运行时不会改变的作业。add_job()方法返回一个apscheduler.job.Job实例，可以使用该实例在以后修改或删除该作业。

可以随时在调度器上安排作业。如果在添加作业时调度器尚未运行，作业将被暂时安排，其第一次运行时间将在调度器启动时计算。

重要提示：如果使用序列化作业的执行器或作业存储，将对作业添加一些要求：

目标可调用函数必须是全局可访问的。
可调用函数的任何参数都必须是可序列化的。
在内置的作业存储中，只有MemoryJobStore不会序列化作业。在内置的执行器中，只有ProcessPoolExecutor会序列化作业。

快速安装与使用

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple apscheduler

APScheduler 使用起来还算是比较简单。运行一个调度任务只需要以下三部曲。

新建一个 schedulers (调度器) 。
添加一个调度任务(job stores)。
运行调度任务。

from datetime import datetime
import os
from apscheduler.schedulers.blocking import BlockingScheduler
def test_tick():
    print('The time is: %s' % datetime.now())
if __name__ == '__main__':
    scheduler = BlockingScheduler()
    scheduler.add_job(test_tick, 'cron',minute='20',second='50')
    try:
        scheduler.start()
    except (KeyboardInterrupt, SystemExit):
注意：任务启动超时的问题：增加misfire_grace_time参数，提高容错能力，如下代码。 
scheduler.add_job(set_pv_forecast, 'cron',hour = hour, minute = minute, second=second, misfire_grace_time=120)
如何使用ctrl+break键优雅退出服务
 
在程序最上面的代码中，加入如下内容。 
import signal
import sys
def exit_gracefully():
    sys.exit(0)
signal.signal(signal.SIGINT, exit_gracefully)
signal.signal(signal.SIGTERM, exit_gracefully)
南哥的天下. Python定时框架 Apscheduler 详解. 2014.06
 APScheduler User guide
				一. 介绍及基本案例
APScheduler用起来十分方便，提供了基于日期，时间间隔及crontab类型的任务。为我们提供了构建专用调度器或者调度服务的基础模块。
APScheduler不是一个守护进程或服务，它自身不带有任何命令行工具。它主要在现有的程序中运行，
安装：pip3 install apscheduler
一个简单的任务间隔实例
# -*- coding: utf-8 -*-
import os
from datetime import datetime
from apscheduler.sc
from apscheduler.schedulers.blocking import BlockingScheduler
scheduler = BlockingScheduler()
@scheduler.scheduled_job('cron', hour='8-23...
				文章目录前言一、pandas是什么？二、使用步骤1.安装库2.引入库3.时区设置4.添加定时任务5.暂停/恢复定时任务6.修改定时任务7.关闭定时任务8.读取定时任务9.总结
提示：以下是本篇文章正文内容，下面案例可供参考
一、pandas是什么？
APScheduler基于Quartz的一个Python定时任务框架，实现了Quartz的所有功能，使用起来十分方便。提供了基于日期、固定时间间隔以及crontab类型的任务，并且可以持久化任务。基于这些功能，我们可以很方便的实现一个python定时任务