DROP TAG

システムからタグを削除します。

このコマンドとタグの参照に関する情報は、 オブジェクトのタグクォータ をご参照ください。

こちらもご参照ください。

CREATE TAG、 ALTER TAG、 SHOW TAGS、 UNDROP TAG

構文

DROP TAG [ IF EXISTS ] <name>
Copy

パラメーター

name

タグの識別子。

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

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

アクセス制御の要件

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

権限

オブジェクト

注意

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 権限が必要です。スキーマに対する 任意の権限を付与されたロールは、そのロールがスキーマを解決できることに注意してください。たとえば、スキーマに対するCREATE権限を付与されたロールは、そのスキーマにオブジェクトを作成できますが、そのスキーマに対するUSAGE*も*付与されている必要はありません。

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

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

タグ DDL と権限の詳細については、 アクセス制御権限 をご参照ください。

使用上の注意

  • タグをドロップする前に、Account Usageテーブル関数 TAG_REFERENCES_WITH_LINEAGE を呼び出して、タグが割り当てられているすべてのオブジェクトを決定します。

  • タグが現在 オブジェクト に割り当てられている場合は、タグをドロップできます。タグの削除が意図的でない場合は、 UNDROP TAG コマンドを実行します。UNDROP TAG コマンドは、 DROP TAG 操作の前にタグの割り当てを復元することに注意してください。

  • マスキングポリシーがタグに 割り当てられている 場合は、タグをドロップすることはできません。

    このシナリオでは、最初にタグからマスキングポリシーの設定を解除してから、DROP TAG ステートメントを実行します。

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

  • IF EXISTS 句が指定されており、ターゲットオブジェクトが存在しない場合、コマンドはエラーを返さずに正常に完了します。

例

次の例では、タグをドロップします。

DROP TAG cost_center;
Copy
言語: 日本語