SET TAG と UNSET TAG

データベースオブジェクトにタグを割り当てる、または削除します。タグを割り当てる前に、CREATE TAG を使用して作成しておく必要があります。

関連情報: CREATE TAG、TAG_REFERENCES。

構文

-- Assign tags
ALTER { DATABASE | TABLE | VIEW | STAGE | CONNECTION
      | USER | ROLE | STREAM | FUNCTION | PROCEDURE }
    [ IF EXISTS ] <object_name>
    SET TAG <tag_name> = '<value>' [, <tag_name> = '<value>' ...]

-- Remove tags
ALTER { DATABASE | TABLE | VIEW | STAGE | CONNECTION
      | USER | ROLE | STREAM | FUNCTION | PROCEDURE }
    [ IF EXISTS ] <object_name>
    UNSET TAG <tag_name> [, <tag_name> ...]

サポートされるオブジェクトタイプ

Notes:

• タグに ALLOWED_VALUES が設定されている場合、値は許可された値のいずれかである必要があります。
• 存在しないタグ名に対して UNSET TAG を実行するとエラーが返されます。ただし、オブジェクト自体が存在せず、かつ IF EXISTS が指定されている場合は除きます。
• PROCEDURE の場合、オブジェクト名には引数型シグネチャを含める必要があります。

例

データベースとテーブルにタグを付ける

CREATE TAG env ALLOWED_VALUES = ('dev', 'staging', 'prod');
CREATE TAG owner;

ALTER DATABASE default SET TAG env = 'prod';
ALTER TABLE default.my_table SET TAG env = 'staging', owner = 'team_a';

stage と Connection にタグを付ける

ALTER STAGE data_stage SET TAG env = 'dev', owner = 'data_team';
ALTER CONNECTION my_s3 SET TAG env = 'prod';

ビューにタグを付ける

ALTER VIEW default.active_users SET TAG env = 'prod', owner = 'analytics';

ユーザーとロールにタグを付ける

ALTER USER 'alice' SET TAG env = 'prod', owner = 'security';
ALTER ROLE analyst SET TAG env = 'dev';

UDF とプロシージャにタグを付ける

ALTER FUNCTION my_udf SET TAG env = 'dev';
ALTER PROCEDURE my_proc(DECIMAL(10,2)) SET TAG env = 'prod';

タグを削除する

ALTER TABLE default.my_table UNSET TAG env, owner;
ALTER STAGE data_stage UNSET TAG env;
ALTER USER 'alice' UNSET TAG env, owner;