Catégories :

Schéma d’information, Fonctions de table

TASK_DEPENDENTS

Cette fonction de table retourne la liste des tâches enfant pour une tâche racine donnée (c’est-à-dire parent) dans une arborescence de tâches simple.

Syntaxe

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

Arguments

TASK_NAME => 'chaîne'

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 => Booléen

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.

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 | comment | warehouse | schedule | state | definition | condition

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.

predecessor

Tâche qui déclenche cette tâche lorsqu’elle est exécutée avec succès. Affiche NULL si aucun prédécesseur n’est spécifié.

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));