UNDROP DATABASE¶
Restaura a versão mais recente de um banco de dados descartado.
- Consulte também:
CREATE DATABASE , ALTER DATABASE , DESCRIBE DATABASE , DROP DATABASE , SHOW DATABASES
Sintaxe¶
UNDROP DATABASE <name>
Parâmetros¶
name
Especifica o identificador para o banco de dados a ser restaurado. Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.
Notas de uso¶
Se já existir um banco de dados com o mesmo nome, um erro é emitido.
UNDROP conta com o recurso Snowflake Time Travel. Um objeto só pode ser restaurado se o objeto foi excluído dentro do Período de retenção de dados. O valor padrão é 24 horas.
Tabelas híbridas que pertencem ao banco de dados especificado não são descartadas.
Se você tiver vários bancos de dados excluídos com o mesmo nome, poderá usar a palavra-chave IDENTIFIER com o identificador gerado pelo sistema (de Exibição DATABASES) para especificar qual banco de dados restaurar. O nome do banco de dados restaurado permanece o mesmo. Consulte Exemplos.
Nota
Sé é possível usar o identificador gerado pelo sistema com a palavra-chave IDENTIFIER() ao executar o comando UNDROP para tabelas, esquemas e bancos de dados.
Exemplos¶
Exemplo básico¶
Restaurar a versão mais recente de um banco de dados descartado (este exemplo se baseia nos exemplos DROP DATABASE):
UNDROP DATABASE mytestdb2;
+-------------------------------------------+
| status |
|-------------------------------------------|
| Database MYTESTDB2 successfully restored. |
+-------------------------------------------+
SHOW DATABASES HISTORY;
+---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+------------+
| created_on | name | is_default | is_current | origin | owner | comment | options | retention_time | dropped_on |
|---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+------------|
| Tue, 17 Mar 2015 16:57:04 -0700 | MYTESTDB | N | Y | | PUBLIC | | | 1 | [NULL] |
| Tue, 17 Mar 2015 17:06:32 -0700 | MYTESTDB2 | N | N | | PUBLIC | | | 1 | [NULL] |
| Wed, 25 Feb 2015 17:30:04 -0800 | SALES1 | N | N | | PUBLIC | | | 1 | [NULL] |
| Fri, 13 Feb 2015 19:21:49 -0800 | DEMO1 | N | N | | PUBLIC | | | 1 | [NULL] |
+---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+------------+
UNDROP banco de dados usando o ID de banco de dados¶
Restaure um banco de dados descartado pelo ID usando IDENTIFIER(). É possível encontrar o ID do banco de dados de banco de dados específico a ser restaurado usando a coluna database_id
em Exibição DATABASES. Por exemplo, se você tiver vários bancos de dados descartados nomeados my_database
e quiser restaurar o penúltimo banco de dados my_database
descartado, siga estas etapas:
Encontre o ID do banco de dados descartado na exibição DATABASES Account Usage:
SELECT database_id, database_name, created, deleted, comment FROM SNOWFLAKE.ACCOUNT_USAGE.DATABASES WHERE database_name = 'MY_DATABASE' AND deleted IS NOT NULL ORDER BY deleted;
+-------------+---------------+-------------------------------+-------------------------------+---------+ | DATABASE_ID | DATABASE_NAME | CREATED | DELETED | COMMENT | |-------------+---------------+-------------------------------+-------------------------------+---------| | 494 | MY_DATABASE | 2024-07-01 17:51:33.380 -0700 | 2024-07-01 17:51:46.228 -0700 | NULL | | 492 | MY_DATABASE | 2024-07-01 17:51:52.560 -0700 | 2024-07-01 17:52:39.881 -0700 | NULL | | 493 | MY_DATABASE | 2024-07-01 17:52:39.849 -0700 | 2024-07-01 17:52:44.562 -0700 | NULL | +-------------+---------------+-------------------------------+-------------------------------+---------+
Restaure
my_database
pelo ID de banco de dados. Para restaurar o penúltimo banco de dados descartado, use o ID de banco de dados492
da saída da instrução anterior. Após executar a seguinte instrução, o banco de dados será restaurado com seu nome original,my_database
:UNDROP DATABASE IDENTIFIER(492);