DROP DATABASE - Amazon Redshift
SintaxeParâmetrosObservações sobre o uso de DROP DATABASEExemplos

O Amazon Redshift não permitirá mais a criação de funções definidas pelo usuário (UDFs) do Python a partir de 1.º de novembro de 2025. Se quiser usar UDFs do Python, você deve criá-las antes dessa data. As UDFs do Python existentes continuarão a funcionar normalmente. Para ter mais informações, consulte a publicação de blog .

DROP DATABASE

Remove um banco de dados.

Não é possível executar DROP DATABASE em um bloco de transação (BEGIN ... END). Para obter mais informações sobre transações, consulte Isolamento serializável.

Sintaxe

DROP DATABASE database_name [ FORCE ]

Parâmetros

database_name

Nome do banco de dados a ser removido. Você não pode descartar os bancos de dados dev, padb_harvest, template0, template1, ou sys:internal, além de não pode descartar o banco de dados atual.

Para descartar um banco de dados externo, descarte o esquema externo. Para obter mais informações, consulte DROP SCHEMA.

FORCE

Quando você especifica FORCE, DROP DATABASE tenta encerrar as conexões ativas antes de eliminar o banco de dados. Se todas as conexões ativas forem encerradas com êxito dentro de um tempo limite, a eliminação prosseguirá. Se nem todas as conexões forem encerradas, o comando lançará um erro.

Observações sobre o uso de DROP DATABASE

Ao usar a instrução DROP DATABASE, considere o seguinte:

  • Em geral, recomendamos não descartar um banco de dados que contenha uma unidade de compartilhamento de dados AWS Data Exchange usando a instrução DROP DATASHARE. Caso altere, as Contas da AWS com acesso à unidade de compartilhamento de dados perdem o acesso. Executar esse tipo de alteração pode violar os termos do produto de dados no AWS Data Exchange.

    O exemplo a seguir mostra um erro quando um banco de dados que contém uma unidade de compartilhamento de dados do AWS Data Exchange é descartada.

    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'

    Para permitir o descarte do banco de dados, defina a seguinte variável e execute a instrução DROP DATABASE novamente.

    SET datashare_break_glass_session_var to 'ce8d280c10ad41';
    DROP DATABASE test_db;

    Nesse caso, o Amazon Redshift gera um valor único aleatório para definir a variável de sessão para permitir DROP DATABASE para um banco de dados que contenha uma unidade de compartilhamento de dados do AWS Data Exchange.

Exemplos

O exemplo a seguir permite remover um banco de dados com o nome TICKIT_TEST: 

drop database tickit_test;