Account Usage¶
No banco de dados SNOWFLAKE, os esquemas ACCOUNT_USAGE e READER_ACCOUNT_USAGE permitem consultar metadados de objetos, bem como dados históricos de uso, para sua conta e todas as contas de leitor (se houver) associadas à conta.
Visão geral dos esquemas Account Usage¶
- ACCOUNT_USAGE:
Exibições que mostram metadados de objetos e métricas de uso para sua conta.
Em geral, essas exibições espelham as exibições e funções de tabela correspondentes no Snowflake Snowflake Information Schema, mas com as seguintes diferenças:
Registros de objetos descartados incluídos em cada exibição.
Maior tempo de retenção para dados históricos de uso.
Latência de dados.
Para obter mais detalhes, consulte Diferenças entre Account Usage e Information Schema (neste tópico). Para obter mais detalhes sobre cada exibição, consulte Exibições do ACCOUNT_USAGE (neste tópico).
- READER_ACCOUNT_USAGE:
Exibições que mostram metadados de objetos e métricas de uso para todas as contas de leitor que foram criadas para sua conta (como um provedor de Secure Data Sharing).
Estas exibições são um pequeno subconjunto das ACCOUNT_USAGE Exibições do que se aplicam às contas de leitor. Além disso, cada exibição neste esquema contém uma coluna adicional
READER_ACCOUNT_NAMEpara filtrar os resultados por conta de leitor.Para obter mais detalhes sobre cada exibição, consulte Exibições do READER_ACCOUNT_USAGE (neste tópico).
Observe que essas exibições ficam vazias se nenhuma conta de leitor tiver sido criada para sua conta.
Diferenças entre Account Usage e Information Schema¶
As exibições do Account Usage e as exibições correspondentes (ou funções de tabela) no Snowflake Information Schema utilizam estruturas e convenções de nomenclatura idênticas, mas com algumas diferenças importantes, como descrito nesta seção:
Diferença |
Account Usage |
Information Schema |
|---|---|---|
Inclui objetos descartados |
Sim |
Não |
Latência dos dados |
De 45 minutos a 3 horas (varia de acordo com a exibição) |
Nenhum |
Retenção de dados históricos |
1 ano |
De 7 dias a 6 meses (varia de acordo com a exibição/função de tabela) |
Para obter mais detalhes, consulte as seções seguintes.
Registros de objetos descartados¶
Exibições do Account Usage incluem registros para todos os objetos que foram descartados. Muitas das exibições para tipos de objetos contêm uma coluna adicional DELETED que exibe o carimbo de data/hora em que o objeto foi descartado.
Além disso, como os objetos podem ser descartados e recriados com o mesmo nome, para diferenciar os registros de objetos que têm o mesmo nome, as exibições do Account Usage incluem colunas de ID, quando apropriado, que exibem as IDs internas geradas e atribuídas a cada registro pelo sistema.
Se uma coluna para um nome de objeto (por exemplo, a coluna TABLE_NAME) é NULL, esse objeto foi descartado. Neste caso, as colunas para os nomes e IDs dos objetos pai (por exemplo, as colunas DATABASE_NAME e SCHEMA_NAME) também são NULL.
Observe que em algumas exibições, a coluna para o nome do objeto ainda pode conter o nome do objeto, mesmo que o objeto tenha sido descartado.
Latência de dados¶
Devido ao processo de extração dos dados do armazenamento interno de metadados do Snowflake, as exibições do Account Usage têm alguma latência natural:
Para a maioria das exibições, a latência é de 2 horas (120 minutos).
Para as demais exibições, a latência varia entre 45 minutos e 3 horas.
Para obter mais detalhes, consulte a lista de exibições para cada esquema (neste tópico). Observe também que todos estes são períodos máximos de tempo; a latência real para uma determinada exibição quando a exibição é consultada pode ser menor.
Em contraste, as exibições/funções de tabela no Snowflake Information Schema não têm latência.
Retenção de dados históricos¶
Algumas exibições de Account Usage fornecem métricas históricas de uso. O período de retenção para essas exibições é 1 ano (365 dias).
Em contraste, as exibições e funções de tabela correspondentes no Snowflake Information Schema têm períodos de retenção muito mais curtos, variando de 7 dias a 6 meses, dependendo da exibição.
Exibições de ACCOUNT_USAGE¶
O esquema ACCOUNT_USAGE contém as seguintes exibições:
Exibição |
Tipo |
Latência [1] |
Edição [3] |
Notas |
|---|---|---|---|---|
Histórico |
3 horas |
Enterprise Edition (ou superior) |
Dados retidos por 1 ano. |
|
Histórico |
3 horas |
Enterprise Edition (ou superior) |
Dados retidos por 1 ano. |
|
Histórico |
3 horas |
|||
Objeto |
2 horas |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Objeto |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
24 horas |
Dados retidos por 1 ano. |
||
Histórico |
1 hora |
Dados retidos por 1 ano. |
||
Histórico |
1 hora |
Os dados das especificações de aplicativos excluídas são retidos por um ano. |
||
Histórico |
1 hora |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
6 horas |
Dados retidos por 1 ano. |
||
Objeto |
6 horas |
|||
Objeto |
6 horas |
|||
Histórico |
6 horas |
Dados retidos por 1 ano. |
||
Objeto |
6 horas |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Objeto |
3 horas |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Objeto |
3 horas |
Dados retidos por 1 ano. |
||
Objeto |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
4 horas |
Dados retidos por 1 ano. |
||
Objeto |
90 minutos |
|||
Histórico |
45 minutos |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Objeto |
3 horas |
|||
Objeto |
3 horas |
|||
Histórico |
Dados retidos por 1 ano. |
|||
Histórico |
2 horas [2] |
Dados retidos por 1 ano. |
||
Histórico |
Dados retidos por 1 ano. |
|||
Histórico |
Dados retidos por 1 ano. |
|||
Histórico |
Dados retidos por 1 ano. |
|||
Histórico |
1 hora |
Dados retidos por 1 ano. |
||
Histórico |
1 hora |
Dados retidos por 1 ano. |
||
Histórico |
Uma hora |
Dados retidos por 1 ano. |
||
Histórico |
1 hora |
Dados retidos por 1 ano. |
||
Histórico |
1 hora |
Dados retidos por 1 ano. |
||
Histórico |
Dados retidos por 1 ano. |
|||
Histórico |
Dados retidos por 1 ano. |
|||
Histórico |
Dados retidos por 1 ano. |
|||
Histórico |
Dados retidos por 1 ano. |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
1 hora |
Dados retidos por 1 ano. |
||
Objeto |
2 horas |
|||
Objeto |
3 horas |
Enterprise Edition (ou superior) |
Dados retidos enquanto a tabela existir. |
|
Objeto |
30 minutos |
Enterprise Edition (ou superior) |
||
Objeto |
3 horas |
Enterprise Edition (ou superior) |
||
Histórico |
3 horas |
Enterprise Edition (ou superior) |
Dados retidos por 1 ano. |
|
Objeto |
3 horas |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
2 horas |
Dados retidos por 1 ano. |
||
Histórico |
Dados retidos por 1 ano. |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Objeto |
90 minutos |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
2 horas |
Dados retidos por 1 ano. |
||
Objeto |
90 minutos |
|||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Objeto |
3 horas |
|||
Objeto |
2 horas |
|||
Objeto |
3 horas |
|||
Histórico |
3 horas |
Data retained for 1 year. (As of March 1, 2026, hybrid table requests are no longer billed, and metering was disabled soon after this pricing change took effect.) |
||
Histórico |
2 horas |
Dados retidos por 1 ano. |
||
Objeto |
3 horas |
|||
Objeto |
3 horas |
|||
Histórico |
4 horas |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
|||
Histórico |
6 horas |
Dados retidos por 1 ano. |
||
Objeto |
2 horas |
|||
Objeto |
3 horas |
|||
Histórico |
90 minutos [2] |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
2 horas |
Dados retidos por 1 ano. |
||
Objeto |
2 horas |
|||
Histórico |
3 horas |
Enterprise Edition (ou superior) |
Dados retidos por 1 ano. |
|
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Histórico |
3 horas |
|||
Histórico |
3 horas |
|||
Histórico |
3 horas |
|||
Histórico |
3 horas |
|||
Histórico |
3 horas |
|||
Objeto |
2 horas |
Business Critical (ou superior) |
Os dados dos pontos de extremidade excluídos são retidos por um ano. |
|
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Objeto |
2 horas |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Objeto |
24 horas |
Enterprise Edition (ou superior) |
||
Objeto |
2 horas |
Enterprise Edition (ou superior) |
||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
Enterprise Edition (ou superior) |
Dados retidos por 1 ano. |
|
Histórico |
8 horas |
Dados retidos por 1 ano. |
||
Histórico |
45 minutos |
Dados retidos por 1 ano. |
||
Histórico |
Dados retidos por 1 ano. |
|||
Objeto |
2 horas |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Objeto |
2 horas |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Histórico |
6 horas |
Enterprise Edition (ou superior) |
Dados retidos por 1 ano. |
|
Histórico |
3 horas |
Enterprise Edition (ou superior) |
Dados retidos por 1 ano. |
|
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Objeto |
3 horas |
|||
Objeto |
2 horas |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Objeto |
3 horas |
|||
Histórico |
6 horas |
Dados retidos por 1 ano. Esta exibição está obsoleta. Em vez disso, use a exibição BACKUP_OPERATION_HISTORY. |
||
Objeto |
6 horas |
Esta exibição está obsoleta. Em vez disso, use a exibição BACKUP_POLICIES. |
||
Objeto |
6 horas |
Esta exibição está obsoleta. Em vez disso, use a exibição BACKUP_SETS. |
||
Histórico |
6 horas |
Dados retidos por 1 ano. Esta exibição está obsoleta. Em vez disso, use a exibição BACKUP_STORAGE_USAGE. |
||
Objeto |
6 horas |
Esta exibição está obsoleta. Em vez disso, use a exibição BACKUPS. |
||
Histórico |
Dados retidos por 1 ano. |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
||||
Histórico |
2 horas |
Dados retidos por 1 ano. |
||
Histórico |
12 horas |
Dados retidos por 1 ano. |
||
Objeto |
2 horas |
|||
Histórico |
2 horas |
Dados retidos por 1 ano. |
||
Objeto |
2 horas |
|||
Histórico |
2 horas |
Dados retidos por 1 ano. |
||
Histórico |
2 horas |
Utilização combinada em todas as tabelas do banco de dados e estágios internos. Dados retidos por 1 ano. |
||
Objeto |
90 minutos |
|||
Objeto |
2 horas |
|||
Histórico |
6 horas |
Dados retidos por 1 ano. |
||
Histórico |
6 horas |
Dados retidos por 1 ano. |
||
Histórico |
4 horas |
Dados retidos por 1 ano. |
||
Objeto |
90 minutos |
|||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Histórico |
45 minutos |
|||
Objeto |
3 horas |
|||
Histórico |
1 hora |
|||
Objeto |
2 horas |
|||
Objeto |
2 horas |
|||
Objeto |
90 minutos |
|||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
Dados retidos por 1 ano. |
||
Histórico |
3 horas |
Dados retidos por 1 ano. |
[1] Todos os tempos de latência são aproximados; em alguns casos, a latência real pode ser menor.
[2] A latência das exibições de uma determinada tabela pode ser de até 2 dias se ambas as condições a seguir forem verdadeiras: 1. Menos de 32 instruções DML foram adicionadas à tabela fornecida desde a última atualização em LOAD_HISTORY ou COPY_HISTORY. 2. Menos de 100 linhas foram adicionadas à tabela fornecida desde a última atualização em LOAD_HISTORY ou COPY_HISTORY.
[3] A menos que seja observado o contrário, a exibição do Account Usage está disponível para todas as contas.
Funções de tabela Account Usage¶
Atualmente, o Snowflake oferece suporte a uma função de tabela ACCOUNT_USAGE:
Função de tabela |
Retenção de dados |
Notas |
|---|---|---|
N/A |
Os resultados retornam apenas para a função que tem acesso ao objeto especificado. |
Nota
Assim como nas exibições do Account Usage, considere a latência ao chamar esta função de tabela. A latência esperada para esta função de tabela é semelhante à latência para a exibição TAG_REFERENCES.
Exibições de READER_ACCOUNT_USAGE¶
O esquema READER_ACCOUNT_USAGE contém as seguintes exibições:
Exibição |
Tipo |
Latência [1] |
Notas |
|---|---|---|---|
Histórico |
2 horas |
Dados retidos por 1 ano. |
|
Histórico |
45 minutos |
Dados retidos por 1 ano. |
|
Objeto |
2 horas |
||
Histórico |
24 horas |
Utilização combinada em todas as tabelas do banco de dados e estágios internos. Dados retidos por 1 ano. |
|
Histórico |
24 horas |
Dados retidos por 1 ano. |
[1] Todos os tempos de latência são aproximados; em alguns casos, a latência real pode ser menor.
Habilitando outras funções para usar esquemas no banco de dados SNOWFLAKE¶
Por padrão, o banco de dados SNOWFLAKE fica visível para todos os usuários, mas o acesso aos esquemas nesse banco de dados pode ser concedido por um usuário com a função ACCOUNTADMIN usando uma das seguintes abordagens:
Concessão de IMPORTED PRIVILEGES no banco de dados SNOWFLAKE.
Conceda uma função de banco de dados SNOWFLAKE a uma função de conta.
Importante
Para evitar a concessão involuntária de acesso aos dados no nível de organização, considere o uso de funções de banco de dados SNOWFLAKE para conceder acesso às exibições no esquema ACCOUNT_USAGE.
Para obter mais informações, consulte GRANT DATABASE ROLE.
Por exemplo, para conceder IMPORTED PRIVILEGES no banco de dados SNOWFLAKE a duas funções adicionais:
Um usuário com a função customrole1 pode consultar uma exibição da seguinte maneira:
Para exemplos adicionais, consulte Consulta das exibições Account Usage.
Funções do banco de dados SNOWFLAKE do esquema ACCOUNT_USAGE¶
Além disso, você pode conceder um controle mais preciso às contas usando as funções do banco de dados SNOWFLAKE. Para obter mais informações nas funções do banco de dados, consulte funções do banco de dados.
Os esquemas ACCOUNT_USAGE têm quatro funções de banco de dados SNOWFLAKE definidas, cada uma concedendo o privilégio SELECT em exibições específicas.
Função |
Objetivo e descrição |
|---|---|
OBJECT_VIEWER |
A função OBJECT_VIEWER dá visibilidade aos metadados do objeto. |
USAGE_VIEWER |
A função USAGE_VIEWER dá visibilidade às informações históricas de uso. |
GOVERNANCE_VIEWER |
A função GOVERNANCE_VIEWER dá visibilidade às informações relacionadas à governança de dados. |
SECURITY_VIEWER |
A função SECURITY_VIEWER dá visibilidade às informações baseadas em segurança. |
Função de banco de dados necessária para acessar exibições ACCOUNT_USAGE¶
As funções OBJECT_VIEWER, USAGE_VIEWER, GOVERNANCE_VIEWER e SECURITY_VIEWER têm o privilégio SELECT para consultar exibições do uso da conta no banco de dados SNOWFLAKE compartilhado. Use a tabela a seguir para determinar qual função de banco de dados tem acesso a uma exibição.
Exibição |
Função de banco de dados |
|---|---|
GOVERNANCE_VIEWER |
|
SECURITY_VIEWER |
|
GOVERNANCE_VIEWER |
|
GOVERNANCE_VIEWER |
|
GOVERNANCE_VIEWER |
|
USAGE_VIEWER |
|
SECURITY_VIEWER |
|
SECURITY_VIEWER |
|
USAGE_VIEWER |
|
SECURITY_VIEWER |
|
SECURITY_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
GOVERNANCE_VIEWER |
|
GOVERNANCE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
SECURITY_VIEWER |
|
GOVERNANCE_VIEWER |
|
USAGE_VIEWER ou GOVERNANCE_VIEWER |
|
USAGE_VIEWER ou GOVERNANCE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
SECURITY_VIEWER |
|
SECURITY_VIEWER |
|
SECURITY_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
SECURITY_VIEWER |
|
USAGE_VIEWER |
|
SECURITY_VIEWER |
|
GOVERNANCE_VIEWER |
|
SECURITY_VIEWER |
|
USAGE_VIEWER |
|
SECURITY_VIEWER |
|
GOVERNANCE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
SECURITY_VIEWER |
|
SECURITY_VIEWER |
|
SECURITY_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
SECURITY_VIEWER |
|
SECURITY_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
GOVERNANCE_VIEWER, SECURITY_VIEWER |
|
USAGE_VIEWER |
|
GOVERNANCE_VIEWER |
|
GOVERNANCE_VIEWER |
|
OBJECT_VIEWER |
|
GOVERNANCE_VIEWER |
|
GOVERNANCE_VIEWER |
|
USAGE_VIEWER, GOVERNANCE_VIEWER |
|
GOVERNANCE_VIEWER |
|
GOVERNANCE_VIEWER |
|
OBJECT_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
SECURITY_VIEWER |
|
GOVERNANCE_VIEWER |
|
OBJECT_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
SECURITY_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
SECURITY_VIEWER |
|
SECURITY_VIEWER |
|
SECURITY_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
OBJECT_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
GOVERNANCE_VIEWER |
|
GOVERNANCE_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
OBJECT_VIEWER |
|
GOVERNANCE_VIEWER |
|
OBJECT_VIEWER ou GOVERNANCE_VIEWER |
|
USAGE_VIEWER |
|
SECURITY_VIEWER |
|
SECURITY_VIEWER |
|
OBJECT_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
|
USAGE_VIEWER |
Funções do banco de dados SNOWFLAKE do esquema READER_ACCOUNT_USAGE¶
A função READER_USAGE_VIEWER SNOWFLAKE do banco de dados recebe o privilégio SELECT em todas as exibições READER_ACCOUNT_USAGE. Como as contas de leitores são criadas pelos clientes, espera-se que a função READER_USAGE_VIEWER seja concedida às funções usadas para monitorar o uso das contas de leitores.
Consulta das exibições Account Usage¶
Esta seção inclui considerações ao consultar as exibições de Account Usage, juntamente com exemplos de consulta.
Como selecionar colunas¶
As exibições específicas do Snowflake estão sujeitas a mudanças. Evite selecionar todas as colunas dessas exibições. Em vez disso, selecione as colunas que você deseja. Por exemplo, se você quiser a coluna name, use SELECT name em vez de SELECT *.
Reconciliação de exibições de custo¶
Há várias exibições de Account Usage que contêm dados relacionados ao custo de recursos de computação, armazenamento e transferências de dados. Se estiver tentando reconciliar essas exibições com uma exibição correspondente no esquema ORGANIZATION_USAGE, primeiro será necessário definir o fuso horário da sessão como UTC.
Por exemplo, se você estiver tentando reconciliar ACCOUNT_USAGE.WAREHOUSE_METERING_HISTORY com os dados da conta em ORGANIZATION_USAGE.WAREHOUSE_METERING_HISTORY, você deverá executar o seguinte comando antes de consultar a exibição de Account Usage:
Exemplos¶
Os exemplos a seguir mostram algumas consultas típicas/úteis usando as exibições no esquema ACCOUNT_USAGE.
Nota
Estes exemplos consideram que o banco de dados do SNOWFLAKE e o esquema ACCOUNT_USAGE estão em uso para a sessão atual. Os exemplos também consideram que a função ACCOUNTADMIN (ou uma função que possui IMPORTED PRIVILEGES no banco de dados) está em uso. Se não estiverem em uso, execute os seguintes comandos antes de executar as consultas nos exemplos:
Exemplos: Métricas de login de usuário¶
Número médio de segundos entre tentativas de login com falha pelo usuário (mês até a data):
Logins com falha por usuário (mês até a data):
Logins com falha por usuário e cliente de conexão (mês até a data):
Exemplos: Desempenho de warehouse¶
Esta consulta calcula as métricas de desempenho do warehouse, como rendimento e latência para intervalos de tempo de 15 minutos no decorrer de um dia.
Na amostra de código abaixo, você pode substituir CURRENT_WAREHOUSE() pelo nome de um warehouse para calcular as métricas para aquele warehouse. Além disso, altere as datas time_from e time_to na cláusula WITH para especificar o período.
Nota
Analise diferentes tipos de instrução separadamente (por exemplo, instruções SELECT independentes de INSERT ou DELETE ou outras instruções).
O valor NUMJOBS representa o rendimento para esse intervalo de tempo.
Os valores P50_TOTAL_DURATION (mediana) e P95_TOTAL_DURATION (pico) representam a latência.
O SUM_TOTAL_DURATION é a soma dos valores SUM_<job_stage>_TIME para os diferentes estágios do trabalho (COMPILATION_AND_SCHEDULING, QUEUED, BLOCKED, EXECUTION).
Analise os valores <job_stage>_RATIO quando a carga (NUMJOBS) aumentar. Procure mudanças de proporção ou desvios em relação à média.
Se QUEUED_RATIO for alto, pode não haver capacidade suficiente no warehouse. Adicione mais clusters ou aumente o tamanho do warehouse.
Exemplos: Uso de crédito de warehouse¶
Créditos utilizados por cada warehouse em sua conta (mês até a data):
Créditos utilizados ao longo do tempo por cada warehouse em sua conta (mês até a data):
Exemplos: Como usar o armazenamento de dados¶
Terabytes faturáveis armazenados em sua conta ao longo do tempo:
Exemplos: Totais de consultas de usuário e tempos de execução¶
Total de trabalhos executados em sua conta (mês até a data):
Total de trabalhos executados por cada warehouse em sua conta (mês até a data):
Tempo médio de execução da consulta por usuário (mês até a data):
Tempo médio de execução da consulta por tipo de consulta e tamanho do warehouse (mês até a data):
Exemplos: Como obter uma contagem de consultas para cada evento de login¶
Junte colunas de LOGIN_HISTORY, QUERY_HISTORY e SESSIONS para obter uma contagem de consultas para cada evento de login de usuário.
Nota
A exibição SESSIONS registra informações a partir de 20-21 julho de 2020, portanto o resultado da consulta conterá apenas informações sobrepostas para cada uma das três exibições a partir dessa data.