- カテゴリ:
ALTER TAG¶
タグの名前変更など、既存のタグのプロパティを変更します。
タグに加えられた変更は、タグの実行を使用する SQL クエリが次回実行されるときに有効になります。
- こちらもご参照ください。
構文¶
ALTER TAG [ IF EXISTS ] <name> RENAME TO <new_name>
ALTER TAG [ IF EXISTS ] <name> { ADD | DROP } ALLOWED_VALUES '<val_1>' [ , '<val_2>' , [ ... ] ]
ALTER TAG <name> UNSET ALLOWED_VALUES
ALTER TAG [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'
ALTER TAG [ IF EXISTS ] <name> UNSET COMMENT
パラメーター¶
名前
タグの識別子。 CREATE <オブジェクト> ステートメントまたは ALTER <オブジェクト> ステートメントのいずれかを使用して、 オブジェクト にタグ文字列値を割り当てます。
識別子の値はアルファベットで始まる必要があり、識別子文字列全体が二重引用符で囲まれていない限り、スペースや特殊文字を含めることはできません(例: 「私のオブジェクト」)。二重引用符で囲まれた識別子も大文字と小文字が区別されます。
詳細については、 識別子の要件 をご参照ください
RENAME TO 新しい名前
タグの新しい識別子を指定します。スキーマに対して一意である必要があります。識別子が別のタグにすでに配置されている場合、新しい識別子は使用できません。
詳細については、 識別子の要件 をご参照ください。
ALLOWED_VALUES '値1' [ , '値2' , [ ... ] ]
対応する CREATE <オブジェクト> または ALTER <オブジェクト> コマンドを使用してタグが オブジェクト に設定されている場合に、タグに割り当てることができる選択可能な文字列値のコンマ区切りリストを指定します。
このリストのタグ値の最大数は50です。
デフォルト: NULL(空の文字列値(つまり
' '
)を含むすべての文字列値が許可されます)。COMMENT = '文字列リテラル'
タグのコメントを指定します。
デフォルト: 値なし
UNSET
タグの設定を解除する1つ(または複数)のプロパティ、パラメーター、またはその両方を指定します。これにより、デフォルトにリセットされます。
COMMENT
ALLOWED_VALUES
アクセス制御の要件¶
この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 が必要です。
権限 |
オブジェクト |
メモ |
---|---|---|
OWNERSHIP |
タグ |
OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege). |
スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する USAGE 権限も必要であることに注意してください。
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 Snowflakeのアクセス制御 をご参照ください。
タグ DDL と権限の詳細については、 タグの管理 をご参照ください。
使用上の注意¶
タグ DDL 認証の詳細については、 必要な権限 をご参照ください。
メタデータについて。
注意
Snowflakeサービスを使用する場合、お客様は、個人データ(ユーザーオブジェクト向け以外)、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。
例¶
cost_center
タグの名前を cost_center_na
に変更します。ここでは、 na
を北米に指定します。
alter tag cost_center rename to cost_center_na;