COMPLETE_TASK_GRAPHS¶

Syntaxe¶

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

Arguments¶

Tous les arguments sont facultatifs.

RESULT_LIMIT => integer

Un nombre spécifiant le nombre maximum de lignes renvoyé par la fonction. Notez que les résultats sont renvoyés dans l’ordre COMPLETED_TIME décroissant. Si le nombre de lignes correspondantes est supérieur à cette limite de résultats, les exécutions de graphiques avec l’horodatage terminé le plus récent sont renvoyées, jusqu’à la limite spécifiée.

Plage : de 1 à 10000

Par défaut : 1000

ROOT_TASK_NAME => string

Une chaîne insensible à la casse spécifiant le nom de la tâche racine. Seuls les noms de tâches non qualifiés sont pris en charge. Seules les exécutions de graphiques pour la tâche spécifiée sont renvoyées. Notez que si plusieurs tâches portent le même nom, la fonction renvoie les exécutions de graphiques pour chacune de ces tâches.

ERROR_ONLY => TRUE | FALSE

Lorsqu’elle a pour valeur TRUE, cette fonction renvoie uniquement les exécutions de graphiques qui ont échoué ou qui ont été annulées.

Notes sur l’utilisation¶

• Renvoie les résultats uniquement pour le rôle ACCOUNTADMIN , le propriétaire de la tâche (c’est-à-dire le rôle doté du privilège OWNERSHIP sur la tâche) ou un rôle disposant du privilège global MONITOR EXECUTION. Notez qu’à moins qu’un rôle avec le privilège MONITOR EXECUTION ne dispose également du privilège USAGE sur la base de données et le schéma qui stockent la tâche, les valeurs DATABASE_NAME et SCHEMA_NAME dans la sortie sont NULL.

• Cette fonction renvoie un maximum de 10 000 lignes, définies dans la valeur de l’argument RESULT_LIMIT. La valeur par défaut est 1000. Pour éviter cette limitation, utilisez la vue COMPLETE_TASK_GRAPHS (Account Usage).

• Lorsque la fonction COMPLETE_TASK_GRAPHS est interrogée, ses arguments de nom de tâche et de limite de résultats sont appliqués d’abord , suivis des clauses WHERE et LIMIT, respectivement, si elles sont spécifiées. En outre, la fonction renvoie les enregistrements dans l’ordre COMPLETED_TIME décroissant.

  En pratique, si de nombreux graphiques de tâches ont terminé leur exécution dans votre compte au cours de l’heure précédente, les résultats renvoyés par la fonction peuvent ne pas inclure un enregistrement attendu, surtout si la valeur RESULT_LIMIT est relativement faible.

• Lors de l’appel d’une fonction de table Information Schema, la session doit avoir un schéma INFORMATION_SCHEMA en cours d’utilisation ou le nom de la fonction doit être complètement qualifié. Pour plus de détails, voir Schéma d’information de Snowflake.

Sortie¶

La fonction renvoie les colonnes suivantes :

Exemples¶

Récupère les 1 000 dernières exécutions de graphiques terminées dans le compte. Notez que le nombre maximum de lignes renvoyées par la fonction est limité à 1 000 par défaut. Pour changer le nombre de lignes renvoyées, modifiez la valeur de l’argument RESULT_LIMIT :

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

Copy

Récupère les 10 exécutions terminées de graphiques les plus récentes pour un graphique de tâches spécifié au cours de la dernière heure :

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

Copy