---
title: "db update"
description: "Update database settings"
canonical: "https://pgbeam.com/docs/cli/db/update"
last-updated: "2026-09-14T19:37:21.000Z"
---

# db update

> Update database settings

URL: https://pgbeam.com/docs/cli/db/update

Update the configuration of an existing database connection. Supports changing the display name, cache settings (enable/disable, TTL), and connection pool settings (mode, size). At least one update flag must be provided. Current settings are preserved for any flag not specified.

## Usage

## Options

Option

Description

Required

Default

`<id>`

ID of the database to update

Yes

-

`--name <value>`

New display name for the database

No

-

`--cache-enabled`

Enable or disable query result caching for this database

No

-

`--cache-ttl <value>`

Time-to-live for cached query results, in seconds

No

-

`--pool-mode <value>`

Connection pool mode: transaction, session, or statement

No

-

`--pool-size <value>`

Maximum number of connections in the pool (default: 10)

No

-

`--min-pool-size <value>`

Minimum number of idle connections maintained in the pool (default: 1)

No

-

All global options (`--token`, `--profile`,
`--project`, `--org`, `--json`, `--no-color`, `--no-trunc`, `--debug`) are
also available on this command.

## Examples

## Output

Prints a success message confirming the database was updated. With `--json`, returns the updated database object.