Advanced Metadata Read Actions

Table of contents

• Available actions

Note: This feature is available in Lite, Enterprise, and Ultimate editions only.

Data read actions let you quickly inspect parts of your database. These actions are read-only and safe to use in any environment.

By default, DBeaver sends only table and column names to the AI provider. No other metadata is shared unless you enable the data read actions.

To use the actions:

1. Open AI chat on the connection you want to explore

2. Write a prompt that describes what you want to inspect

   Note: To use an action, make sure it’s turned on in the Tools & MCP settings.

3. AI reads your request and uses a small sample of rows to better understand the table structure and return a more accurate answer.

Tip: Set a scope if you want AI to focus on a specific object.

Available actions

Use it when you want the assistant to understand a table’s structure (for example, columns, typical values, and relationships) so it can generate more accurate SQL, filters, or mappings.

Action	What it does	What happens	Example
Read table sample rows	Reads a few rows from a table so AI can better understand its structure and generate more accurate SQL or mappings.	- DBeaver reads only a few rows - AI uses this as internal context to improve query generation and mapping - No SQL and no editors are required	"help me build a join for Album and Artist, use sample rows if needed"