CREATE TAG¶

システム内で、新しいタグを作成するか、既存のタグを置き換えます。

こちらもご参照ください。: タグ値を指定する、 TAGS ビュー、タグ DDL 参照

構文¶

CREATE [ OR REPLACE ] TAG [ IF NOT EXISTS ] <name> [ COMMENT = '<string_literal>' ]

CREATE [ OR REPLACE ] TAG [ IF NOT EXISTS ] <name>
    [ ALLOWED_VALUES '<val_1>' [ , '<val_2>' [ , ... ] ] ]

Copy

必須パラメーター¶

name

タグの識別子。 CREATE <オブジェクト> ステートメントまたは ALTER <オブジェクト> ステートメントのいずれかを使用して、オブジェクトにタグ文字列値を割り当てます。

識別子の値はアルファベットで始まる必要があり、識別子文字列全体が二重引用符で囲まれていない限り、スペースや特殊文字を含めることはできません（例: 「私のオブジェクト」）。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、識別子の要件をご参照ください。

オプションのパラメーター¶

ALLOWED_VALUES 'val_1' [ , 'val_2' [ , ... ] ]

対応する CREATE <オブジェクト> または ALTER <オブジェクト> コマンドを使用してタグがオブジェクトに設定されている場合に、タグに割り当てることができる選択可能な文字列値のコンマ区切りリストを指定します。

このリストのタグ値の最大数は300です。

デフォルト: NULL（空の文字列値（つまり ' '）を含むすべての文字列値が許可されます）。

COMMENT = 'string_literal'

タグのコメントを指定します。

デフォルト: 値なし

アクセス制御の要件¶

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

権限	オブジェクト	メモ
CREATE TAG	スキーマ

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

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

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

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

使用上の注意¶

Snowflakeは、アカウント内のタグの数を10,000に制限します。
タグをSnowflakeオブジェクトに関連付ける方法の詳細については、オブジェクトのタグ付けをご参照ください。
タグ DDL 認証の詳細については、必要な権限をご参照ください。
メタデータについて。

注意

Snowflakeサービスを使用する場合、お客様は、個人データ（ユーザーオブジェクト向け以外）、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールドをご参照ください。
CREATE OR REPLACE <オブジェクト> ステートメントはアトミックです。つまり、オブジェクトが置き換えられると、単一のトランザクションで、古いオブジェクトが削除されて新しいオブジェクトが作成されます。

例¶

キー cost_center でタグを作成します。

CREATE TAG cost_center COMMENT = 'cost_center tag';

Copy