Categorias:

Information Schema , Funções de tabela

DYNAMIC_TABLE_GRAPH_HISTORY

Esta função de tabela retorna informações sobre todas as tabelas dinâmicas na conta atual. Essas informações incluem as dependências entre tabelas dinâmicas e tabelas base. Um uso comum é identificar todas as tabelas dinâmicas que fazem parte de um pipeline.

Na saída desta função, cada linha representa uma tabela dinâmica. As colunas VALID_FROM e VALID_TO especificam o intervalo de tempo durante o qual a descrição de uma tabela dinâmica foi válida (ou seja, descreveu com precisão a tabela dinâmica).

Alterações em uma tabela dinâmica, como a alteração do TARGET_LAG, resultam na criação de novas entradas.

Esta função de tabela fornece apenas descrições com um valor VALID_TO dentro de 7 dias da hora atual.

Sintaxe

DYNAMIC_TABLE_GRAPH_HISTORY(
  [ AS_OF => <constant_expr> ]
  [ , HISTORY_START => <constant_expr> [ , HISTORY_END => <constant_expr> ] ]
)
Copy

Argumentos

Todos os argumentos são opcionais. Se nenhum argumento for fornecido, somente a descrição mais recente das tabelas dinâmicas existentes será retornada. Especifique constant_expr no formato TIMESTAMP_LTZ.

AS_OF => constant_expr

Hora em que o estado do gráfico deve ser retornado. Você pode especificar uma hora que corresponda a um valor na coluna REFRESH_VERSION na saída da função DYNAMIC_TABLE_REFRESH_HISTORY.

HISTORY_START => constant_expr , . HISTORY_END => constant_expr

Intervalo de data/hora do histórico de atualização da tabela dinâmica. HISTORY_START especifica a data/hora mais antiga, inclusive, para retornar dados. HISTORY_END, que deve ser especificado com HISTORY_START, especifica a data/hora final para retornar dados.

Saída

A função retorna as seguintes colunas.

Para exibir essas colunas, é necessário usar uma função com o privilégio MONITOR. Caso contrário, a função retorna apenas um valor para NAME, SCHEMA_NAME, DATABASE_NAME e QUALIFIED_NAME. Para obter mais informações sobre privilégios de tabela dinâmica, consulte Privilégios para visualizar os metadados de uma tabela dinâmica.

Nome da coluna

Tipo de dados

Descrição

NAME

TEXT

Nome da tabela dinâmica.

SCHEMA_NAME

TEXT

Nome do esquema que contém a tabela dinâmica.

DATABASE_NAME

TEXT

Nome do banco de dados que contém a tabela dinâmica.

QUALIFIED_NAME

TEXT

Nome totalmente qualificado da tabela dinâmica conforme aparece no gráfico de tabelas dinâmicas. Você pode usar isso para juntar a saída com a saída da função DYNAMIC_TABLE_REFRESH_HISTORY.

INPUTS

ARRAY de OBJECTs

Cada OBJECT representa uma tabela, exibição ou tabela dinâmica que serve como entrada para esta tabela dinâmica e consiste em:

  • name (TEXT): nome totalmente qualificado.

  • kind (TEXT): tipo de entrada (TABLE,VIEW ou DYNAMIC TABLE).

TARGET_LAG_TYPE

TEXT

Uma das opções:

TARGET_LAG_SEC

NUMBER

O tempo de atraso de destino em segundos desta tabela dinâmica. Este é o valor especificado no parâmetro TARGET_LAG da tabela dinâmica.

QUERY_TEXT

TEXT

O instrução SELECT para esta tabela dinâmica.

VALID_FROM

TIMESTAMP_LTZ

A descrição da tabela dinâmica é válida após este horário.

VALID_TO

TIMESTAMP_LTZ

Se presente, a descrição da tabela dinâmica é válida até este momento. Se for nulo, a descrição ainda será precisa.

SCHEDULING_STATE

OBJECT

OBJECT consiste em:

  • state (TEXT): estado de agendamento (ACTIVE ou SUSPENDED).

  • reason_code (TEXT): código opcional do motivo se o estado não for ACTIVE.

  • reason_message (TEXT): descrição de texto do motivo pelo qual a tabela dinâmica não está ativa. Só se aplica se o estado não estiver ativo.

  • suspended_on (TIMESTAMP_LTZ): carimbo de data/hora opcional quando a tabela dinâmica foi suspensa.

  • resumed_on (TIMESTAMP_LTZ): carimbo de data/hora opcional quando foi retomado pela última vez se a tabela dinâmica for ACTIVE.

ALTER_TRIGGER

ARRAY

Descreve por que uma nova entrada é criada na função DYNAMIC_TABLE_GRAPH_HISTORY. Isso pode ser o seguinte:

  • NONE (compatível com versões anteriores)

  • CREATE_DYNAMIC_TABLE

  • ALTER_TARGET_LAG

  • SUSPEND

  • RESUME

  • REPLICATION_REFRESH

  • ALTER_WAREHOUSE

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 informações, consulte Snowflake Information Schema.

Exemplos

Recuperar o histórico do gráfico de cada tabela dinâmica na conta, suas propriedades e suas dependências em outras tabelas e tabelas dinâmicas:

SELECT
  name,
  inputs,
  target_lag_type,
  target_lag_sec,
  scheduling_state,
  alter_trigger
FROM
  TABLE (
    INFORMATION_SCHEMA.DYNAMIC_TABLE_GRAPH_HISTORY ()
  )
ORDER BY
  name;
Copy
+--------------------+---------------------------------------------------+-----------------+----------------+---------------------------------------------+------------------+
| NAME               |[] INPUTS                                          | TARGET_LAG_TYPE | TARGET_LAG_SEC | [] SCHEDULING_STATE                         | [] ALTER_TRIGGER |
|--------------------+---------------------------------------------------+-----------------+----------------+---------------------------------------------|------------------+
| MY_DYNAMIC_TABLE_1 | [                                                 | USER_DEFINED    | 300            | {                                           | [                |
|                    |  {                                                |                 |                |   "resumed_on": "2024-03-01 10:29:02.066 Z",|   "RESUME"       |
|                    |    "kind": "DYNAMIC_TABLE",                       |                 |                |   "state": "ACTIVE"                         | ]                |
|                    |    "name": "MY_QUALIFIED_NAME.MY_DYNAMIC_TABLE_2" |                 |                | }                                           |                  |
|                    |  }                                                |                 |                |                                             |                  |
|                    | ]                                                 |                 |                |                                             |                  |
+--------------------+---------------------------------------------------+-----------------+----------------+---------------------------------------------+------------------+
Linguagem: Português