Visualização de tarefas e gráficos de tarefa no Snowsight¶
As tarefas permitem programar a execução do código SQL. Uma tarefa está associada a um banco de dados e esquema específicos. Você pode usar a Snowsight para visualizar e gerenciar suas tarefas e gráficos de tarefa. Usando a Snowsight, você também pode visualizar o histórico de execução de tarefas e gráficos de tarefa, além de repetir tarefas que falharam.
Neste tópico:
Visualização e gerenciamento de tarefas individuais¶
Para visualizar e gerenciar uma tarefa em Snowsight, faça o seguinte:
Faça login no 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 o ID da tarefa, o warehouse usado pela tarefa, o cronograma, o estado, os parâmetros e quaisquer condições.
Revise a instrução SQL usada para criar a tarefa e quaisquer configurações de gráfico de 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 a tarefa, clonar a tarefa, descartar a tarefa ou transferir a propriedade da tarefa para outra função.
Quando você edita uma tarefa no Snowsight, a tarefa é automaticamente suspensa e retomada quando você termina de editá-la. Para obter mais informações sobre como suspender e retomar tarefas, consulte Controle de versão de execuções de tarefas.
Visualização e gerenciamento de gráficos de tarefa¶
Revise um gráfico de tarefas para ver uma tarefa raiz, suas tarefas dependentes e finalizar tarefas no formato de um gráfico de tarefa. Para obter mais informações sobre gráficos de tarefa, consulte Gerenciamento de dependências de tarefa com gráficos de tarefa. Ao revisar um gráfico de tarefa, você pode fazer o seguinte no Snowsight:
Visualizar as informações da tarefa.
Examinar o gráfico de 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.
Você também pode editar a tarefa raiz para alterar os parâmetros do gráfico de tarefa. Quando você edita uma tarefa no Snowsight, a tarefa é automaticamente suspensa e retomada quando você termina de editá-la. Para obter mais informações sobre como suspender e retomar tarefas, consulte Controle de versão de execuções de tarefas.

Para visualizar um gráfico de tarefas para um esquema específico de banco de dados, faça o seguinte:
Faça login no 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.
Visualização do histórico de tarefas¶
Por meio do Snowsight, você pode revisar o histórico de execução de tarefas de diferentes maneiras:
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.
Privilégios exigidos para visualizar o histórico de tarefas¶
Para visualizar o histórico de tarefas no Snowsight, você precisa dos mesmos privilégios necessários para executar a função TASK_HISTORY.
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 compartilhado SNOWFLAKE para a função que estiver usando.
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:
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:
Faça login no 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 ao 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:
Faça login no 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 ao 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 a função de banco de dados OBJECT_VIEWER. A página de histórico do gráfico de tarefa usa Exibição COMPLETE_TASK_GRAPHS. Para obter mais informações, consulte Funções do banco de dados SNOWFLAKE do esquema ACCOUNT_USAGE. Sua função também deve ter o privilégio OWNERSHIP na tarefa.
Faça login no 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 tarefa¶
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, suspensas 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.
Repetir tarefas que falharam¶
Na Snowsight, você pode ver tentativas de execução de tarefa anteriores e repetir manualmente os gráficos de tarefa com falha e canceladas. Você deve ter o privilégio OPERATE na tarefa para repetir tarefas com falha ou canceladas. Para exibir tentativas de execução de tarefa anteriores, você também precisa dos mesmos privilégios da visualização do histórico de tarefa.
Siga as seguintes etapas para repetir tarefas com falha ou canceladas.
Siga as etapas para abrir o histórico de gráficos de tarefas no nível da conta.
Na página de histórico de gráficos de tarefas no nível da conta, selecione uma execução específica de gráfico de tarefa para ver mais detalhes.
Na página de detalhes da execução de gráfico de tarefa específico, selecione Retry para repetir manualmente todas as execuções de gráfico de tarefa com falha.
A repetição inicia apenas tarefas com falha e canceladas em um gráfico e não executa novamente tarefas que já foram bem-sucedidas.
Selecione o botão Atualizar para atualizar a página. As tentativas com falha aparecem nos detalhes de execução do gráfico de tarefa no nível da conta. O histórico de execução de tarefa no nível da conta e o histórico de execução de gráfico de tarefa mostram o status da tentativa mais recente com uma latência de 45 minutos.
As tentativas com falha também aparecem no histórico de tarefas no nível do objeto. Siga as etapas para exibir o histórico de execução de uma tarefa. A última tentativa de execução é mostrada. Todas as tentativas de executar a tarefa têm o mesmo ID de execução.
Todas as tentativas anteriores com falha ou canceladas são mostradas ao lado do status da execução. Você pode selecionar a tarefa para ver o carimbo de data/hora agendado, o status e as mensagens de erro para cada tentativa.
Nota
O botão Retry será desabilitado se qualquer uma das seguintes condições for verdadeira:
Nenhuma tarefa no gráfico falhou ou foi cancelada.
Uma repetição já está em andamento.
A execução selecionada não é a mais recente.
O gráfico de tarefa foi modificado após a execução.
A execução dura mais de 14 dias.