Categorias:: Information Schema , Funções de tabela

AUTO_REFRESH_REGISTRATION_HISTORY¶

Esta função de tabela pode ser usada para consultar o histórico dos arquivos de dados registrados nos metadados dos objetos especificados e os créditos faturados por essas operações. A função de tabela retorna o histórico de faturamento dentro de um intervalo de datas especificado para toda a sua conta Snowflake.

Nota

Esta função retorna a atividade de faturamento dos últimos 14 dias.

Sintaxe¶

AUTO_REFRESH_REGISTRATION_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ]
      [, OBJECT_TYPE => '<string>' [, OBJECT_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 do intervalo de faturamento:

Se uma data final não for especificada, então CURRENT_DATE é usada como o fim do intervalo.
Se uma data de início não for especificada, então o intervalo começa 10 minutos antes do início de DATE_RANGE_END (ou seja, o padrão é mostrar os 10 minutos anteriores do histórico de faturamento). Por exemplo, se DATE_RANGE_END for CURRENT_DATE, então o padrão DATE_RANGE_START é 11:50 PM no dia anterior.

O histórico é exibido em incrementos de 5 minutos, 1 hora ou 24 horas (dependendo da extensão da faixa especificada).

OBJECT_TYPE => string

Tipo de objeto para o qual os créditos são faturados. O seguinte valor é suportado:

DIRECTORY_TABLE: Tabelas de diretório que são configuradas para atualização automática de metadados.
EXTERNAL_TABLE: Tabelas externas que são configuradas para atualização automática de metadados.

OBJECT_NAME => string

Uma cadeia de caracteres especificando o nome do objeto para o qual os créditos são faturados.

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

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 de faturamento especificado.
END_TIME	TIMESTAMP_LTZ	Fim do intervalo de faturamento especificado.
OBJECT_NAME	TEXT	Nome do objeto para o qual os créditos são faturados.
OBJECT_TYPE	TEXT	Tipo de objeto para o qual os créditos são faturados.
CREDITS_USED	TEXT	Número de créditos faturados para os arquivos de dados registrados nos metadados do objeto ou tipo de objeto especificado durante o intervalo START_TIME e END_TIME.
FILES_REGISTERED	NUMBER	Número de arquivos registrados durante o intervalo START_TIME e END_TIME.

Exemplos¶

Observe que todos os exemplos neste tópico fazem referência a metadados de tabelas externas. Para recuperar registros históricos similares para outros tipos de objetos, edite o valor OBJECT_TYPE => string na consulta.

Recupere o histórico de faturamento de todas as tabelas externas em sua conta que estão configuradas para atualização automática de metadados. A consulta recupera o histórico por um intervalo de 30 minutos, em períodos de 5 minutos:

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>to_timestamp_tz('2021-06-17 12:00:00.000 -0700'),
    date_range_end=>to_timestamp_tz('2021-06-17 12:30:00.000 -0700'),
    object_type=>'external_table'));

Copy

O mesmo que o exemplo anterior, mas recupera o histórico de faturamento dos últimos 14 dias, em períodos de 1 dia:

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>dateadd('day',-14,current_date()),
    date_range_end=>current_date(),
    object_type=>'external_table'));

Copy

O mesmo que o primeiro exemplo, mas recupera o histórico de faturamento dos últimos 14 dias, em períodos de 1 dias:

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>dateadd('day',-14,current_date()),
    date_range_end=>current_date(),
    object_type=>'external_table'));

Copy

Recuperar o histórico de faturamento de uma tabela externa chamada myexttable no esquema ativo da sessão durante as últimas 12 horas, em períodos de 1 hora:

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>dateadd('hour',-12,current_timestamp()),
    object_type=>'external_table',
    object_name=>'myexttable'));

Copy

Recuperar o histórico de faturamento de uma tabela externa chamada myexttable no esquema mydb.myschema para as últimas 12 horas, em períodos de 1 hora:

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>dateadd('hour',-12,current_timestamp()),
    object_type=>'external_table',
    object_name=>'mydb.myschema.myexttable'));

Copy