Skip to content

Commit

Permalink
add custom content
Browse files Browse the repository at this point in the history
add custom content 2

Signed-off-by: Ran <[email protected]>
  • Loading branch information
ran-huang committed Jun 26, 2023
1 parent 48fde00 commit 1a58d86
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 0 deletions.
14 changes: 14 additions & 0 deletions sql-statements/sql-statement-admin-pause-ddl.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,13 +33,27 @@ ADMIN PAUSE DDL JOBS job_id [, job_id] ...;

If the pause fails, the specific reason for the failure is displayed.

<CustomContent platform="tidb">

> **Note:**
>
> + This statement can pause a DDL job, but other operations and environment changes (such as machine restarts and cluster restarts) do not pause DDL jobs except for cluster upgrades.
> + During the cluster upgrade, the ongoing DDL jobs are paused, and the DDL jobs initiated during the upgrade are also paused. After the upgrade, all paused DDL jobs will resume. The pause and resume operations during the upgrade are taken automatically. For details, see [TiDB Smooth Upgrade](/smooth-upgrade-tidb.md).
> + This statement can pause multiple DDL jobs. You can use the [`ADMIN SHOW DDL JOBS`](/sql-statements/sql-statement-admin-show-ddl.md) statement to obtain the `job_id` of a DDL job.
> + If the job to be paused has already been completed or is about to be completed, the pause operation will fail.
</CustomContent>
<CustomContent platform="tidb-cloud">

> **Note:**
>
> + This statement can pause a DDL job, but other operations and environment changes (such as machine restarts and cluster restarts) do not pause DDL jobs except for cluster upgrades.
> + During the cluster upgrade, the ongoing DDL jobs are paused, and the DDL jobs initiated during the upgrade are also paused. After the upgrade, all paused DDL jobs will resume. The pause and resume operations during the upgrade are taken automatically. For details, see [TiDB Smooth Upgrade](https://docs.pingcap.com/tidb/stable/smooth-upgrade-tidb).
> + This statement can pause multiple DDL jobs. You can use the [`ADMIN SHOW DDL JOBS`](/sql-statements/sql-statement-admin-show-ddl.md) statement to obtain the `job_id` of a DDL job.
> + If the job to be paused has already been completed or is about to be completed, the pause operation will fail.
</CustomContent>

## MySQL compatibility

This statement is a TiDB extension to MySQL syntax.
Expand Down
14 changes: 14 additions & 0 deletions sql-statements/sql-statement-admin-resume-ddl.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,13 +33,27 @@ ADMIN RESUME DDL JOBS job_id [, job_id] ...;

If the resume fails, the specific reason for the failure is displayed.

<CustomContent platform="tidb">

> **Note:**
>
> + During the cluster upgrade, the ongoing DDL jobs are paused, and the DDL jobs initiated during the upgrade are also paused. After the upgrade, all paused DDL jobs will resume. The pause and resume operations during the upgrade are taken automatically. For details, see [TiDB Smooth Upgrade](/smooth-upgrade-tidb.md).
> + This statement can resume multiple DDL jobs. You can use the [`ADMIN SHOW DDL JOBS`](/sql-statements/sql-statement-admin-show-ddl.md) statement to obtain the `job_id` of a DDL job.
> + A DDL job in other status (other than `paused`) cannot be resumed and the resume operation will fail.
> + If you try to resume a job more than once, TiDB reports an error `Error Number: 8261`.
</CustomContent>
<CustomContent platform="tidb-cloud">

> **Note:**
>
> + During the cluster upgrade, the ongoing DDL jobs are paused, and the DDL jobs initiated during the upgrade are also paused. After the upgrade, all paused DDL jobs will resume. The pause and resume operations during the upgrade are taken automatically. For details, see [TiDB Smooth Upgrade](https://docs.pingcap.com/tidb/stable/smooth-upgrade-tidb).
> + This statement can resume multiple DDL jobs. You can use the [`ADMIN SHOW DDL JOBS`](/sql-statements/sql-statement-admin-show-ddl.md) statement to obtain the `job_id` of a DDL job.
> + A DDL job in other status (other than `paused`) cannot be resumed and the resume operation will fail.
> + If you try to resume a job more than once, TiDB reports an error `Error Number: 8261`.
</CustomContent>

## MySQL compatibility

This statement is a TiDB extension to MySQL syntax.
Expand Down

0 comments on commit 1a58d86

Please sign in to comment.