Análise de cargas de trabalho de consulta com Performance Explorer¶

Acesso total aos dados do Performance Explorer na conta¶

Você tem acesso total aos dados do Performance Explorer para sua conta quando qualquer função concedida a você atender a uma das seguintes condições:

• Sua função é a ACCOUNTADMIN.

• Sua função recebeu a permissão IMPORTED PRIVILEGES no banco de dados SNOWFLAKE compartilhado (consulte Habilitando outras funções para usar esquemas no banco de dados SNOWFLAKE).

• Sua função recebeu a permissão de aplicativo SNOWFLAKE.PERFORMANCE_EXPLORER_USER.

Por exemplo, para conceder ao usuário jdoe acesso total ao Performance Explorer usando uma função personalizada, execute:

USE ROLE ACCOUNTADMIN;

CREATE ROLE pe_viewer_role;
GRANT APPLICATION ROLE SNOWFLAKE.PERFORMANCE_EXPLORER_USER TO ROLE pe_viewer_role;
GRANT ROLE pe_viewer_role TO USER jdoe;

Visualizando métricas de consulta sem acesso total à conta¶

Se você não tiver acesso total conforme descrito acima, ainda poderá visualizar a atividade da consulta quando qualquer função concedida a você atender a uma das seguintes condições:

• Sua função recebeu a função de banco de dados GOVERNANCE_VIEWER no banco de dados SNOWFLAKE (atividade de consulta em toda a conta).

• Sua função tem o privilégio MONITOR na conta ou o privilégio MANAGE WAREHOUSES na conta, que efetivamente abrange todos os warehouses (atividade de consulta que usa warehouses).

• Sua função tem OWNERSHIP, MONITOR ou OPERATE em pelo menos um warehouse (atividade de consulta somente para consultas executadas em warehouses que você pode monitorar ou operar). Para obter detalhes, consulte Privilégios de warehouse.

Se nenhuma das opções acima se aplicar e você não puder usar MONITOR ou OPERATE em nenhum warehouse, o Performance Explorer exibirá um erro de permissão para a atividade de consulta. Isso é intencional: sem pelo menos um warehouse autorizado, nenhuma métrica de consulta seria visível. Na prática, muitas contas incluem um warehouse padrão que todos os usuários podem monitorar; consulte Modelos do Snowsight.

Os filtros de warehouse listam os warehouses que você tem permissão para usar nos filtros (por exemplo, warehouses em que você pode usar MONITOR ou OPERATE e, em alguns casos, warehouses que tiveram atividade de consulta na janela de retenção). A visibilidade com escopo de warehouse é semelhante, em essência, às regras para Query History em Monitoramento da atividade de consulta com o Histórico de consultas, mas o Performance Explorer usa todas as funções concedidas a você e combina vários tipos de privilégios; portanto, as regras exatas diferem.

Filtros de banco de dados e detalhamentos orientados a banco de dados¶

Para visualizar todos os bancos de dados em filtros de banco de dados (e agregações relacionadas por banco de dados), qualquer função concedida a você deve atender a um dos seguintes requisitos:

• Sua função atende às condições para acesso total aos dados do Performance Explorer na conta (consulte a seção anterior).

• Sua função recebeu a função de banco de dados OBJECT_VIEWER no banco de dados SNOWFLAKE.

• Sua função tem RESOLVE ALL na conta.

• Sua função tem MONITOR na conta.

Caso contrário, você verá apenas os bancos de dados nos quais qualquer função concedida a você tenha pelo menos um privilégio no banco de dados. As consultas ainda podem aparecer em outras seções, mesmo que acessem um banco de dados que você não pode listar, exceto quando a UI nomeia explicitamente os bancos de dados (por exemplo, certos detalhamentos do painel lateral).

Eventos de warehouse¶

Para visualizar eventos de warehouse para todos os warehouses que aparecem em sua atividade de consulta autorizada, qualquer função concedida a você deve atender a um dos seguintes requisitos:

• Sua função atende às condições para acesso total aos dados do Performance Explorer na conta (consulte a seção anterior).

• Sua função recebeu a função de banco de dados USAGE_VIEWER no banco de dados SNOWFLAKE.

• Sua função tem o privilégio MONITOR na conta.

• Sua função tem o privilégio MANAGE WAREHOUSES na conta.

Caso contrário, os eventos do warehouse serão limitados aos warehouses nos quais você tem OWNERSHIP, MONITOR ou OPERATE. Se você não tiver nenhum desses privilégios de warehouse ou funções de banco de dados relacionadas ao uso, o Performance Explorer exibirá um erro de permissão para eventos de warehouse.

Top tables e table change events¶

A seção Top tables e table change events exigem acesso total ou a função de banco de dados GOVERNANCE_VIEWER no banco de dados SNOWFLAKE. O Snowflake não oferece uma alternativa com privilégios mais baixos por tabela para essas seções devido a restrições de segurança e desempenho. Se você não atender a esse requisito, essas seções exibirão um erro de permissão.

Gráficos vazios, resultados filtrados e erros de permissão¶

Por motivos de segurança, um gráfico ou tabela vazio pode significar que não houve atividade no período selecionado ou que suas funções não podem ver essa atividade. Erros de permissão em nível de bloco indicam privilégios ausentes (por exemplo, visibilidade de governança para métricas de tabela).

Alterações de privilégio e atualização de dados¶

As atualizações de concessões e revogações podem levar algumas horas para afetar o que o Performance Explorer exibe.

Filtros do Performance Explorer¶

Na parte de cima do painel do Performance Explorer, você pode aplicar os seguintes filtros:

• Preset – escolha None ou uma combinação salva de filtros de período, data warehouse, banco de dados e função. No menu, você pode salvar os filtros atuais como uma nova predefinição, limpar todos os filtros, copiar um link que codifica os filtros atuais e gerenciar predefinições salvas (por exemplo, definir ou alterar uma predefinição padrão).

  

• Period - Selecione um período, como a última semana, as últimas duas semanas ou um intervalo personalizado. O painel mostra métricas para o período especificado.

  Por padrão, o Performance Explorer exibe métricas para uma semana. Ela oferece suporte a um período de até um mês, retornando a partir da data atual.

  Vários gráficos do Performance Explorer mostram a porcentagem de alteração em comparação ao período anterior. O intervalo do período anterior corresponde ao intervalo do período atual. Por exemplo, se o período atual é de duas semanas, então o período anterior são as duas semanas antes do período atual começar.

• Warehouse - Selecione um warehouse para visualizar métricas somente para a atividade de consulta executada usando esse warehouse. Para limitar os warehouses na lista, use o campo de pesquisa. Para limpar o filtro, selecione X.

• Database – selecione um banco de dados para visualizar métricas apenas para a atividade de consulta que acessou esse banco de dados. Para limitar os bancos de dados na lista, use o campo de pesquisa. Para limpar o filtro, selecione X.

• Role - Selecione uma função para visualizar métricas somente para a atividade de consulta iniciada por essa função. Para limitar as funções na lista, use o campo de pesquisa. Para limpar o filtro, selecione X.

Gráficos do Performance Explorer¶

O Performance Explorer exibe métricas em diferentes tipos de gráficos. É importante entender os componentes de cada tipo de gráfico e como interpretá-los.

Na guia Queries, as métricas do gráfico de linhas usam gráficos de linhas semelhantes à imagem a seguir:

A tabela a seguir descreve os elementos da imagem:

Alguns gráficos incluem um valor médio ou mediano grande e a porcentagem de mudança para o período. Quando há mais de uma linha, há uma legenda para as linhas acima do gráfico.

Alguns gráficos têm um information icon ao lado do título. Passe o mouse sobre o ícone para obter informações sobre as métricas mostradas.

Você pode passar o mouse sobre um ponto do gráfico de linhas para ver o valor para uma hora específica:

A seção Principais warehouses na guia Warehouses e a seção Principais tabelas na guia Tables têm gráficos de barras semelhantes à imagem a seguir:

A tabela a seguir descreve os elementos da imagem:

Tanto nos gráficos de linhas como nos gráficos de barras, selecione View details > para abrir um painel lateral que exibe informações mais detalhadas sobre as métricas. As informações detalhadas variam de acordo com as métricas mostradas no gráfico. A maioria dos painéis laterais apresenta tabelas classificáveis ​​que você pode usar para revisar métricas de warehouses, funções, bancos de dados e consultas específicos no período.

Use o campo Search results acima da tabela para filtrar linhas; a pesquisa não diferencia maiúsculas de minúsculas e se aplica a todas as guias de agregação do painel lateral (por exemplo, By warehouse e By role). Selecione o controle de download para exportar a tabela como um arquivo CSV. O nome do arquivo baixado reflete o gráfico e os filtros ativos do painel.

Você pode selecionar um período personalizado em um painel lateral clicando onde o período personalizado começa e arrastando até onde ele termina.

Em um painel lateral, é possível selecionar uma das seguintes guias:

• By warehouse – mostra a atividade por warehouses no período.

• By database – mostra a atividade por bancos de dados no período.

• By role – mostra a atividade por funções no período.

• By grouped queries – mostra as consultas que foram executadas no período. Algumas consultas são censuradas por motivos de segurança. Para obter informações sobre como as consultas são agrupadas, consulte Como usar a exibição Histórico de consultas agrupadas no Snowsight.

Se você selecionar um período personalizado, essas guias serão atualizadas para mostrar as métricas apenas para o período personalizado selecionado.

As seções Principais warehouses e Principais tabelas também incluem gráficos de eventos semelhantes à imagem a seguir:

Um gráfico de eventos mostra uma tabela ordenável de eventos para o tipo de objeto. Você pode examinar os dados em busca de eventos inesperados. Para mais informações sobre eventos de warehouse, consulte Exibição WAREHOUSE_EVENTS_HISTORY. Para mais informações sobre eventos de tabela, consulte Exibição TABLES.