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

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

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

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

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.