# Databases

List, inspect, create, update, and delete catalog databases, inspect their objects and tables, or run NL2SQL. Use the database identifier returned by the relevant action for subsequent database operations.

## Choose a task

| Task | Page | Description |
| --- | --- | --- |
| Find catalog databases | [Query database list](../list-databases.md) | Returns a list of readable databases under the specified Catalog. |
| Inspect a database | [Query database details](../get-database.md) | Query database details by ID. |
| Add a database | [Create database](../create-database.md) | Create a database under the specified Catalog. |
| Change a database description | [Update database](../update-database.md) | Change the database description; renaming is not supported. |
| Remove a database | [Delete database](../delete-database.md) | Delete a database after confirming that publications and subscriptions do not use it. |
| Browse database objects | [Query objects in the database](../list-database-objects.md) | Query the volumes, tables and operators that can be read in the specified database. |
| Find tables in a database | [Query database table leaf nodes](../list-database-table-leaves.md) | Paged query specifies the tables directly contained in the database. |
| Execute generated SQL | [Run NL2SQL](../run-nl2sql.md) | Execute NL2SQL-generated SQL in the specified database and return the result columns and rows. |

```{toctree}
:hidden:
:maxdepth: 1

List databases <../list-databases>
Get database details <../get-database>
Create a database <../create-database>
Update a database <../update-database>
Delete a database <../delete-database>
List objects in a database <../list-database-objects>
List database tables <../list-database-table-leaves>
Run NL2SQL <../run-nl2sql>
```