Catégories :: Information Schema , Fonctions de table

TASK_DEPENDENTS¶

Cette fonction de table renvoie la liste des tâches enfant pour une tâche racine donnée dans un graphique de tâches.

Syntaxe¶

TASK_DEPENDENTS(
      TASK_NAME => '<string>'
      [, RECURSIVE => <Boolean> ] )

Copy

Arguments¶

TASK_NAME => 'string'

Une chaîne de caractères spécifiant une tâche. La fonction renvoie la tâche racine spécifiée en tant que première entrée, suivie de la liste des tâches enfants.

Notez que le nom complet doit être placé entre guillemets simples, y compris la base de données et le schéma (si le nom est complètement qualifié), c’est-à-dire '<bd>.<schéma>.<nom_tâche>'.
Si le nom du canal est sensible à la casse ou inclut des caractères spéciaux ou des espaces, des guillemets doubles sont nécessaires pour traiter la casse/les caractères. Les guillemets doubles doivent être placés entre guillemets simples, c’est-à-dire '"<nom_tâche>"'.

RECURSIVE => Boolean

Spécifie si la sortie doit inclure uniquement les tâches enfants directes ou inclure toutes les tâches enfants récursives.

Valeurs:

TRUE : Renvoie toutes les tâches enfants récursives (enfants, petits-enfants, etc.) dans la sortie.

FALSE : Renvoie uniquement les tâches enfants directes dans la sortie.

Par défaut : TRUE.

Notes sur l’utilisation¶

Renvoie uniquement les lignes du propriétaire d’une tâche (c’est-à-dire le rôle avec le privilège OWNERSHIP sur une tâche) ou un rôle avec le privilège MONITOR ou OPERATE sur une tâche.
Lors de l’appel d’une fonction de la 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 sortie de fonction fournit les propriétés des tables et les métadonnées dans les colonnes suivantes :

| created_on | name | database_name | schema_name | owner | comment | warehouse | schedule | predecessors | state | definition | condition |

Copy

Colonne	Description
`created_on`	Date et heure de création de la tâche.
`name`	Nom de la tâche.
`database_name`	Base de données pour le schéma de la tâche.
`schema_name`	Schéma de la tâche.
`owner`	Rôle qui possède la tâche (c.-à-d. qui dispose du privilège OWNERSHIP sur la tâche)
`comment`	Commentaire pour la tâche.
`warehouse`	Entrepôt virtuel qui fournit les ressources requises pour exécuter la tâche.
`schedule`	Planifiez l’exécution de la tâche. Affiche NULL si aucune planification n’est spécifiée.
`predecessors`	Tableau JSON de toutes les tâches identifiées dans le paramètre AFTER de la tâche (c’est-à-dire les tâches prédécesseurs). Lorsqu’elles sont exécutées avec succès jusqu’à leur terme, ces tâches déclenchent la tâche en cours. Les noms des tâches individuelles dans le tableau sont entièrement qualifiés (c’est-à-dire qu’ils incluent les noms de la base de données et du schéma du conteneur). . . Affiche un tableau vide si la tâche n’a pas de prédécesseur.
`state`	« Démarré » ou « Suspendu » en fonction de l’état actuel de la tâche.
`definition`	Instructions SQL exécutées lors de l’exécution de la tâche.
`condition`	Condition spécifiée dans la clause WHEN pour la tâche.

Exemples¶

Récupérer la liste des tâches enfants directes pour la tâche mydb.myschema.mytask :

select *
  from table(information_schema.task_dependents(task_name => 'mydb.myschema.mytask', recursive => false));

Copy