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 1 dia 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:

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 (RUNNING ou SUSPENDED). `reason_code` (TEXT): código opcional do motivo se o estado não for RUNNING. `reason_message` (TEXT): descrição de texto do motivo pelo qual a tabela dinâmica não está em execução. Só se aplica se o estado não estiver em execução. `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 RUNNING.

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.