カテゴリ:: ユーザーとセキュリティ DDL

ALTER TAG¶

タグの名前変更など、既存のタグのプロパティを変更します。

タグに加えられた変更は、タグの実行を使用する SQL クエリが次回実行されるときに有効になります。

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

構文¶

ALTER TAG [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER TAG [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER TAG [ IF EXISTS ] <name> UNSET COMMENT

許可される値の指定¶

ALTER TAG [ IF EXISTS ] <name> { ADD | DROP } ALLOWED_VALUES '<val_1>' [ , '<val_2>' , [ ... ] ]

ALTER TAG <name> UNSET ALLOWED_VALUES

パラメーター¶

名前

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

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

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

RENAME TO 新しい名前

タグの新しい識別子を指定します。スキーマに対して一意である必要があります。識別子が別のポリシー（例: マスキングポリシー）にすでに配置されている場合、新しい識別子は使用できません。

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

ALLOWED_VALUES '値1' [ , '値2' , [ ... ] ]

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

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

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

COMMENT = '文字列リテラル'

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

デフォルト: 値なし

UNSET

タグの設定を解除する1つ（または複数）のプロパティ、パラメーター、またはその両方を指定します。これにより、デフォルトにリセットされます。

COMMENT
ALLOWED_VALUES

使用上の注意¶

タグ DDL 認証の詳細については、必要な権限をご参照ください。
メタデータについて。

注意

Snowflakeサービスを使用する場合、お客様は、個人データ（ユーザーオブジェクト向け以外）、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールドをご参照ください。

例¶

cost_center タグの名前を cost_center_na に変更します。ここでは、 na を北米に指定します。

alter tag cost_center rename to cost_center_na;