カテゴリ:

ユーザーとセキュリティ DDL

SHOW TAGS

タグ情報をリストします。

こちらもご参照ください。

CREATE TAGALTER TAGDROP TAG

構文

SHOW TAGS [ LIKE '<pattern>' ] [ IN { ACCOUNT | DATABASE [ <database_name> ] | [ SCHEMA ] [ <schema_name> ] } ];

パラメーター

LIKE 'pattern'

オブジェクト名でコマンド出力をフィルターします。フィルターは、 SQL ワイルドカード文字(% および _)をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。

たとえば、次のパターンは同じ結果を返します。

... LIKE '%testing%' ... ... LIKE '%TESTING%' ...

アクセス制御の要件

この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

オブジェクト

メモ

USAGE または

APPLY TAG

スキーマ

アカウント

スキーマの場合、この権限はタグを含むスキーマと一致する必要があります。

スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する USAGE 権限も必要であることに注意してください。

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 Snowflakeのアクセス制御 をご参照ください。

タグ DDL と権限の詳細については、 タグの管理 をご参照ください。

使用上の注意

  • このコマンドは、実行中のウェアハウスを必要としません。

  • LIMIT の値は 10000 を超えることはできません。 LIMIT が省略され、結果セットが10K行より大きい場合、コマンドはエラーになります。

    10Kを超えるレコードが存在する結果を表示するには、 LIMIT を含めるか、 Snowflake Information Schema の対応するビューをクエリします。

  • このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。

  • タグが オブジェクト に設定されている場合に、 ALLOWED_VALUES 列は、タグに割り当てることができる文字列値を指定し、タグに許可された値が指定されていない場合は NULL に設定されます。詳細については、 タグ値の指定 をご参照ください。

特定のスキーマでタグを表示します。

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]         |
------------------------------+----------------+---------------+-------------+--------------+--------------------+----------------+
最上部に戻る