SHOW DDL - PolarDB: Central de Documentação do Alibaba Cloud

No PolarDB-X, cada instrução DDL é executada como um job DDL. Use SHOW DDL para inspecionar jobs DDL ativos e recentes na sua instância.

Sintaxe

SHOW [FULL] DDL;

Exemplo

O exemplo a seguir mostra a saída de SHOW DDL\G para um job ALTER TABLE pausado. Os campos BACKFILL_PROGRESS e PHY_DDL_PROGRESS refletem subfases internas distintas; portanto, seus valores podem diferir do PROGRESS geral.

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)

Parâmetros de resposta

Parâmetro	Descrição
`JOB_ID`	ID exclusivo do job DDL. Inteiro assinado de 64 bits do tipo de dados `LONG`.
`OBJECT_SCHEMA`	Nome do schema do objeto em que o job DDL é executado.
`OBJECT_NAME`	Nome do objeto alvo do job DDL. Por exemplo, o nome da tabela em um job `CREATE TABLE` ou `ALTER TABLE`.
`ENGINE`	Tipo de mecanismo do job DDL. Valor padrão: `DAG`.
`DDL_TYPE`	Tipo do job DDL, como `CREATE_TABLE` ou `ALTER_TABLE`.
`STATE`	Estado atual do job DDL. Valores válidos: `QUEUED`, `RUNNING`, `COMPLETED`, `ROLLBACK_RUNNING`, `ROLLBACK_COMPLETED`, `PAUSED`. Consulte Estados de jobs DDL para ver as transições de estado.
`BACKFILL_PROGRESS`	Progresso do backfill de dados no job DDL.
`PHY_DDL_PROGRESS`	Progresso das instruções DDL físicas em lote em execução no job DDL.
`PROGRESS`	Progresso geral do job DDL.
`START_TIME`	Horário de início do job DDL.
`END_TIME`	Horário de término do job DDL.
`ELAPSED_TIME(MS)`	Tempo decorrido desde o início do job DDL, em milissegundos.
`PHY_PROCESS`	Estado das instruções DDL físicas em execução.
`CANCELABLE`	Indica se é possível cancele o job DDL com `CANCEL DDL`. O valor `true` significa que o job é cancelável.

Estados de jobs DDL

O campo STATE reflete a fase atual de um job DDL. O diagrama a seguir ilustra as transições entre os estados:

456789

Em condições normais, um job DDL segue o fluxo: QUEUED → RUNNING → COMPLETED.

Se ocorrer uma exceção, o job poderá sofrer rollback automático: QUEUED → RUNNING → ROLLBACK_RUNNING → ROLLBACK_COMPLETED.

Próximos passos

Para cancele um job DDL cancelável (CANCELABLE: true), execute CANCEL DDL.