Categorias:

Information Schema , Funções de tabela

AUTOMATIC_CLUSTERING_HISTORY

Esta função de tabela é usada para consultar o histórico de Clustering automático de determinadas tabelas dentro de um intervalo de datas especificado. As informações retornadas pela função incluem os créditos consumidos, bytes atualizados e linhas atualizadas cada vez que uma tabela passa por reclustering.

Sintaxe

AUTOMATIC_CLUSTERING_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [ , DATE_RANGE_END => <constant_expr> ]
      [ , TABLE_NAME => '<string>' ] )
Copy

Argumentos

Todos os argumentos são opcionais.

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

O intervalo de data/hora para exibir o histórico do Clustering automático. Por exemplo, se você especificar que a data de início é 03-04-2019 e a data final é 05-04-2019, então você obtém dados para 3 de abril, 4 de abril e 5 de abril. (Os pontos de extremidade estão incluídos).

  • Se não for especificada nem uma data de início nem uma data final, o padrão será as últimas 12 horas.

  • Se uma data final não for especificada, mas uma data de início for especificada, então CURRENT_DATE à meia-noite é usada como o fim do intervalo.

  • Se uma data de início não for especificada, mas uma data final for especificada, então o intervalo começa 12 horas antes do início de DATE_RANGE_END.

TABLE_NAME => string

Nome da tabela. Se especificado, mostra apenas o histórico para a tabela especificada. O nome da tabela pode incluir o nome do esquema e o nome do banco de dados.

Se um nome de tabela não for especificado, então os resultados incluem o histórico de cada tabela mantida pelo serviço de Clustering automático dentro do intervalo de tempo especificado.

Notas de uso

  • Retorna resultados apenas para a função ACCOUNTADMIN ou qualquer função que tenha sido explicitamente concedido o privilégio global MONITOR USAGE.

    Nota

    Uma função com o privilégio MONITOR USAGE pode ver o uso de crédito por objeto, mas não os nomes de objetos. A função também deve ter SELECT em um objeto para que seu nome seja devolvido por esta função. Se a função não tiver privilégios suficientes para ver o nome do objeto, o nome do objeto pode ser exibido com um nome substituto, como “desconhecido_#”, onde “#” representa um ou mais dígitos.

  • 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.

  • O histórico é exibido em incrementos de 1 hora.

Saída

A função retorna as seguintes colunas:

Nome da coluna

Tipo de dados

Descrição

START_TIME

TIMESTAMP_LTZ

Início do intervalo especificado.

END_TIME

TIMESTAMP_LTZ

Fim do intervalo especificado.

TABLE_NAME

TEXT

Nome da tabela. Exibe NULL se nenhum nome de tabela for especificado na função, neste caso, qualquer uma das linhas inclui os totais de todas as tabelas em uso dentro do intervalo de tempo.

CREDITS_USED

NUMBER

Número de créditos faturados para o clustering automático durante o intervalo START_TIME e END_TIME.

NUM_BYTES_RECLUSTERED

NUMBER

Número de bytes retidos durante o intervalo START_TIME e END_TIME.

NUM_ROWS_RECLUSTERED

NUMBER

Número de linhas reclusterizadas carregadas durante o intervalo START_TIME e END_TIME.

Exemplos

Recupere o histórico de clustering automático para uma faixa de uma hora para sua conta:

select *
  from table(information_schema.automatic_clustering_history(
    date_range_start=>'2018-04-10 13:00:00.000 -0700',
    date_range_end=>'2018-04-10 14:00:00.000 -0700'));
Copy

Recuperar o histórico de clustering automático das últimas 12 horas, em períodos de 1 hora, para sua conta:

select *
  from table(information_schema.automatic_clustering_history(
    date_range_start=>dateadd(H, -12, current_timestamp)));
Copy

Recuperar o histórico de clustering automático da última semana para sua conta:

select *
  from table(information_schema.automatic_clustering_history(
    date_range_start=>dateadd(D, -7, current_date),
    date_range_end=>current_date));
Copy

Recuperar o histórico de clustering automático da última semana para uma tabela especificada em sua conta:

select *
  from table(information_schema.automatic_clustering_history(
    date_range_start=>dateadd(D, -7, current_date),
    date_range_end=>current_date,
    table_name=>'mydb.myschema.mytable'));
Copy
Linguagem: Português