DROP EXTERNAL VOLUME¶
外部ボリューム をアカウントから削除しますが、 UNDROP EXTERNAL VOLUME を使用して復元できるように外部ボリュームのバージョンを保持します。詳細については、 使用上の注意 (このトピック内)をご参照ください。
- こちらもご参照ください。
CREATE EXTERNAL VOLUME、 ALTER EXTERNAL VOLUME、 SHOW EXTERNAL VOLUMES、 DESCRIBE EXTERNAL VOLUME
構文¶
DROP EXTERNAL VOLUME [ 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). |
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。
使用上の注意¶
外部ボリュームをドロップしても、システムから永久に削除されるわけではありません。Snowflakeは、ドロップされた外部ボリュームのバージョンを Time Travel で保持しています。 UNDROP EXTERNAL VOLUME コマンドを使用すると、ドロップした外部ボリュームを復元できます。
ドロップされた外部ボリュームがパージされると、復元できません。再作成する必要があります。
外部ボリュームを削除した後、同じ名前で外部ボリュームを作成すると、外部ボリュームの新しいバージョンが作成されます。以下のステップに従うと、以前の外部ボリュームのドロップされたバージョンを復元できます。
外部ボリュームの現在のバージョン名を変更します。
UNDROP EXTERNAL VOLUME コマンドを使用して、以前のバージョンを復元します。
例¶
次の例は、 my_external_volume
という名前の外部ボリュームをドロップします。
DROP EXTERNAL VOLUME my_external_volume;