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