Categories:

Data Loading / Unloading DDL

DESCRIBE PIPE

Describes the properties specified for a pipe, as well as the default values of the properties.

DESCRIBE can be abbreviated to DESC.

See also:

DROP PIPE , ALTER PIPE , CREATE PIPE , SHOW PIPES

Syntax

DESC[RIBE] PIPE <name>

Parameters

name

Specifies the identifier for the pipe to describe. If the identifier contains spaces or special characters, the entire string must be enclosed in double quotes. Identifiers enclosed in double quotes are also case-sensitive.

Usage Notes

  • Returns results only for the pipe owner (i.e. the role with the OWNERSHIP privilege on the pipe), a role with the MONITOR or OPERATE privilege on the pipe, or a role with the global MONITOR EXECUTION privilege.

  • To determine the current status of a pipe, query the SYSTEM$PIPE_STATUS function.

  • To post-process the output of this command, you can use the RESULT_SCAN function, which treats the output as a table that can be queried.

Output

The command output provides pipe properties and metadata in the following columns:

| created_on | name | database_name | schema_name | definition | owner | notification_channel | comment | integration | pattern | error_integration |

Column

Description

created_on

Date and time when the pipe was created.

name

Name of the pipe.

database_name

Database in which the pipe is stored.

schema_name

Schema in which the pipe is stored.

definition

COPY statement used to load data from queued files into a Snowflake table.

owner

Name of the role that owns the pipe (i.e. that has the OWNERSHIP privilege on the pipe).

notification_channel

Amazon Resource Name of the Amazon SQS queue for the stage named in the DEFINITION column.

comment

Comment for this pipe.

integration

Name of the notification integration for pipes that rely on notification events to trigger data loads from Google Cloud Storage or Microsoft Azure cloud storage.

pattern

PATTERN copy option value in the COPY INTO <table> statement in the pipe definition, if the copy option was specified.

error_integration

Notification integration name for pipes that rely on error events in Amazon S3 cloud storage to trigger notifications.

Examples

Describe the mypipe pipe created in the examples in CREATE PIPE:

desc pipe mypipe;

+-------------------------------+--------+---------------+-------------+---------------------------------+----------+---------+
| created_on                    | name   | database_name | schema_name | definition                      | owner    | comment |
|-------------------------------+--------+---------------+-------------+---------------------------------+----------+---------|
| 2017-08-15 06:11:05.703 -0700 | MYPIPE | MYDATABASE    | PUBLIC      | copy into mytable from @mystage | SYSADMIN |         |
+-------------------------------+--------+---------------+-------------+---------------------------------+----------+---------+
Back to top