Categorias:

Information Schema , Funções de tabela

DATABASE_STORAGE_USAGE_HISTORY

Esta função de tabela pode ser usada para consultar o uso médio diário de armazenamento, em bytes, para um único banco de dados (ou todos os bancos de dados em sua conta) dentro de um intervalo de datas especificado. Os resultados incluem:

  • Todos os dados armazenados em tabelas e exibições materializadas no(s) banco(s) de dados.

  • Todos os dados históricos mantidos em Fail-safe para o(s) banco(s) de dados.

Nota

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

Consulte também:

STAGE_STORAGE_USAGE_HISTORY , WAREHOUSE_METERING_HISTORY

Sintaxe

DATABASE_STORAGE_USAGE_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ]
      [, DATABASE_NAME => '<string>' ] )
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 recuperar o uso do armazenamento do banco de dados:

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

DATABASE_NAME => 'string'

O nome do banco de dados para o qual se recupera o histórico de uso do armazenamento. Observe que o nome do banco de dados deve ser delimitado por aspas simples. Além disso, se o nome do banco de dados contiver quaisquer espaços, letras maiúsculas e minúsculas misturadas ou caracteres especiais, o nome deve ser delimitado por aspas duplas dentro das aspas simples (por exemplo, '"My DB"' vs 'mydb').

Se nenhum banco de dados for especificado, então os dados são devolvidos para todos os bancos de dados em sua conta.

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 deste registro de uso do armazenamento

DATABASE_NAME

TEXT

Nome do banco de dados

AVERAGE_DATABASE_BYTES

NUMBER

Número de bytes do armazenamento de banco de dados utilizados

AVERAGE_FAILSAFE_BYTES

NUMBER

Número de bytes do armazenamento Fail-safe usados.

Se um banco de dados tiver sido descartado e seu período de retenção de dados tiver passado (ou seja, o banco de dados não pode ser recuperado usando Time Travel), então o nome do banco de dados é relatado como DROPPED_id, onde id é um identificador gerado internamente. Esta ID pode ser usada para combinar entradas por linhas retornadas pela função de tabela.

Exemplos

Recuperar o uso médio diário de armazenamento dos últimos 10 dias, por banco de dados, para todos os bancos de dados em sua conta:

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