Catégories :: Information Schema , Fonctions de table

BIND_VALUES¶

Note

Pour utiliser cette fonction, le bundle de changements de comportement 2025_06 doit être activé dans votre compte. Ce bundle est désactivé par défaut.

Cette fonction de table INFORMATION_SCHEMA renvoie des informations sur les valeurs des variables de liaison utilisées dans les requêtes.

Syntaxe¶

BIND_VALUES( <query_id> )

Copy

Arguments¶

query_id

L’identificateur de chaîne d’une requête qui comprend une ou plusieurs variables de liaison.

Les IDs de requête Snowflake sont des chaînes uniques qui ressemblent 01b71944-0001-b181-0000-0129032279f6.

Si NULL, une table vide est renvoyée.

Notes sur l’utilisation¶

Renvoie les valeurs des variables de liaison pour les requêtes exécutées par l’utilisateur actuel. Renvoie également les valeurs des variables de liaison pour les requêtes qui sont exécutées par n’importe quel utilisateur lorsque le rôle actuellement actif dans la session de l’utilisateur, ou un rôle supérieur dans une hiérarchie, possède le privilègeMONITOR ou OPERATE pour les entrepôts gérés par l’utilisateur dans lesquels les requêtes ont été exécutées. Pour plus d’informations, voir Privilèges de l’entrepôt virtuel.
Lors de l’appel d’une fonction de 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 d’informations, voir Schéma d’information de Snowflake.
Cette fonction peut renvoyer toutes les requêtes exécutées au cours des sept derniers jours.
Cette fonction peut ne pas renvoyer les valeurs de liaison ou peut renvoyer une erreur dans les cas suivants :
- Définissez le paramètre au niveau du compte ALLOW_BIND_VALUES_ACCESS sur FALSE :
- Les variables de liaison ont des valeurs élevées qui dépassent les seuils de stockage Snowflake.
- Les requêtes ont un grand nombre de variables de liaison qui dépassent les seuils de stockage Snowflake.
- Les variables de liaison contiennent des données sensibles. L’extraction et le traitement sont effectués au mieux, et le fait que les données soient considérées comme sensibles dépend du contexte.
- L’appel de la fonction spécifie une requête qui comprend des liaisons de tableaux.
- L’appel de la fonction spécifie une requête qui n’existe pas.
- L’appel de la fonction spécifie une requête qui a expiré et qui ne figure plus dans l’historique des requêtes.

Sortie¶

La fonction de table BIND_VALUES produit une ligne pour chaque variable de liaison utilisée dans la requête spécifiée. Chaque ligne contient les colonnes suivantes :

Nom de la colonne	Type de données	Description
QUERY_ID	VARCHAR	ID de la requête.
POSITION	NUMBER	Pour les variables de liaison positionnelles, la position de la variable de liaison. Le champ est NULL pour les variables de liaison nommées.
NAME	VARCHAR	Pour les variables de liaison nommées, le nom de la variable de liaison. Le champ est NULL pour les variables de liaison positionnelles.
TYPE	VARCHAR	Le type de données Snowflake de la variable de liaison.
VALUE	VARCHAR	La valeur de la variable de liaison. Les valeurs de liaison qui contiennent plus de 100 000 caractères sont tronquées.

Exemples¶

Voir Récupérer les valeurs des variables de liaison.