SHOW DROP DATABASES

Author: soyeric128

docs/en/sql-reference/00-sql-reference/20-system-tables/system-databases-with-history.md

@@ -0,0 +1,24 @@
+---
+title: system.databases_with_history
+---
+
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced: v1.1.658"/>
+
+Records all databases, including active and dropped ones. It shows each database's catalog, name, unique ID, owner (if specified), and the deletion timestamp (NULL if still active). 
+
+See also: [SHOW DROP DATABASES](../../10-sql-commands/00-ddl/00-database/show-drop-databases.md)
+
+```sql
+SELECT * FROM system.databases_with_history;
+
+┌────────────────────────────────────────────────────────────────────────────────────────────────────┐
+│ catalog │        name        │     database_id     │       owner      │         dropped_on         │
+├─────────┼────────────────────┼─────────────────────┼──────────────────┼────────────────────────────┤
+│ default │ system             │ 4611686018427387905 │ NULL             │ NULL                       │
+│ default │ information_schema │ 4611686018427387906 │ NULL             │ NULL                       │
+│ default │ default            │                   1 │ NULL             │ NULL                       │
+│ default │ my_db              │                 114 │ NULL             │ 2024-11-15 02:44:46.207120 │
+└────────────────────────────────────────────────────────────────────────────────────────────────────┘
+```

docs/en/sql-reference/10-sql-commands/00-ddl/00-database/show-drop-databases.md

@@ -0,0 +1,41 @@
+---
+title: SHOW DROP DATABASES
+---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.658"/>
+
+Lists all databases along with their deletion timestamps if they have been dropped, allowing users to review deleted databases and their details.
+
+See also: [system.databases_with_history](../../../00-sql-reference/20-system-tables/system-databases-with-history.md)
+
+## Syntax
+
+```sql
+SHOW DROP DATABASES 
+    [ FROM <catalog> ]
+    [ LIKE '<pattern>' | WHERE <expr> ]
+```
+
+## Examples
+
+```sql
+-- Create a new database named my_db
+CREATE DATABASE my_db;
+
+-- Drop the database my_db
+DROP DATABASE my_db;
+
+-- If a database has been dropped, dropped_on shows the deletion time; 
+-- If it is still active, dropped_on is NULL.
+SHOW DROP DATABASES;
+
+┌─────────────────────────────────────────────────────────────────────────────────┐
+│ catalog │        name        │     database_id     │         dropped_on         │
+├─────────┼────────────────────┼─────────────────────┼────────────────────────────┤
+│ default │ default            │                   1 │ NULL                       │
+│ default │ information_schema │ 4611686018427387906 │ NULL                       │
+│ default │ my_db              │                 114 │ 2024-11-15 02:44:46.207120 │
+│ default │ system             │ 4611686018427387905 │ NULL                       │
+└─────────────────────────────────────────────────────────────────────────────────┘
+```