COMPLETE_TASK_GRAPHS¶

Sintaxe¶

COMPLETE_TASK_GRAPHS(
      [ RESULT_LIMIT => <integer> ]
      [, ROOT_TASK_NAME => '<string>' ]
      [, ERROR_ONLY => { TRUE | FALSE } ] )

Argumentos¶

Todos os argumentos são opcionais.

RESULT_LIMIT => integer

Um número especificando o número máximo de linhas retornadas pela função. Note que os resultados são devolvidos em ordem decrescente de COMPLETED_TIME. Se o número de linhas correspondentes for maior do que o limite de resultados, as execuções gráficas com o carimbo de data/hora mais recente completado serão devolvidas, até o limite especificado.

Intervalo: 1 a 10000

Padrão: 1000

ROOT_TASK_NAME => string

Uma cadeia de caracteres que não diferencia maiúsculas e minúsculas, especificando o nome da tarefa raiz. Somente nomes de tarefas não qualificadas são suportados. Somente as execuções de gráfico para a tarefa especificada são retornadas. Observe que se várias tarefas tiverem o mesmo nome, a função retorna a execução de gráfico para cada uma dessas tarefas.

ERROR_ONLY => TRUE | FALSE

Quando definida como TRUE, esta função retorna apenas execuções de gráficos que falharam ou foram canceladas.

Notas de uso¶

• Retorna resultados somente para a função ACCOUNTADMIN, o proprietário da tarefa (ou seja, a função com o privilégio OWNERSHIP para a tarefa) ou uma função com o privilégio global MONITOR EXECUTION. Observe que a menos que uma função com o privilégio MONITOR EXECUTION também tenha o privilégio USAGE no banco de dados e esquema que armazena a tarefa, os valores DATABASE_NAME e SCHEMA_NAME na saída serão NULL.

• Esta função retorna um máximo de 10.000 linhas, definido no valor do argumento RESULT_LIMIT. O valor padrão é 1000. Para evitar esta limitação, use a exibição COMPLETE_TASK_GRAPHS (Account Usage).

• Quando a função COMPLETE_TASK_GRAPHS é consultada, seu nome de tarefa e os argumentos de limite de resultado são aplicados primeiro, seguido da cláusula WHERE e LIMIT, respectivamente, se especificado. Além disso, a função retorna registros em ordem decrescente COMPLETED_TIME.

  Na prática, se muitos gráficos de tarefas tiverem sido executados na sua conta na hora anterior, os resultados retornados pela função poderão não incluir um registro esperado, especialmente se o valor RESULT_LIMIT for relativamente baixo.

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

Exemplos¶

Recupere as 1.000 execuções gráficas mais recentes concluídas na conta. Observe que o número máximo de linhas retornadas pela função é limitado a 1000 por padrão. Para alterar o número de linhas devolvidas, modifique o valor do argumento RESULT_LIMIT:

select *
  from table(information_schema.complete_task_graphs())
  order by scheduled_time;

Copy

Recuperar as 10 execuções de gráfico concluídas mais recentemente para um gráfico de tarefas especificado na última hora:

select *
  from table(information_schema.complete_task_graphs (
    result_limit => 10,
    root_task_name=>'MYTASK'));

Copy