Visualização do histórico de tarefas na Snowsight¶
As tarefas permitem programar a execução do código SQL. Você pode criar um gráfico de tarefas para especificar como executar o código SQL especificado em uma tarefa raiz e um conjunto de tarefas dependentes. Uma tarefa está associada a um banco de dados e esquema específicos. Para obter mais detalhes sobre as tarefas, consulte Introdução às tarefas.
Usando Snowsight, você pode rever o histórico de execução de tarefas de várias maneiras diferentes:
Veja o histórico de execução de todas as tarefas executadas em sua conta, por exemplo, para identificar tarefas críticas que não foram executadas, tarefas de longa duração ou tarefas que aumentam os custos.
Veja o histórico de execução de uma tarefa específica para coletar mais informações sobre a tarefa.
Veja o histórico de execução para um gráfico de tarefas, para fins de observabilidade e monitoramento e para ajudar a identificar problemas com um gráfico de tarefas específico.
Você também pode revisar o histórico de tarefas em SQL usando uma função de tabela TASK_HISTORY ou uma exibição Exibição TASK_HISTORY.
Neste tópico:
Privilégios exigidos para ver o histórico de tarefas¶
Para visualizar o histórico de tarefas em Snowsight, você precisa dos mesmos privilégios necessários para executar as funções de tabela TASK_HISTORY e COMPLETE_TASK_GRAPHS.
Você precisa usar uma das seguintes funções:
A função ACCOUNTADMIN.
Uma função com o privilégio OWNERSHIP na tarefa.
Uma função com o privilégio global MONITOR EXECUTION e o privilégio USAGE no banco de dados e esquema que armazenam a tarefa.
A função que você usa deve ser capaz de consultar a exibição TASK_HISTORY do Account Usage. Você pode conceder a função de banco de dados USAGE_VIEWER no banco de dados SNOWFLAKE compartilhado com esta função.
Por exemplo, para visualizar o histórico de uma tarefa específica mytask, a função personalizada myrole precisa de:
Privilégio OWNERSHIP na tarefa.
Função de banco de dados USAGE_VIEWER no banco de dados SNOWFLAKE compartilhado.
Para conceder esses privilégios, execute os seguintes comandos SQL:
GRANT OWNERSHIP ON TASK mytask TO ROLE myrole;
GRANT DATABASE ROLE USAGE_VIEWER TO ROLE myrole;
Para obter mais detalhes, consulte:
Visualização e gerenciamento de tarefas individuais¶
Para visualizar e gerenciar uma tarefa em Snowsight, faça o seguinte:
Entre em Snowsight.
Selecione Data » Databases.
Para um banco de dados e esquema específicos, selecione Tasks e selecione a tarefa que deseja gerenciar.
Ao visualizar a tarefa no Snowsight, você pode fazer o seguinte:
Na seção Details, revise a ID da tarefa, o warehouse usado pela tarefa, o agendamento, o estado e quaisquer tarefas predecessoras.
Revise a instrução SQL usada para criar a tarefa na seção Task Definition.
Gerencie os privilégios na tarefa. Consulte Gerenciamento de privilégios de objetos com o Snowsight.
Selecione o botão de ações … para editar o nome ou comentário da tarefa, clonar a tarefa, descartar a tarefa ou transferir a propriedade da tarefa para outra função.
Visualização de gráficos de tarefas individuais¶
Reveja um gráfico de tarefas para ver uma tarefa raiz e suas tarefas dependentes no formato de um gráfico de tarefas. Ao rever um gráfico de tarefas, você pode fazer o seguinte:
Exibir informações de tarefa, incluindo status por tarefa raiz e tarefa dependente selecionada.
Examinar o gráfico de tarefas, incluindo a raiz e as tarefas dependentes no gráfico. Consulte Gráficos da tarefa.
Selecione uma tarefa no gráfico para visualizar detalhes adicionais, como as tarefas anteriores, o warehouse usado para executar a tarefa e a função proprietária da tarefa.
Para visualizar um gráfico de tarefas para um esquema específico de banco de dados, faça o seguinte:
Entre em Snowsight.
No menu de navegação, selecione Data » Databases.
Use o explorador de objetos para localizar o banco de dados e o esquema que contém as tarefas que você deseja visualizar.
Para o esquema selecionado, selecione Tasks.
Selecione uma tarefa específica.
Os detalhes da tarefa aparecem, com guias adicionais Graph e Run History.
Selecione a guia Graph para visualizar o gráfico de tarefas.
O gráfico de tarefas aparece, exibindo uma hierarquia de tarefas.
Selecione uma tarefa para visualizar detalhes no contexto do gráfico.
Nota
Os dados do histórico de tarefas só estão disponíveis se a tarefa tiver sido executada nos últimos 7 dias.
Revisão do histórico de execução de uma tarefa¶
O histórico de execução de tarefas inclui detalhes sobre cada execução de uma determinada tarefa. Você pode visualizar a hora programada, a hora real de início, a duração de uma tarefa e outras informações.
Para cada instância, você pode ver o seguinte:
Hora de início programada: quando a próxima tarefa está programada para execução.
Status: status da execução mais recente.
Duração: tempo, em segundos, da execução mais recente.
Consulta: visualizar o perfil de consulta de tarefa ou instruções de tarefa em uma planilha.
Para ver o histórico de execução:
Entre em Snowsight.
Selecione Data » Databases.
No painel direito, usando o navegador de objetos, navegue para um banco de dados e esquema.
Para o esquema selecionado, selecione e expanda Tasks.
Selecione uma tarefa. As informações da tarefa são exibidas, incluindo as subguias Task Details, Graph e Run History.
Selecione a guia Run History.
Nota
Os dados do histórico de tarefas só estão disponíveis se a tarefa tiver sido executada nos últimos 7 dias.
Revisão do histórico de tarefas no nível de conta¶
Revise o histórico no nível de conta para tarefas executadas para identificar tarefas com falha, tarefas de longa duração e outros casos de monitoramento e depuração para uma conta inteira, em vez de uma tarefa específica.
Para visualizar o histórico em nível de conta para tarefas, faça o seguinte:
Entre em Snowsight.
No menu de navegação, selecione Monitoring » Task History.
Para ver as tarefas individuais executadas, selecione View » Task Runs dos filtros.
Após selecionar o histórico de execução de tarefas, você pode filtrar a página para exibir informações relevantes.
Selecione o filtro Date Range para mostrar o histórico de tarefas desde o último dia até os últimos 12 meses, ou um intervalo personalizado.
Selecione o filtro Task status para exibir o histórico de tarefas para um ou mais status, como Succeeded, Failed, Cancelled ou Skipped.
Filtro no nome da tarefa para ver padrões em status ou duração ao longo do tempo para tarefas específicas.
Filtro no nome do banco de dados ou esquema que contém as tarefas.
Por exemplo, para identificar tarefas de longa duração, selecione o filtro Status para mostrar apenas tarefas bem sucedidas, e ordene o campo Duration em ordem decrescente. Para depuração avançada, você pode abrir a tabela filtrada e classificada em planilhas usando o botão Open in worksheets. Você poderia então modificar a instrução SQL com argumentos LIMIT / FETCH e GROUP BY para identificar os bancos de dados e esquemas com as 25 tarefas de maior execução.
Você também pode selecionar uma tarefa específica para obter mais detalhes.
Revisão do histórico de gráfico de tarefas no nível de conta¶
Revise o histórico em nível de conta para gráficos de tarefas para identificar tarefas críticas com falha que impedem a conclusão de um gráfico, tarefas de longa duração, gráficos de tarefas ineficientes ou com falhas frequentes, e outros casos de monitoramento e depuração para uma conta inteira.
Para visualizar o histórico em nível de conta para os gráficos de tarefas, faça o seguinte:
Nota
Você deve usar uma função que tenha os privilégios necessários para visualizar o histórico de tarefas.
Entre em Snowsight.
No menu de navegação, selecione Monitoring » Task History.
Por padrão, a página exibe todos os gráficos de tarefas executados a partir do último dia como um histograma e uma tabela.
Após selecionar o histórico de execuções do gráfico de tarefas, você pode filtrar a página para exibir informações relevantes.
Selecione o filtro Date Range para mostrar o histórico de tarefas por um período mais longo, até os últimos 12 meses.
Selecione o filtro Graph status para exibir o histórico de execução para um ou mais status de gráfico de tarefa, como Succeeded, Failed, Cancelled ou Skipped. Se uma tarefa no gráfico falhar, todo o gráfico será mostrado como Failed.
Filtre o nome do banco de dados e, opcionalmente, um esquema que contém as tarefas raiz dos gráficos de tarefas.
Depois de selecionar o banco de dados e o esquema opcional, filtre pelo nome da tarefa raiz para ver os padrões de status ou duração ao longo do tempo para tipos de tarefas específicos. Você poderá ver tarefas raiz que sua função ativa não tem privilégios para visualizar.
Por exemplo, para identificar gráficos de tarefas com tarefas com falha, selecione o filtro Graph status para mostrar apenas as tarefas com falha. Você pode passar o mouse sobre uma tarefa com falha para obter mais detalhes sobre a falha. Para depuração avançada, abra a tabela filtrada e classificada em planilhas usando o botão Open in worksheets. Você poderia então modificar a instrução SQL com argumentos LIMIT / FETCH e GROUP BY para identificar, por exemplo, os bancos de dados e esquemas com as 25 tarefas de maior falha.
Depuração de uma execução de gráfico de tarefas específicas¶
Ao visualizar o histórico do gráfico de tarefas em nível de conta, selecione um gráfico de tarefas específico executado para ver mais detalhes. Se você tiver acesso para visualizar o histórico das tarefas no gráfico, a execução do gráfico da tarefa será exibida; caso contrário, você verá um erro.
Por exemplo, você pode selecionar um gráfico de tarefas com falha específico para visualizar o gráfico completo e identificar as tarefas não foram executadas como resultado de tarefas com falha específicas, tarefas suspensas ou identificar uma tarefa de longa duração que está atrasando uma execução de tarefa dependente no gráfico.
Para uma tarefa específica no gráfico de tarefas, você pode reunir detalhes adicionais sobre a tarefa passando o mouse sobre vários aspectos da tarefa:
Os metadados do warehouse identificam qual warehouse é usado para executar a tarefa, incluindo o status e o tamanho, o que pode ajudar a identificar tarefas que estão sendo executadas lentamente devido ao tamanho do warehouse ou que estão contribuindo para o uso do warehouse.
Os metadados de condição de fluxo exibem os detalhes do fluxo da tabela e se as condições foram definidas como verdadeiras ou falsas para a tarefa.
Selecione Go to Task Page para visualizar detalhes adicionais sobre a tarefa.
Cada tarefa exibe um status, como Succeeded, Failed, Skipped, Suspended, Cancelled ou Did not run, com uma cor correspondente. Você pode passar o mouse sobre o status das tarefas com falha, ignoradas e canceladas para obter mais informações.
Além do gráfico de tarefas, você pode analisar uma tabela descrevendo quais tarefas foram executadas, a hora de início de cada tarefa, a duração de cada execução de tarefa, o status de cada tarefa e uma linha de tempo representando a sequência de execuções de tarefas. Com a linha do tempo, você pode determinar rapidamente por que uma execução gráfica de tarefa foi lenta, e qual tarefa de longa duração pode ter atrasado o início de uma tarefa dependente.
Para cada tarefa na tabela, você pode selecionar o menu … mais para abrir a ID de consulta para a tarefa em uma planilha, ou abrir o perfil da consulta.