Categories:

User & Security DDL

SHOW TAGS

Lists the tag information.

See also:

CREATE TAG , ALTER TAG , DROP TAG

Syntax

SHOW TAGS [ LIKE '<pattern>' ] [ IN { ACCOUNT | DATABASE [ <database_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%' ...

Access Control Requirements

A role used to execute this SQL command must have the following privileges at a minimum:

Privilege

Object

Notes

USAGE or

APPLY TAG

Schema

Account

For schema, this privilege must match the schema containing the tag.

Note that operating on any object in a schema also requires the USAGE privilege on the parent database and schema.

For instructions on creating a custom role with a specified set of privileges, see Creating Custom Roles.

For general information about roles and privilege grants for performing SQL actions on securable objects, see Access Control in Snowflake.

For additional details on tag DDL and privileges, see Managing Tags.

Usage Notes

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

  • The value for LIMIT rows cannot exceed 10000. If LIMIT rows is omitted, the command results in an error if the result set is larger than 10K rows.

    To view results for which more than 10K records exist, either include LIMIT rows or query the corresponding view in the Snowflake 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.

  • The ALLOWED_VALUES column specifies the possible string values that can be assigned to the tag when the tag is set on an object or NULL if the tag does not have any specified allowed values. For details, see Specifying Tag Values.

Examples

Show tags in a given schema:

show tags in schema my_db.my_schema;

------------------------------+----------------+---------------+-------------+--------------+--------------------+----------------+
                   created_on | name           | database_name | schema_name | owner        | comment            | allowed_values |
------------------------------+----------------+---------------+-------------+--------------+--------------------+----------------+
2021-03-20 21:09:38.317 +0000 | CLASSIFICATION | MY_DB         | MY_SCHEMA   | ACCOUNTADMIN | secure information | [NULL]         |
2021-03-20 21:08:59.000 +0000 | COST_CENTER    | MY_DB         | MY_SCHEMA   | ACCOUNTADMIN | cost_center tag    | [NULL]         |
------------------------------+----------------+---------------+-------------+--------------+--------------------+----------------+
Back to top