PIPES view

This Information Schema view displays a row for each pipe defined in the specified (or current) database.

Columns

Column NameData TypeDescription
PIPE_CATALOGVARCHARDatabase that the pipe belongs to
PIPE_SCHEMAVARCHARSchema that the pipe belongs to
PIPE_NAMEVARCHARName of the pipe
PIPE_OWNERVARCHARName of the role that owns the pipe
DEFINITIONVARCHARCOPY statement used to load data from queued files into a Snowflake table.
IS_AUTOINGEST_ENABLEDVARCHARWhether AUTO-INGEST is enabled for the pipe. Represents future functionality.
NOTIFICATION_CHANNEL_NAMEVARCHARAmazon Resource Name of the Amazon SQS queue for the stage named in the DEFINITION column. Represents future functionality.
CREATEDTIMESTAMP_LTZCreation time of the pipe
LAST_ALTEREDTIMESTAMP_LTZDate and time the object was last altered by a DML, DDL, or background metadata operation. See Usage Notes.
COMMENTVARCHARComment for this pipe
PATTERNVARCHARPATTERN copy option value in the COPY INTO <table> statement in the pipe definition, if the copy option was specified.

Usage notes

  • Returns results only for the pipe owner (i.e. the role with the OWNERSHIP privilege on the pipe) or a role with the MONITOR privilege on the pipe.
  • To determine the current status of a pipe, query the SYSTEM$PIPE_STATUS function.
  • The LAST_ALTERED column is updated when the following operations are performed on an object:

    • DDL operations.
    • DML operations (for tables only). This column is updated even when no rows are affected by the DML statement.
    • Background maintenance operations on metadata performed by Snowflake.