Tous les produits
Search
Centre de documentation

PolarDB:SHOW DDL

Dernière mise à jour :Aug 11, 2026

Dans PolarDB-X, chaque instruction DDL s'exécute en tant que tâche DDL. Utilisez SHOW DDL pour consulter les tâches DDL actives et récentes de votre instance.

Syntaxe

SHOW [FULL] DDL;

Exemple

L'exemple suivant présente le résultat de SHOW DDL\G pour une tâche ALTER TABLE suspendue. Les champs BACKFILL_PROGRESS et PHY_DDL_PROGRESS correspondant à des sous-phases internes distinctes, leurs valeurs peuvent différer du PROGRESS global.

SHOW DDL\G;
*************************** 1. row ***************************
           JOB_ID: 1359947811109470208
    OBJECT_SCHEMA: d1
      OBJECT_NAME: t2
           ENGINE: DAG
         DDL_TYPE: ALTER_TABLE
            STATE: PAUSED
BACKFILL_PROGRESS: 0%
 PHY_DDL_PROGRESS: 100%
         PROGRESS: 20%
       START_TIME: 2021-08-05 11:01:25.291
         END_TIME: 2021-08-05 11:02:27.020
 ELAPSED_TIME(MS): 61729
      PHY_PROCESS:
       CANCELABLE: true
1 row in set (0.03 sec)

Paramètres de réponse

Paramètre Description
JOB_ID Identifiant unique de la tâche DDL. Entier signé 64 bits de type LONG.
OBJECT_SCHEMA Nom du schéma de l'objet concerné par la tâche DDL.
OBJECT_NAME Nom de l'objet concerné par la tâche DDL (par exemple, nom de la table pour une tâche CREATE TABLE ou ALTER TABLE).
ENGINE Type de moteur de la tâche DDL. Valeur par défaut : DAG.
DDL_TYPE Type de la tâche DDL, tel que CREATE_TABLE ou ALTER_TABLE.
STATE État actuel de la tâche DDL. Valeurs valides : QUEUED, RUNNING, COMPLETED, ROLLBACK_RUNNING, ROLLBACK_COMPLETED, PAUSED. Pour plus d'informations sur les transitions d'état, consultez la section États des tâches DDL.
BACKFILL_PROGRESS Progression du remplissage des données dans la tâche DDL.
PHY_DDL_PROGRESS Progression de l'exécution par lots des instructions DDL physiques au sein de la tâche.
PROGRESS Progression globale de la tâche DDL.
START_TIME Heure de début de la tâche DDL.
END_TIME Heure de fin de la tâche DDL.
ELAPSED_TIME(MS) Temps écoulé depuis le début de la tâche DDL, en millisecondes.
PHY_PROCESS État des instructions DDL physiques en cours d'exécution.
CANCELABLE Indique si la commande CANCEL DDL permet d'annuler la tâche DDL. La valeur true signifie que la tâche peut être annulée.

États des tâches DDL

Le champ STATE indique la phase actuelle d'une tâche DDL. Le diagramme suivant illustre les transitions entre états :

456789

En fonctionnement normal, une tâche DDL suit la progression suivante : QUEUED → RUNNING → COMPLETED.

En cas d'exception, la tâche peut faire l'objet d'un retour arrière automatique selon le flux suivant : QUEUED → RUNNING → ROLLBACK_RUNNING → ROLLBACK_COMPLETED.

Étapes suivantes

  • Pour annuler une tâche DDL qui le permet (CANCELABLE: true), exécutez la commande CANCEL DDL.