- 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. For manually created pipes, this is the name defined in the CREATE PIPE statement. For the Snowpipe Streaming high-performance default pipe, this is derived from the target table name; for example, |
PIPE_SCHEMA_ID |
NUMBER |
Internal or system-generated identifier for the schema that the pipe belongs to. For the default pipe, this corresponds to the target table’s schema ID. |
PIPE_SCHEMA |
VARCHAR |
Schéma auquel le canal appartient. For the default pipe, this corresponds to the target table’s schema. |
PIPE_CATALOG_ID |
NUMBER |
Internal or system-generated identifier for the database that the pipe belongs to. For the default pipe, this corresponds to the target table’s database ID. |
PIPE_CATALOG |
VARCHAR |
Name of the database that the pipe belongs to. For the default pipe, this corresponds to the target table’s database. |
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. Returns NULL for the default pipe. |
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. Returns the following message for the default pipe: « Default pipe for Snowpipe Streaming High Performance ingestion to a table. Created and managed by 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 |
The type of role that owns the object; for example, ROLE. If a Snowflake Native App owns the object, the value is APPLICATION. Snowflake returns NULL if you delete the object because a deleted object doesn’t have an owner role. Returns NULL for the default pipe. |
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);