Categorias:

Information Schema , Funções de tabela

STAGE_STORAGE_USAGE_HISTORY

Esta função de tabela pode ser usada para consultar o uso médio diário de armazenamento de dados, em bytes, para todos os estágios do Snowflake na sua conta dentro de um intervalo de datas especificado. A saída incluirá o armazenamento para:

  • Estágios internos nomeados.

  • Áreas de preparação padrão (para tabelas e usuários).

Nota

Esta função retorna o uso do armazenamento do estágios dos últimos 6 meses.

Consulte também:

DATABASE_STORAGE_USAGE_HISTORY , WAREHOUSE_METERING_HISTORY

Sintaxe

STAGE_STORAGE_USAGE_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ] )
Copy

Argumentos

Todos os argumentos são opcionais.

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

O intervalo de datas, dos últimos 6 meses, para o qual é possível recuperar o uso do armazenamento do estágio:

  • 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 DATE_RANGE_END é usado como início do intervalo (ou seja, o padrão é um dia de uso de armazenamento).

Se o intervalo estiver fora dos últimos 6 meses, um erro é devolvido.

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

USAGE_DATE

DATE

Data (no fuso horário UTC) deste registro de uso do armazenamento

AVERAGE_STAGE_BYTES

NUMBER

Número de bytes do armazenamento do estágio usado

Exemplos

Recuperar o uso médio diário de armazenamento dos últimos 10 dias para todos os estágios internos de sua conta:

select *
from table(information_schema.stage_storage_usage_history(dateadd('days',-10,current_date()),current_date()));
Copy