timescaledb_information.job_history

Timescale Cloud：性能、规模、企业级

自托管产品

MST

显示由自动化框架运行的作业信息。这包括自定义作业以及由策略运行的作业，这些策略用于管理数据保留、连续聚合、列式存储及其他自动化策略。有关自动化策略的更多信息，请参阅作业。

可用列

名称	类型	描述
`id`	INTEGER	用于标识作业执行的序列 ID
`job_id`	INTEGER	为实现策略而创建的后台作业的 ID
`succeeded`	BOOLEAN	作业成功运行时为 `TRUE`，失败时为 `FALSE`
`proc_schema`	TEXT	作业执行的函数或过程的模式名称
`proc_name`	TEXT	作业执行的函数或过程的名称
`pid`	INTEGER	执行作业的后台工作进程的进程 ID。如果作业崩溃，此项为 `NULL`
`start_time`	TIMESTAMP WITH TIME ZONE	作业开始时间
`finish_time`	TIMESTAMP WITH TIME ZONE	报告错误的时间
`config`	JSONB	执行时的作业配置
`sqlerrcode`	TEXT	与此错误相关的错误代码（如果有）。有关完整的错误代码列表，请参阅PostgreSQL 官方文档
`err_message`	TEXT	详细的错误消息

用法示例

检索近期作业信息


SELECT job_id, pid, proc_schema, proc_name, succeeded, config, sqlerrcode, err_message
FROM timescaledb_information.job_history
ORDER BY id, job_id;
 job_id |   pid   | proc_schema |    proc_name     | succeeded |   config   | sqlerrcode |   err_message    
--------+---------+-------------+------------------+-----------+------------+------------+------------------
   1001 | 1779278 | public      | custom_job_error | f         |            | 22012      | division by zero
   1000 | 1779407 | public      | custom_job_ok    | t         |            |            | 
   1001 | 1779408 | public      | custom_job_error | f         |            | 22012      | division by zero
   1000 | 1779467 | public      | custom_job_ok    | t         | {"foo": 1} |            | 
   1001 | 1779468 | public      | custom_job_error | f         | {"bar": 1} | 22012      | division by zero
(5 rows)

错误保留策略

timescaledb_information.job_history 信息视图定义在内部模式的 _timescaledb_internal.bgw_job_stat_history 表之上。为了防止此表过大，默认启用 Job History Log Retention Policy [3] 系统后台作业，配置如下：


job_id            | 3
application_name  | Job History Log Retention Policy [3]
schedule_interval | 1 mon
max_runtime       | 01:00:00
max_retries       | -1
retry_period      | 01:00:00
proc_schema       | _timescaledb_functions
proc_name         | policy_job_stat_history_retention
owner             | owner must be a user with WRITE privilege on the table `_timescaledb_internal.bgw_job_stat_history`
scheduled         | t
fixed_schedule    | t
config            | {"drop_after": "1 month"}
next_start        | 2024-06-01 01:00:00+00
initial_start     | 2000-01-01 00:00:00+00
hypertable_schema | 
hypertable_name   | 
check_schema      | _timescaledb_functions
check_name        | policy_job_stat_history_retention_check

在 Timescale 和 Managed Service for TimescaleDB 中，作业历史保留作业的所有者是 tsdbadmin。在本地安装中，作业的所有者与扩展所有者相同。保留作业的所有者可以更改和删除它。例如，所有者可以这样更改保留间隔：


SELECT alter_job(id,config:=jsonb_set(config,'{drop_after}', '"2 weeks"')) FROM _timescaledb_config.bgw_job WHERE id = 3;

timescaledb_information.job_history

可用列

用法示例

错误保留策略

相关内容