Schéma :

ORGANIZATION_USAGE

Vue PIPES

Important

Cette vue n’est disponible que dans le compte de l’organisation. Pour plus d’informations, voir Vues premium dans le compte de l’organisation.

Cette vue Utilisation de l’organisation affiche une ligne pour chaque canal défini dans un compte.

Colonnes

Colonnes au niveau de l’organisation

Nom de la colonne

Type de données

Description

ORGANIZATION_NAME

VARCHAR

Nom de l’organisation.

ACCOUNT_LOCATOR

VARCHAR

Identificateur du compte généré par le système.

ACCOUNT_NAME

VARCHAR

Identificateur défini par l’utilisateur pour le compte.

Colonnes supplémentaires

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 24 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.ORGANIZATION_USAGE.PIPES a join SNOWFLAKE.ORGANIZATION_USAGE.PIPE_USAGE_HISTORY b
on a.pipe_id = b.pipe_id
where b.START_TIME > date_trunc(month, current_date);
Copy