Fonctions de table¶

Les fonctions de table renvoient un ensemble de lignes au lieu d’une seule valeur scalaire. Les fonctions de table apparaissent dans la clause FROM d’une instruction SQL et ne peuvent pas être utilisées comme des fonctions scalaires. Les fonctions de table prennent les expressions scalaires en entrée.

Note

Vous pouvez également définir des UDFs de table qui retournent des lignes d’une requête SQL ou JavaScript. Pour plus d’informations, voir Fonctions définies par l’utilisateur (UDFs).

Dans ce chapitre :

Liste des fonctions de table définies par le système
Syntaxe
Notes sur l’utilisation

Liste des fonctions de table définies par le système¶

Snowflake offre les fonctions de table suivantes définies par le système :

Sous-catégorie	Fonction	Remarques
Chargement des données	VALIDATE	Pour plus d’informations, voir Chargement de données dans Snowflake.
Génération de données	GENERATOR
Conversion de données	SPLIT_TO_TABLE
Conversion de données	STRTOK_SPLIT_TO_TABLE
Modélisation d’objet	GET_OBJECT_REFERENCES
Requêtes semi-structurées	FLATTEN	Pour plus d’informations, voir Interrogation de données semi-structurées.
Résultats de la recherche	RESULT_SCAN	Peut être utilisé pour effectuer des opérations SQL sur la sortie d’une autre opération SQL (par ex. SHOW).
Historique et informations d’utilisation (Schéma d’information) :
Connexion de l’utilisateur	LOGIN_HISTORY , LOGIN_HISTORY_BY_USER
Requêtes	QUERY_HISTORY , QUERY_HISTORY_BY_*
Utilisation de l’entrepôt virtuel et de l’espace de stockage	DATABASE_STORAGE_USAGE_HISTORY
	WAREHOUSE_LOAD_HISTORY
	WAREHOUSE_METERING_HISTORY
	STAGE_STORAGE_USAGE_HISTORY
Sécurité au niveau des colonnes	POLICY_REFERENCES
Réplication de base de données	DATABASE_REFRESH_HISTORY DATABASE_REFRESH_PROGRESS , DATABASE_REFRESH_PROGRESS_BY_JOB REPLICATION_USAGE_HISTORY	Pour plus d’informations, voir Réplication de bases de données sur plusieurs comptes
Chargement et transfert des données	COPY_HISTORY
	DATA_TRANSFER_HISTORY
	PIPE_USAGE_HISTORY
	VALIDATE_PIPE_LOAD
Clustering des données (dans des tables)	AUTOMATIC_CLUSTERING_HISTORY	Pour plus d’informations, voir Clustering automatique
Fonctions externes	EXTERNAL_FUNCTIONS_HISTORY	Pour plus d’informations, voir Fonctions externes
Entretien des tables externes	EXTERNAL_TABLE_FILES	Pour plus d’informations, voir Travailler avec des tables externes
Entretien des tables externes	EXTERNAL_TABLE_FILE_REGISTRATION_HISTORY
Maintenance des vues matérialisées	MATERIALIZED_VIEW_REFRESH_HISTORY	Pour plus d’informations, voir Travailler avec des vues matérialisées
Maintenance SCIM	REST_EVENT_HISTORY	Pour plus d’informations, voir Audit avec SCIM
Maintenance de l’optimisation de la recherche	SEARCH_OPTIMIZATION_HISTORY	Pour plus d’informations, voir Utilisation du service d’optimisation de la recherche
Maintenance des tâches	TASK_DEPENDENTS	Pour plus d’informations, voir Exécution d’instructions SQL sur une planification à l’aide de tâches
Maintenance des tâches	TASK_HISTORY

Syntaxe¶

SELECT ...
  FROM [ <input_table> [ [AS] <alias_1> ] ,
         [ LATERAL ]
       ]
       TABLE( <table_function>( [ <arg_1> [, ... ] ] ) ) [ [ AS ] <alias_2> ];

Pour connaître la syntaxe spécifique à une fonction, reportez-vous à la documentation relative aux fonctions de table définies par le système.

Notes sur l’utilisation¶

Les fonctions de table peuvent également être appliquées à un ensemble de lignes à l’aide de la construction LATERAL.
Pour activer l’utilisation des expressions de table, Snowflake prend en charge la syntaxe standard ANSI/ISO pour les expressions de table dans la clause FROM des requêtes et sous-requêtes. Cette syntaxe est utilisée pour indiquer qu’une expression renvoie une collection de lignes au lieu d’une seule.
Cette syntaxe ANSI/ISO n’est valide que dans la clause FROM de la liste SELECT. Vous ne pouvez pas omettre ces mots-clés et parenthèses d’une spécification de sous-requête de collection dans un autre contexte.