Chapter 08

Databases

Vyazen can connect a Postgres database and visualize its schema as a graph — handy for understanding a database you're about to ask the agent to work in.

~1 min read5 sections

What it's for

Connect a database to see its tables and the relationships between them at a glance. It's an orientation aid — useful before you scope a task that touches the schema.

Connect a database

From the databases page, choose Connect database and provide a connection URL and a TLS setting. The connection URL follows the standard Postgres format:

text

postgresql://<user>:<password>@<host>:<port>/<dbname>?sslmode=require

Use sslmode=require (or verify-full) when your database enforces TLS.
The credentials you provide are used to read the schema; they should have at least read access to the tables you want to see.

The schema graph

Once connected, Vyazen shows a visual graph of the database: tables as nodes and their foreign-key relationships as edges. Select a table to inspect its columns and relations.

Real-time connection status

Each connected database shows a live connection status — connected, or disconnected/failed if Vyazen can't reach it. If the status drops, re-check the URL, credentials, and network, then reconnect.

Limitations

Postgres is the supported database at the documented surface.
The schema view is read-only visualization — Vyazen doesn't run migrations or modify your database from this view.
Very large schemas may be slow to render; filter to a subset of tables if needed.