DROP DATABASE - Amazon Redshift

Amazon Redshift 自 2025 年 11 月 1 日起不再支援建立新的 Python UDF。如果您想要使用 Python UDF,請在該日期之前建立 UDF。現有 Python UDF 將繼續正常運作。如需詳細資訊,請參閱部落格文章

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

DROP DATABASE

捨棄資料庫。

您無法在交易區塊 (BEGIN ... END) 內執行 DROP DATABASE。如需交易的相關資訊,請參閱 Amazon Redshift 中的隔離層級

語法

DROP DATABASE database_name [ FORCE ]

Parameters

database_name

要捨棄之資料庫的名稱。您無法捨棄 dev、padb_harvest、template0、template1 或 sys:internal 資料庫,也無法捨棄目前的資料庫。

若要捨棄外部資料庫,請捨棄外部結構描述。如需詳細資訊,請參閱DROP SCHEMA

FORCE

當您指定 FORCE 時,DROP DATABASE 會在捨棄資料庫之前,嘗試終止作用中的連線。如果所有作用中連線都在逾時內成功終止,則捨棄會繼續。如果並非所有連線都終止,則命令會擲回錯誤。

DROP DATABASE 使用須知

使用 DROP DATABASE 陳述式時,請考慮下列事項︰

  • 一般而言,我們不建議使用 DROP DATABASE 陳述式來捨棄包含 AWS Data Exchange 資料共用的資料庫。如果這樣做,則可以存取資料共用的 AWS 帳戶 將失去存取權限。執行此類修改可能會違反 AWS Data Exchange 中的資料產品條款。

    下列範例顯示當包含 AWS Data Exchange 資料共用的資料庫遭到捨棄時發生的錯誤。

    DROP DATABASE test_db; ERROR: Drop of database test_db that contains ADX-managed datashare(s) requires session variable datashare_break_glass_session_var to be set to value 'ce8d280c10ad41'

    若要允許捨棄資料庫,請設定下列變數,然後再次執行 DROP DATABASE 陳述式。

    SET datashare_break_glass_session_var to 'ce8d280c10ad41';
    DROP DATABASE test_db;

    在這種情況下,Amazon Redshift 會產生隨機的一次性值來設定工作階段變數,以允許對包含 AWS Data Exchange 資料共用的資料庫執行 DROP DATABASE。

範例

以下範例會捨棄名為 TICKIT_TEST 的資料庫:

drop database tickit_test;