Schéma :

ACCOUNT_USAGE

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, MY_TABLE-STREAMING.

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);
Copy