> ## Documentation Index
> Fetch the complete documentation index at: https://cockroachlabs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PAUSE SCHEDULES

export const InternalLink = ({version, path = "", children, ...props}) => {
  let detectedVersion = version || "stable";
  if (typeof window !== 'undefined' && !version) {
    const match = window.location.pathname.match(/\/docs\/([^/]+)/);
    if (match) {
      detectedVersion = match[1];
    }
  }
  const normalizedPath = path.startsWith("/") ? path.slice(1) : path;
  return <a href={`/docs/${detectedVersion}/${normalizedPath}`} {...props}>
      {children}
    </a>;
};

The `PAUSE SCHEDULES` <InternalLink path="sql-statements">statement</InternalLink> can be used to pause <InternalLink path="create-schedule-for-backup">backup schedules</InternalLink> and <InternalLink path="create-schedule-for-changefeed">changefeed schedules</InternalLink>.

After pausing a schedule, you can resume it with <InternalLink path="resume-schedules">`RESUME SCHEDULES`</InternalLink>.

## Required privileges

The following users can pause a schedule:

* Members of the <InternalLink path="security-reference/authorization#default-roles">`admin` role</InternalLink>. By default, the `root` user belongs to the `admin` role.
* Owners of a backup schedule, i.e., the user that <InternalLink path="create-schedule-for-backup">created the backup schedule</InternalLink>.
* Owners of a changefeed schedule, i.e., the user that <InternalLink path="create-schedule-for-changefeed">created the changefeed schedule</InternalLink>.

## Synopsis

<img src="https://mintcdn.com/cockroachlabs/ulDoMGhKYg9RNabd/images/sql-diagrams/v23.1/pause_schedule.svg?fit=max&auto=format&n=ulDoMGhKYg9RNabd&q=85&s=151dd9ad4848de6875a7960b93df12cb" alt="pause_schedule syntax diagram" style={{maxWidth: "100%", overflowX: "auto"}} width="397" height="81" data-path="images/sql-diagrams/v23.1/pause_schedule.svg" />

## Parameters

| Parameter      | Description                                                                                                                              |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `selectclause` | A <InternalLink path="selection-queries">selection query</InternalLink> that returns `id`(s) to pause.                                   |
| `scheduleID`   | The `id` of the schedule you want to pause, which can be found with <InternalLink path="show-schedules">`SHOW SCHEDULES`</InternalLink>. |

## Examples

### Pause a single schedule

```sql theme={"theme":{"light":"catppuccin-mocha","dark":"catppuccin-mocha"}}
> PAUSE SCHEDULE 589963390487363585;
```

```
PAUSE SCHEDULES 1
```

### Pause multiple schedules

To pause multiple schedules, nest a <InternalLink path="select-clause">`SELECT` clause</InternalLink> that retrieves `id`(s) inside the `PAUSE SCHEDULES` statement:

```sql theme={"theme":{"light":"catppuccin-mocha","dark":"catppuccin-mocha"}}
> PAUSE SCHEDULES WITH x AS (SHOW SCHEDULES) SELECT id FROM x WHERE label = 'schedule_database';
```

```
PAUSE SCHEDULES 4
```

In this example, all schedules with the label `schedule_database` are paused.

## See also

* <InternalLink path="manage-a-backup-schedule">Manage a Backup Schedule</InternalLink>
* <InternalLink path="backup">`BACKUP`</InternalLink>
* <InternalLink path="restore">`RESTORE`</InternalLink>
* <InternalLink path="create-changefeed">`CREATE CHANGEFEED`</InternalLink>
* <InternalLink path="show-backup">`SHOW BACKUP`</InternalLink>
* <InternalLink path="show-schedules">`SHOW SCHEDULES`</InternalLink>
* <InternalLink path="resume-schedules">`RESUME SCHEDULES`</InternalLink>
* <InternalLink path="drop-schedules">`DROP SCHEDULES`</InternalLink>
* <InternalLink path="pause-job">`PAUSE JOB`</InternalLink>
* <InternalLink path="pause-job">`RESUME JOB`</InternalLink>
* <InternalLink path="cancel-job">`CANCEL JOB`</InternalLink>
* <InternalLink path="take-full-and-incremental-backups">Take Full and Incremental Backups</InternalLink>
* <InternalLink path="cockroach-sql">Use the Built-in SQL Client</InternalLink>
* <InternalLink path="cockroach-commands">`cockroach` Commands Overview</InternalLink>
