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, apenas a descrição mais recente das tabelas dinâmicas existentes será retornada.

AS_OF => constant_expr: Hora (no formato TIMESTAMP_LTZ) no qual retornar o estado do gráfico. 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: USER_DEFINED - Determinado pelo parâmetro TARGET_LAG especificado para a tabela dinâmica. DOWNSTREAM - Indica uma tabela dinâmica com um DOWNSTREAM TARGET_LAG. Para obter mais informações, consulte Como é feita a atualização de tabela dinâmica.
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 do 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.