DROP TAG¶
システムからタグを削除します。
このコマンドとタグの参照の詳細については、 オブジェクトおよび列のタグクォータ をご参照ください。
- こちらもご参照ください。
構文¶
DROP TAG [ IF EXISTS ] <name>
パラメーター¶
name
タグの識別子。
識別子の値はアルファベットで始まる必要があり、識別子文字列全体が二重引用符で囲まれていない限り、スペースや特殊文字を含めることはできません(例:
"My object"
)。二重引用符で囲まれた識別子も大文字と小文字が区別されます。詳細については、 識別子の要件 をご参照ください。
アクセス制御の要件¶
この 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 アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。
タグ DDL と権限の詳細については、 タグの管理 をご参照ください。
使用上の注意¶
タグをドロップする前に、Account Usageテーブル関数 TAG_REFERENCES_WITH_LINEAGE を呼び出して、タグが割り当てられているすべてのオブジェクトを決定します。
タグが現在 オブジェクト に割り当てられている場合は、タグをドロップできます。タグの削除が意図的でない場合は、 UNDROP TAG コマンドを実行します。UNDROP TAG コマンドは、 DROP TAG 操作の前にタグの割り当てを復元することに注意してください。
マスキングポリシーがタグに 割り当てられている 場合は、タグをドロップすることはできません。
このシナリオでは、最初にタグからマスキングポリシーの設定を解除してから、DROP TAG ステートメントを実行します。
タグ DDL 認証の詳細については、 必要な権限 をご参照ください。
例¶
次の例では、タグをドロップします。
DROP TAG cost_center;