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
言語: 日本語