- Schéma :
Vue PIPES¶
Cette vue Utilisation du compte affiche une ligne pour chaque canal défini dans le compte.
Colonnes¶
Nom de la colonne |
Type de données |
Description |
|---|---|---|
PIPE_ID |
NUMBER |
Internal or system-generated identifier for the pipe. |
PIPE_NAME |
VARCHAR |
The name of the pipe object. Pour les canaux créés manuellement, il s’agit du nom défini dans l’instruction CREATE PIPE. Pour le canal par défaut hautes performances de Snowpipe Streaming, celui-ci est dérivé du nom de la table cible ; par exemple, |
PIPE_SCHEMA_ID |
NUMBER |
Internal or system-generated identifier for the schema that the pipe belongs to. Pour le canal par défaut, celui-ci correspond à l’ID du schéma de la table cible. |
PIPE_SCHEMA |
VARCHAR |
Schéma auquel le canal appartient. Pour le canal par défaut, celui-ci correspond au schéma de la table cible. |
PIPE_CATALOG_ID |
NUMBER |
Internal or system-generated identifier for the database that the pipe belongs to. Pour le canal par défaut, celui-ci correspond à l’ID de la base de données de la table cible. |
PIPE_CATALOG |
VARCHAR |
Name of the database that the pipe belongs to. Pour le canal par défaut, celui-ci correspond à la base de données de la table cible. |
IS_AUTOINGEST_ENABLED |
VARCHAR |
Si AUTO-INGEST est activé pour le canal. Représente les fonctionnalités futures. |
NOTIFICATION_CHANNEL_NAME |
VARCHAR |
Nom de la ressource Amazon de la file d’attente SQS d’Amazon pour la zone de préparation nommée dans la colonne DEFINITION. Représente les fonctionnalités futures. |
PIPE_OWNER |
VARCHAR |
Nom du rôle propriétaire du canal. Renvoie NULL pour le canal par défaut. |
DEFINITION |
VARCHAR |
Instruction COPY utilisée pour charger des données à partir de fichiers en file d’attente dans une table Snowflake. |
CREATED |
TIMESTAMP_LTZ |
Heure de création du canal. |
LAST_ALTERED |
TIMESTAMP_LTZ |
Date et heure de la dernière modification de l’objet par un DML, un DDL ou une opération de métadonnées en arrière-plan. Consultez Notes sur l’utilisation. |
COMMENT |
VARCHAR |
Commentaire pour ce canal. Renvoie le message suivant pour le canal par défaut : « Canal par défaut pour l’ingestion hautes performances de Snowpipe Streaming dans une table. Créé et géré par Snowflake. » |
PATTERN |
VARCHAR |
La valeur de l’option de copie PATTERN dans l’instruction COPY INTO <table> de la définition du canal, si l’option de copie a été spécifiée. |
DELETED |
TIMESTAMP_LTZ |
Date et heure de suppression du canal. |
OWNER_ROLE_TYPE |
VARCHAR |
Type de rôle propriétaire de l’objet ; par exemple, ROLE. Si Snowflake Native App est propriétaire de l’objet, la valeur est APPLICATION. Snowflake renvoie NULL si vous supprimez l’objet, car un objet supprimé n’a pas de rôle de propriétaire. Renvoie NULL pour le canal par défaut. |
Notes sur l’utilisation¶
La latence pour la vue peut atteindre 180 minutes (3 heures).
La vue n’affiche que les objets pour lesquels le rôle actuel de la session s’est vu accorder des privilèges d’accès.
La vue ne reconnaît pas le privilège MANAGE GRANTS et peut par conséquent afficher moins d’informations par rapport à une commande SHOW exécutée par un utilisateur détenteur du privilège MANAGE GRANTS.
La colonne LAST_ALTERED est mise à jour lorsque les opérations suivantes sont effectuées sur un objet :
DDL opérations.
DML opérations (pour les tables uniquement). Cette colonne est mise à jour même si aucune ligne n’est affectée par l’instruction DML.
Opérations de maintenance des métadonnées en arrière-plan effectuées par Snowflake.
Exemples¶
L’exemple suivant joint cette vue à Vue PIPE_USAGE_HISTORY dans la colonne PIPE_ID pour suivre l’utilisation du crédit associé à chaque objet PIPE unique :
select a.PIPE_CATALOG as PIPE_CATALOG,
a.PIPE_SCHEMA as PIPE_SCHEMA,
a.PIPE_NAME as PIPE_NAME,
b.CREDITS_USED as CREDITS_USED
from SNOWFLAKE.ACCOUNT_USAGE.PIPES a join SNOWFLAKE.ACCOUNT_USAGE.PIPE_USAGE_HISTORY b
on a.pipe_id = b.pipe_id
where b.START_TIME > date_trunc(month, current_date);