SHOW FUNCTIONS

Répertorie toutes les fonctions scalaires natives (c.-à-d. définies par le système ou intégrées) fournies par Snowflake, ainsi que les UDFs (fonctions définies par utilisateur) qui ont été créés pour votre compte.

Pour plus d’informations, voir Référence aux fonctions et procédures stockées, Vue d’ensemble des fonctions définies par l’utilisateur, et Écriture de fonctions externes.

Voir aussi :

SHOW USER FUNCTIONS , SHOW EXTERNAL FUNCTIONS , CREATE FUNCTION , DROP FUNCTION , ALTER FUNCTION , DESCRIBE FUNCTION

Syntaxe

SHOW FUNCTIONS [ LIKE '<pattern>' ]
               [ IN
                    {
                      ACCOUNT                  |

                      CLASS <class_name>       |

                      DATABASE                 |
                      DATABASE <database_name> |

                      SCHEMA                   |
                      SCHEMA <schema_name>     |
                      <schema_name>
                    }
               ]
Copy

Paramètres

LIKE 'pattern'

(Facultatif) Filtre la sortie de commande par nom d’objet. Le filtre utilise une concordance de motif insensible à la casse avec prise en charge des caractères génériques SQL (% et _).

Par exemple, les motifs suivants donnent les mêmes résultats :

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. Par défaut : aucune valeur (aucun filtrage n’est appliqué à la sortie).

[ IN ... ]

Spécifie de manière facultative la portée de la commande. Spécifie l’un des éléments suivants :

ACCOUNT

Renvoie les enregistrements pour l’ensemble du compte.

CLASS class_name

Renvoie les enregistrements de la classe spécifiée (class_name).

DATABASE, . DATABASE db_name

Renvoie les enregistrements pour la base de données en cours d’utilisation ou une base de données spécifiée (db_name).

Si vous spécifiez DATABASE sans db_name et qu’aucune base de données n’est utilisée, le mot-clé n’a aucun effet sur la sortie.

SCHEMA, . SCHEMA schema_name, . schema_name

Renvoie les enregistrements pour le schéma en cours d’utilisation ou un schéma spécifié (schema_name).

SCHEMA est facultatif si une base de données est utilisée ou si vous spécifiez le schema_name complet (par exemple, db.schema).

Si aucune base de données n’est utilisée, spécifier SCHEMA n’a aucun effet sur la sortie.

Par défaut : dépend si la session dispose actuellement d’une base de données en cours d’utilisation :

  • Base de données : DATABASE est la valeur par défaut (c’est-à-dire que la commande renvoie les objets que vous pouvez visualiser dans la base de données).

  • Aucune base de données : ACCOUNT est la valeur par défaut (c’est-à-dire que la commande renvoie les objets que vous pouvez visualiser dans votre compte).

Sortie

La sortie de commande fournit les propriétés des fonctions et les métadonnées dans les colonnes suivantes :

Colonne

Description

created_on

Horodatage auquel la fonction a été créée.

name

Nom de la fonction.

schema_name

Nom du schéma dans lequel la fonction existe. (NULL pour les fonctions intégrées.)

is_builtin

Y si la fonction est une fonction intégrée ; N dans les autres cas.

is_aggregate

Y si la fonction est une fonction d’agrégation ; N dans les autres cas.

is_ansi

Y si la fonction est définie comme faisant partie de la norme ANSI SQL ; N dans les autres cas.

min_num_arguments

Nombre minimum d’arguments.

max_num_arguments

Nombre maximum d’arguments.

arguments

Types de données des arguments et de la valeur renvoyée. Les arguments facultatifs sont affichés avec le mot-clé DEFAULT.

description

Description de la fonction.

catalog_name

Nom de la base de données dans laquelle la fonction existe. (NULL pour les fonctions intégrées.)

is_table_function

Y si la fonction est une fonction de table ; N dans les autres cas.

valid_for_clustering

Y si la fonction peut être utilisée dans une expression CLUSTER BY ; N dans les autres cas.

is_secure

Y si la fonction est une fonction sécurisée ; N dans les autres cas.

is_external_function

Y si la fonction est une fonction externe ; N dans les autres cas.

language

Pour les fonctions intégrées, cette colonne indique « SQL ».

Pour les fonctions définies par l’utilisateur, cette colonne indique la langue dans laquelle la fonction a été écrite, par exemple, « JAVASCRIPT » ou « SQL ».

Pour les fonctions externes, cette colonne indique « EXTERNAL ».

is_memoizable

Y si la fonction est mémoïsable ; N dans les autres cas.

is_data_metric

Cette colonne est un espace réservé pour une fonctionnalité future.

Notes sur l’utilisation

  • Les colonnes qui commencent par le préfixe is_ renvoient soit Y (oui), soit N (non).

  • L’exécution de la commande ne nécessite pas un entrepôt virtuel en cours d’exécution.

  • La commande retourne un maximum de 10 000 enregistrements pour le type d’objet spécifié, comme dicté par les privilèges d’accès pour le rôle utilisé pour exécuter la commande ; tous les enregistrements au-dessus de la limite de 10 000 enregistrements ne sont pas retournés, même avec un filtre appliqué.

    Pour afficher les résultats pour lesquels il existe plus de 10 000 enregistrements, interrogez la vue correspondante (s’il en existe une) dans Schéma d’information de Snowflake.

  • Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN, qui traite la sortie comme une table qui peut être interrogée.

  • Si vous spécifiez CLASS, la commande ne renvoie que les colonnes suivantes :

    | name | min_num_arguments | max_num_arguments | arguments | descriptions | language |
    
  • La sortie de cette commande peut inclure des objets portant des noms tels que SN_TEMP_OBJECT_<n> (où <n> est un nombre). Ce sont des objets temporaires qui sont créés par la bibliothèque Snowpark au nom de l’utilisateur.

Exemples

Afficher toutes les fonctions :

SHOW FUNCTIONS;
Copy

Afficher uniquement les fonctions correspondant à l’expression régulière spécifiée :

SHOW FUNCTIONS LIKE 'SQUARE';

------------+--------+-------------+------------+--------------+---------+-------------------+-------------------+----------------------------------------------------------------------+------------------------------------------------------------+----------+---------------+----------------+
 created_on | name   | schema_name | is_builtin | is_aggregate | is_ansi | min_num_arguments | max_num_arguments |                               arguments                              |                      description                           | language | is_memoizable | is_data_metric |
------------+--------+-------------+------------+--------------+---------+-------------------+-------------------+----------------------------------------------------------------------+------------------------------------------------------------+----------+---------------+----------------+
            | SQUARE |             | Y          | N            | Y       | 1                 | 1                 | SQUARE(NUMBER(38,0)) RETURN NUMBER(38,0), SQUARE(FLOAT) RETURN FLOAT | Compute the square of the input expression.                | SQL      | N             | N              |
------------+--------+-------------+------------+--------------+---------+-------------------+-------------------+----------------------------------------------------------------------+------------------------------------------------------------+----------+---------------+----------------+
Copy