Categorias:: Information Schema , Funções de tabela

DCM_DEPLOYMENT_HISTORY¶

Esta função de tabela retorna o histórico de implantação dos objetos de DCM project. Você pode usá-la para consultar implantações bem-sucedidas e com falha, incluindo carimbos de data/hora, status, detalhes de erros e estatísticas resumidas. A função fornece acesso baseado em função e resultados de baixa latência.

Sintaxe¶

DCM_DEPLOYMENT_HISTORY(
      [ PROJECT_NAME => '<string>' ]
      [, START_TIME_RANGE_START => <constant_expr> ]
      [, START_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <integer> ] )

Argumentos¶

Todos os argumentos são opcionais.

PROJECT_NAME => 'string'

Nome totalmente qualificado do DCM project. Se não for fornecido, a função retornará o histórico de todos os projetos acessíveis pela função atual.

START_TIME_RANGE_START => constant_expr

Carimbo de data/hora (no formato TIMESTAMP_LTZ) que marca o início do intervalo de tempo para recuperar eventos de implantação.

Padrão: sem valor. 7 dias atrás.

START_TIME_RANGE_END => constant_expr

Carimbo de data/hora (no formato TIMESTAMP_LTZ) que marca o término do intervalo de tempo para recuperar eventos de implantação.

Padrão: carimbo de data/hora atual.

RESULT_LIMIT => integer

Número máximo de linhas a retornar.

Padrão: 10000.

Saída¶

A função retorna as seguintes colunas:


Nome da coluna	Tipo de dados	Descrição
`QUERY_UUID`	VARCHAR	Identificador exclusivo da consulta que executou a implantação.
`PROJECT_NAME`	VARCHAR	Nome do DCM project que foi implantado.
`START_TIMESTAMP`	TIMESTAMP_LTZ	Carimbo de data/hora de quando a execução da implantação foi iniciada.
`END_TIMESTAMP`	TIMESTAMP_LTZ	Carimbo de data/hora de quando a execução da implantação foi concluída ou falhou.
`DEPLOYMENT_NAME`	VARCHAR	Identificador interno da implantação (por exemplo, `DEPLOYMENT$1`, `DEPLOYMENT$2`).
`DEPLOYMENT_ALIAS`	VARCHAR	Alias especificado pelo usuário para a implantação. Vazio se nenhum alias foi fornecido.
`STATUS`	VARCHAR	Resultado da implantação. Valores possíveis: `SUCCESSFUL`, `FAILED` e `CANCELED`.
`PHASE`	VARCHAR	A fase da execução. Valores possíveis: `PLAN`, `DEPLOY` e `INIT`.
`CONFIGURATION_PROFILE`	VARCHAR	Nome do perfil de configuração usado para a implantação. Vazio se nenhuma configuração foi especificada.
`ERROR_MESSAGE`	VARCHAR	Mensagem de erro se a implantação tiver falhado. Vazio para implantações bem-sucedidas.
`ERROR_CODE`	VARCHAR	Código de erro se a implantação tiver falhado. Vazio para implantações bem-sucedidas.
`DATABASE_NAME`	VARCHAR	Banco de dados que contém o DCM project.
`SCHEMA_NAME`	VARCHAR	Esquema que contém o DCM project.
`EXECUTOR_ROLE`	VARCHAR	Função que executou o comando de implantação.
`STATS`	VARIANT	Objeto JSON com as estatísticas resumidas da implantação, discriminadas por categoria. Cada categoria mostra as contagens de itens `created`, `altered` e `dropped`. As categorias incluem `entities` (objetos gerenciados), `columns`, `grants` e `dmfAttachments` (expectativas da função de métrica de dados).

Notas de uso¶

Ao chamar uma função de tabela Information Schema, a sessão deve ter um esquema INFORMATION_SCHEMA em uso ou o nome da função deve ser totalmente qualificado. Para obter mais detalhes, consulte Snowflake Information Schema.

Exemplos¶

Recuperar o histórico de implantação de um projeto específico, limitado a 3 resultados:

SELECT
  PROJECT_NAME,
  START_TIMESTAMP,
  DEPLOYMENT_NAME,
  DEPLOYMENT_ALIAS,
  STATUS,
  CONFIGURATION_PROFILE,
  EXECUTOR_ROLE
FROM
  TABLE (MY_DB.INFORMATION_SCHEMA.DCM_DEPLOYMENT_HISTORY(
    project_name => 'MY_DB.PROJECTS.MY_PROJECT',
    result_limit => 3
  ));

+----------------+-----------------------------+--------------+------------------+------------+-----------------------+------------------+
| PROJECT_NAME   | START_TIMESTAMP             | DEPLOYMENT   | DEPLOYMENT       | STATUS     | CONFIGURATION_PROFILE | EXECUTOR_ROLE    |
|                |                             | _NAME        | _ALIAS           |            |                       |                  |
+----------------+-----------------------------+--------------+------------------+------------+-----------------------+------------------+
| MY_PROJECT     | 2026-03-20 09:15:22.254     | DEPLOYMENT$3 | staging update   | SUCCESSFUL | STAGE                 | PROJECT_DEPLOYER |
| MY_PROJECT     | 2026-03-19 14:30:10.927     | DEPLOYMENT$2 |                  | FAILED     | DEV                   | PROJECT_DEPLOYER |
| MY_PROJECT     | 2026-03-18 11:00:05.339     | DEPLOYMENT$1 | initial deploy   | SUCCESSFUL | DEV                   | PROJECT_DEPLOYER |
+----------------+-----------------------------+--------------+------------------+------------+-----------------------+------------------+

A coluna STATS contém um objeto JSON com a seguinte estrutura:

{
  "columns": {
    "altered": 0,
    "created": 12,
    "dropped": 0
  },
  "dmfAttachments": {
    "altered": 0,
    "created": 2,
    "dropped": 0
  },
  "entities": {
    "altered": 1,
    "created": 5,
    "dropped": 0
  },
  "grants": {
    "altered": 0,
    "created": 4,
    "dropped": 0
  }
}

Recuperar todas as colunas de todos os projetos acessíveis pela função atual nas últimas 24 horas:

SELECT *
FROM TABLE (INFORMATION_SCHEMA.DCM_DEPLOYMENT_HISTORY(
  start_time_range_start => DATEADD(hours, -24, CURRENT_TIMESTAMP())
));