Warning:
This version of CockroachDB is no longer supported. For more details, see the Release Support Policy.

The PAUSE JOB statement lets you pause IMPORT jobs, enterprise BACKUP and RESTORE jobs, and, as of v2.1, changefeeds.

After pausing jobs, you can resume them with RESUME JOB.

Note:
You cannot pause schema changes.

Required privileges

By default, only the root user can control a job.

Synopsis

PAUSE JOB job_id JOBS select_stmt

Parameters

Parameter Description
job_id The ID of the job you want to pause, which can be found with SHOW JOBS.
select_stmt A selection query that returns job_id(s) to pause.

Examples

Pause a single job

copy
icon/buttons/copy
> SHOW JOBS;
+----------------+---------+-------------------------------------------+...
|       id       |  type   |               description                 |...
+----------------+---------+-------------------------------------------+...
| 27536791415282 | RESTORE | RESTORE db.* FROM 'azure://backup/db/tbl' |...
+----------------+---------+-------------------------------------------+...
copy
icon/buttons/copy
> PAUSE JOB 27536791415282;

Pause multiple jobs

New in v2.1: To pause multiple jobs, nest a SELECT clause that retrieves job_id(s) inside the PAUSE JOBS statement:

copy
icon/buttons/copy
> PAUSE JOBS (SELECT job_id FROM [SHOW JOBS]
      WHERE user_name = 'maxroach');

All jobs created by maxroach will be paused.

See also



YesYes NoNo