Categories:
Data Loading / Unloading DDL

SHOW PIPES

Lists the pipes for which you have access privileges. This command can be used to list the pipes for a specified database or schema (or the current database/schema for the session), or your entire account.

See also:
ALTER PIPE , CREATE PIPE , DESCRIBE PIPE , DROP PIPE

Syntax

SHOW PIPES [ LIKE '<pattern>' ]
           [ IN { ACCOUNT | [ DATABASE ] <db_name> | [ SCHEMA ] <schema_name> } ]

Parameters

LIKE 'pattern'

Filters the command output by object name. The filter uses case-insensitive pattern matching, with support for SQL wildcard characters (% and _).

For example, the following patterns return the same results:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...
IN ACCOUNT | [ DATABASE ] db_name | [ SCHEMA ] schema_name

Specifies the scope of the command, which determines whether the command lists records only for the current/specified database or schema, or across your entire account:

The DATABASE or SCHEMA keyword is not required; you can set the scope by specifying only the database or schema name. Likewise, the database or schema name is not required if the session currently has a database in use:

  • If DATABASE or SCHEMA is specified without a name and the session does not currently have a database in use, the parameter has no effect on the output.
  • If SCHEMA is specified with a name and the session does not currently have a database in use, the schema name must be fully qualified with the database name (e.g. testdb.testschema).

Default: Depends on whether the session currently has a database in use:

DB in use:DATABASE is the default (i.e. the command returns the objects you have privileges to view in the database).
DB not in use:ACCOUNT is the default (i.e. the command returns the objects you have privileges to view in your account).

Usage Notes

  • The command does not require a running warehouse to execute.

  • The command returns a maximum of 10K records for the specified object type, as dictated by the access privileges for the role used to execute the command; any records above the 10K limit are not returned, even with a filter applied.

    To view results for which more than 10K records exist, query the corresponding view (if one exists) in the Information Schema.

  • 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.

Examples

Show all the pipes that you have privileges to view in the public schema in the mydb database:

use database mydb;

show pipes;

+-------------------------------+---------+---------------+-------------+--------------------------------------------------------------+----------+---------+
| created_on                    | name    | database_name | schema_name | definition                                                   | owner    | comment |
|-------------------------------+---------+---------------+-------------+--------------------------------------------------------------+----------+---------|
| 2017-08-24 06:36:24.339 -0700 | MYPIPE  | MYDATABASE    | PUBLIC      | copy into mytable from @mystage                              | SYSADMIN |         |
| 2017-08-24 06:42:40.550 -0700 | MYPIPE2 | MYDATABASE    | PUBLIC      | copy into mytable(C1, C2) from (select $5, $4 from @mystage) | SYSADMIN |         |
+-------------------------------+---------+---------------+-------------+--------------------------------------------------------------+----------+---------+