DYNAMIC_TABLES¶

Sintaxe¶

DYNAMIC_TABLES (
  [ NAME => '<string>' ]
  [ , REFRESH_DATA_TIMESTAMP_START => <constant_expr> ]
  [ , RESULT_LIMIT => <integer> ]
  [ , INCLUDE_CONNECTED => { TRUE | FALSE } ]
)

Argumentos¶

Todos os argumentos são opcionais. Se nenhum argumento for fornecido, serão retornadas 100 atualizações de todas as tabelas dinâmicas da conta.

NAME => 'string'

O nome de uma tabela dinâmica.

Os nomes devem estar entre aspas simples e não diferenciam maiúsculas de minúsculas.

Você pode especificar o nome não qualificado (dynamic_table_name), o nome parcialmente qualificado (schema_name.dynamic_table_name) ou o nome totalmente qualificado (database_name.schema_name.dynamic_table_name).

Para obter mais informações sobre a resolução de nomes de objetos, consulte Resolução de nome de objeto.

A função retorna os metadados para esta tabela.

REFRESH_DATA_TIMESTAMP_START => constant_expr

Hora (em formato TIMESTAMP_LTZ) para calcular métricas relacionadas à meta de atraso da tabela dinâmica. Inclui todas as atualizações com LATEST_DATA_TIMESTAMP maior ou igual a REFRESH_DATA_TIMESTAMP_START.

Padrão: todas as atualizações no histórico de atualizações são mantidas por 7 dias.

RESULT_LIMIT => integer

Um número especificando o número máximo de linhas retornadas pela função.

Por padrão, a função retorna 100 linhas e os resultados são classificados pelo último estado de atualização concluído da tabela dinâmica na seguinte ordem, a menos que especificado de outra forma usando o argumento RESULT_LIMIT.

1. FAILED

2. UPSTREAM_FAILED

3. SKIPPED

4. SUCCEEDED

5. CANCELED

Para classificar em uma ordem diferente, você deve fornecer um valor RESULT_LIMIT grande o suficiente (por exemplo, o valor máximo de um número inteiro assinado). Desde que RESULT_LIMIT exceda o número total de tabelas dinâmicas na conta, os resultados podem ser classificados usando uma cláusula ORDER BY.

Para aplicar um filtro nos resultados, especifique também um valor RESULT_LIMIT grande o suficiente para que o filtro seja aplicado em todas as tabelas dinâmicas.

Exemplos:

O exemplo a seguir classifica por uma ordem diferente de name e retorna 100 linhas:

SELECT * FROM TABLE(INFORMATION_SCHEMA.DYNAMIC_TABLES(result_limit => <max_value>)) ORDER BY name ASC LIMIT 100 ;

Copy

O exemplo a seguir classifica por uma ordem diferente de name e retorna todas as linhas:

SELECT * FROM TABLE(INFORMATION_SCHEMA.DYNAMIC_TABLES(result_limit => <max_value>)) ORDER BY name ASC ;

Copy

O exemplo a seguir filtra todas as tabelas dinâmicas com meta de atraso de 1 minuto, usa a classificação padrão e retorna todas as linhas:

SELECT * FROM TABLE(INFORMATION_SCHEMA.DYNAMIC_TABLES(result_limit => <max_value>)) WHERE TARGET_LAG_SEC = 60 ;

Copy

Intervalo: 1 a 10000

Padrão: 100.

INCLUDE_CONNECTED => { TRUE | FALSE }

Quando definido para TRUE, a função retorna metadados para todas as tabelas dinâmicas conectadas à tabela dinâmica especificada pelo argumento NAME.

Você deve especificar o argumento NAME, você não deve especificar o argumento RESULT_LIMIT.

Padrão: FALSE

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.

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.

Exemplos¶

Recupere os nomes, informações de atraso e carimbos de data/hora dos dados da última atualização bem-sucedida para todas as tabelas dinâmicas conectadas à tabela dinâmica especificada.

SELECT
  name,
  target_lag_sec,
  mean_lag_sec,
  latest_data_timestamp
FROM
  TABLE (
    INFORMATION_SCHEMA.DYNAMIC_TABLES (
      NAME => 'mydb.myschema.mydt',
      INCLUDE_CONNECTED => TRUE
    )
  )
ORDER BY
  target_lag_sec