Skip to content

Commit b81910c

Browse files
committed
docs: document service-level connections and Cmd+K database switcher
1 parent 90c8f0e commit b81910c

6 files changed

Lines changed: 15 additions & 10 deletions

File tree

docs/databases/clickhouse.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Click **New Connection**, select **ClickHouse**, enter host/port/credentials/dat
1818
| **Host** | `localhost` | |
1919
| **Port** | `8123` | HTTP port (not 9000 native TCP) |
2020
| **Username** | `default` | Set password in production |
21-
| **Database** | `default` | |
21+
| **Database** | `default` | Leave empty to browse all databases. Switch with **Cmd+K** |
2222

2323
Uses HTTP API (HTTPS on port 8443 with SSL/TLS enabled). Cloud providers typically expose HTTP(S) only.
2424

@@ -43,7 +43,7 @@ See [Connection URL Reference](/databases/connection-urls) for all parameters.
4343

4444
### Database Browsing
4545

46-
After connecting, the sidebar lists all databases on the server. Expand a database to see its tables and views. Switch databases using the database switcher in the toolbar.
46+
After connecting, the sidebar lists all databases on the server. Expand a database to see its tables and views. Press **Cmd+K** or click the database name in the toolbar to switch.
4747

4848
### Table Browsing
4949

docs/databases/mongodb.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ TablePro supports MongoDB 5.0 and later. Collections appear as tables in the sid
2323
| Field | Default | Notes |
2424
|-------|---------|-------|
2525
| **Hosts** | `localhost:27017` | Add multiple hosts for replica sets |
26-
| **Database** | - | Database name to connect to |
26+
| **Database** | - | Optional. Leave empty to browse all databases. Switch with **Cmd+K** |
2727
| **Username** | - | Leave empty for local dev without auth |
2828
| **Password** | - | |
2929
| **Auth Database** | `admin` | Database to authenticate against |

docs/databases/mssql.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Run `scripts/build-freetds.sh` first. Click **New Connection**, select **SQL Ser
2222
| **Host** | `localhost` | |
2323
| **Port** | `1433` | |
2424
| **Username** | `sa` | SQL Server Authentication only (no Windows Auth) |
25-
| **Database** | - | |
25+
| **Database** | - | Optional. Leave empty to browse all databases. Switch with **Cmd+K** |
2626

2727
## Example Configurations
2828

docs/databases/mysql.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ Same driver for both. MySQL 8.0 defaults to `caching_sha2_password` auth (vs Mar
5858

5959
## Features
6060

61-
Sidebar shows all accessible databases, tables, structure (columns, indexes, foreign keys), and DDL. Full MySQL syntax support for queries:
61+
Sidebar shows all accessible databases, tables, structure (columns, indexes, foreign keys), and DDL. Switch databases with **Cmd+K**. Full MySQL syntax support for queries:
6262

6363
```sql
6464
-- Select with JSON

docs/databases/overview.mdx

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -293,13 +293,17 @@ Click the connection button again to dismiss the popover.
293293

294294
## Switching Databases
295295

296-
To switch databases on the same connection:
296+
One connection covers every database on the server. Switch with **Cmd+K**, or click the database name in the toolbar.
297297

298-
1. Click the database name in the toolbar (next to the connection name)
299-
2. Select a different database from the dropdown
300-
3. The sidebar updates to show the new database's tables
298+
### Service-level connections
301299

302-
No need to create separate connections for each database on the same server.
300+
Leave the **Database** field empty when creating the connection. Works for MySQL, MariaDB, MongoDB, SQL Server, and ClickHouse. The sidebar lists every database your user can access.
301+
302+
PostgreSQL and Redshift need an initial database. Connect to `postgres` (Redshift: `dev`), then use **Cmd+K** to switch.
303+
304+
<Tip>
305+
With a restricted user, the switcher only shows databases that user has been granted access to.
306+
</Tip>
303307

304308
{/* Screenshot: Database switcher */}
305309
<Frame caption="Database switcher in toolbar">

docs/features/keyboard-shortcuts.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ TablePro is keyboard-driven. Most actions have shortcuts, and most menu shortcut
1818
| Open history | `Cmd+Y` |
1919
| Settings | `Cmd+,` |
2020
| Quick Switcher | `Cmd+Shift+O` |
21+
| Switch database | `Cmd+K` |
2122
| Close window | `Cmd+W` |
2223
| Quit | `Cmd+Q` |
2324

0 commit comments

Comments
 (0)