diff --git a/connections/connection-form.mdx b/connections/connection-form.mdx index 4ae77c4..5f5b329 100644 --- a/connections/connection-form.mdx +++ b/connections/connection-form.mdx @@ -5,21 +5,21 @@ description: The four sections of the connection editor and the fields each driv import LocalCredentialConsent from "/snippets/local-credential-consent.mdx"; -The editor's sidebar lists the same four sections whatever the driver. Only Network is ever absent, and only for a driver that connects directly and cannot negotiate TLS. +The editor is one scrolling form. General, Network and Appearance read top to bottom; the less-common Options sit behind **Advanced Options** near the end. Network is absent only for a driver that connects directly and cannot negotiate TLS. - - Connection editor with a General, Network, Options and Appearance sidebar, credential fields filling the pane, and Test, Cancel and Save along the bottom - Connection editor with a General, Network, Options and Appearance sidebar, credential fields filling the pane, and Test, Cancel and Save along the bottom + + Connection editor as one scrolling form showing the General section's identity, connection and authentication fields, with Test, Cancel and Save along the bottom + Connection editor as one scrolling form showing the General section's identity, connection and authentication fields, with Test, Cancel and Save along the bottom | Section | Contents | |------|----------| -| **General** | Name, database type, host, port, database, credentials | +| **General** | Name, type, environment, where the database lives, and the sign-in | | **Network** | How the connection reaches the server, and how it is encrypted | -| **Options** | Timeouts, driver options, startup SQL, Safe Mode, Manual Commit, external and AI access, iCloud | | **Appearance** | Icon, color, tags, group | +| **Advanced Options** | Timeouts, driver options, startup SQL, Safe Mode, Manual Commit, external and AI access, iCloud. Collapsed until you expand it | -The bar along the bottom carries **Test Connection**, **Cancel** and **Save**, plus **Save & Connect** on a new connection and **Delete** on a saved one. The space to their left holds the reason **Save** is dimmed, prefixed with the tab that holds the empty field, or the warning the last test brought back from the server. +The bar along the bottom carries **Test Connection**, **Cancel** and **Save**, plus **Save & Connect** on a new connection and **Delete** on a saved one. The space to their left holds the reason **Save** is dimmed, prefixed with the section that holds the empty field, or the warning the last test brought back from the server. A required field inside **Advanced Options** reveals that section so the error is reachable. ## General @@ -27,6 +27,7 @@ The bar along the bottom carries **Test Connection**, **Cancel** and **Save**, p |-------|-------------| | **Name** | Display name in the connection list | | **Type** | The database type. **Change…** retypes the connection and resets the fields the old type owned | +| **Environment** | Optional label: Production, Staging, Development or Local | | **Connect Using** | MySQL, MariaDB, and PostgreSQL. **Host and Port**, or **Socket** for a server on this Mac. See Unix socket for [MySQL](/databases/mysql#unix-socket) and [PostgreSQL](/databases/postgresql#unix-socket) | | **Host** | Empty falls back to the driver's own default, usually `localhost` | | **Port** | Pre-filled from the database type | @@ -67,7 +68,7 @@ Encryption sits below the transport. [SSL/TLS](/connections/ssl) covers the mode ## Options -**Safe Mode**, **Manual Commit**, **AI Policy** and **External Clients** share the **Access** section. +Click **Advanced Options** near the end of the form to reveal these fields. **Safe Mode**, **Manual Commit**, **AI Policy** and **External Clients** share the **Access** section. | Field | Description | |-------|-------------| diff --git a/connections/index.mdx b/connections/index.mdx index 3924719..3413b06 100644 --- a/connections/index.mdx +++ b/connections/index.mdx @@ -65,7 +65,7 @@ The connection form's **Appearance** tab holds **Icon**, **Color**, **Tags** and -Red for production, green for development. On production, set **Safe Mode** to **Read-Only** under **Access** on the **Options** tab to block accidental writes. See [Safe Mode](/features/safe-mode). +Red for production, green for development. On production, set **Safe Mode** to **Read-Only** under **Access** in the **Options** section to block accidental writes. See [Safe Mode](/features/safe-mode). | | How it works | diff --git a/connections/ssl.mdx b/connections/ssl.mdx index f6f6bbb..44d1a5f 100644 --- a/connections/ssl.mdx +++ b/connections/ssl.mdx @@ -46,7 +46,7 @@ A new connection starts on the mode that matches the driver's own default, and s | SQL Server | Preferred | FreeTDS `encryption=request`: the login over TLS, the rest in plain TCP unless the server forces encryption | | Teradata | Disabled | Opens a TLS transport, retries on a plain socket if it fails to come up | | MongoDB, Redis, Cassandra, ClickHouse, Elasticsearch, Typesense, SurrealDB, Weaviate, Qdrant | Disabled | Nothing. No fallback exists, so Preferred forces TLS exactly like Required | -| etcd | Disabled | Nothing. The driver never reads these fields. Set **TLS Mode** on the Options section instead, and see [etcd](/databases/etcd) | +| etcd | Disabled | Nothing. The driver never reads these fields. Set **TLS Mode** in the Options section instead, and see [etcd](/databases/etcd) | | Trino, Presto | Disabled | Sends every request over HTTPS with no fallback, again like Required | | SAP HANA | Verify Identity | Nothing. No fallback exists, so Preferred forces TLS exactly like Required | | Oracle | Disabled | Connects in plain TCP, so it behaves like Disabled. A red warning appears under the picker; use Required to enforce TCPS | diff --git a/databases/beancount.mdx b/databases/beancount.mdx index 844cc48..6aeaae6 100644 --- a/databases/beancount.mdx +++ b/databases/beancount.mdx @@ -38,7 +38,7 @@ After connecting, TablePro's database version display names the backend it selec ## Ledger plugins -With the Python backend, **Run Ledger Plugins** on the connection's **Options** tab starts off. +With the Python backend, **Run Ledger Plugins** on the connection's **Options** section starts off. Only modules named `beancount.plugins.` with no configuration argument run in that state. Other Python modules and configured plugins are skipped. A ledger's `insert_pythonpath` option does not add its folders to Python's import path while plugins run. diff --git a/databases/bigquery.mdx b/databases/bigquery.mdx index aaa8689..163ed1c 100644 --- a/databases/bigquery.mdx +++ b/databases/bigquery.mdx @@ -23,7 +23,7 @@ Click **New Connection…**, select **BigQuery**, pick an auth method, enter you | **OAuth Client ID**, **OAuth Client Secret** | OAuth only | From GCP Console > APIs & Services > Credentials | | **OAuth Refresh Token** | No | OAuth only. Tried before the token saved by sign-in | | **Location** | No | Processing location (`US`, `EU`, `us-central1`), sent with every query | -| **Max Bytes Billed** | No | Options tab. A query over the cap fails instead of billing | +| **Max Bytes Billed** | No | Options section. A query over the cap fails instead of billing | There is no Database field and no URL scheme. Datasets stand in for databases: the sidebar lists them as expandable nodes, `Cmd+K` and **Database > Open Database…** move between them, and **Database > New Database…** runs `CREATE SCHEMA`. Switching does not move tabs you already have open; each stays on its own dataset. See [Tabs](/features/tabs#where-a-tab-points). diff --git a/databases/bigtable.mdx b/databases/bigtable.mdx index a25c0df..0a8baba 100644 --- a/databases/bigtable.mdx +++ b/databases/bigtable.mdx @@ -23,7 +23,7 @@ The toolbar's **Instance** switcher moves between the project's instances withou | **Service Account Key** | A path to the JSON key file, or the JSON pasted in. Stored in the Keychain | | **Project ID** | The Google Cloud project. Empty takes the project the key names. Under Application Default Credentials, empty takes the credentials file's project, then `GOOGLE_CLOUD_PROJECT` | | **Instance ID** | The Bigtable instance. Empty opens the instance whose ID sorts first | -| **App Profile ID** | Options tab. Routes reads and writes through that app profile. The instance's default profile when empty | +| **App Profile ID** | Options section. Routes reads and writes through that app profile. The instance's default profile when empty | **Project ID** and **Instance ID** stand in for a host, a port and the Database field. Any instance connects, no connection URL opens one, and [SSH Tunnel](/connections/ssh-tunneling) is not offered. diff --git a/databases/cassandra.mdx b/databases/cassandra.mdx index 85d37cd..0b79bdf 100644 --- a/databases/cassandra.mdx +++ b/databases/cassandra.mdx @@ -26,7 +26,7 @@ There is no Keyspace field. Pick one in the sidebar after connecting, or put it ## Consistency -Statements in the CQL editor, table browsing and grid saves run at the **Consistency** level on the connection's **Options** tab. **Default** is `LOCAL_ONE`, or `LOCAL_QUORUM` on Amazon Keyspaces. **Serial Consistency** is the level a lightweight transaction (`IF NOT EXISTS`, `IF EXISTS`, `IF` a condition) checks its condition at: `SERIAL` or `LOCAL_SERIAL`. Its **Default** leaves the choice to the server, which uses `SERIAL`. +Statements in the CQL editor, table browsing and grid saves run at the **Consistency** level on the connection's **Options** section. **Default** is `LOCAL_ONE`, or `LOCAL_QUORUM` on Amazon Keyspaces. **Serial Consistency** is the level a lightweight transaction (`IF NOT EXISTS`, `IF EXISTS`, `IF` a condition) checks its condition at: `SERIAL` or `LOCAL_SERIAL`. Its **Default** leaves the choice to the server, which uses `SERIAL`. The result footer names the level each statement ran at, and both levels after a lightweight transaction: diff --git a/databases/cockroachdb.mdx b/databases/cockroachdb.mdx index af66c9f..9594bc9 100644 --- a/databases/cockroachdb.mdx +++ b/databases/cockroachdb.mdx @@ -31,7 +31,7 @@ cockroachdb://user:password@host:26257/defaultdb ## CockroachDB Cloud -A Cloud connection string carries a cluster routing parameter that the form has no field for. Copy the host, port, user, password, and database from the Cloud console, then put the routing value in **Connection Options** on the Options tab: +A Cloud connection string carries a cluster routing parameter that the form has no field for. Copy the host, port, user, password, and database from the Cloud console, then put the routing value in **Connection Options** in the Options section: ```text --cluster=my-cluster-1234 diff --git a/databases/elasticsearch.mdx b/databases/elasticsearch.mdx index c1ee43a..b24be42 100644 --- a/databases/elasticsearch.mdx +++ b/databases/elasticsearch.mdx @@ -35,7 +35,7 @@ The connection uses the first node that answers and stays on it: | **Hosts** | One or more nodes of the cluster, `localhost:9200` for a local node. A host without a port uses `9200`, a URL without one uses `443` or `80` | | **Auth Method** | Username & Password, API Key, or None | | **API Key** | Base64-encoded key. Shown when **Auth Method** is API Key | -| **Skip TLS Verification** | Options tab. Trusts any certificate, even under **Verify CA** or **Verify Identity** | +| **Skip TLS Verification** | Options section. Trusts any certificate, even under **Verify CA** or **Verify Identity** | ## Authentication diff --git a/databases/etcd.mdx b/databases/etcd.mdx index 57dfc9f..7b19385 100644 --- a/databases/etcd.mdx +++ b/databases/etcd.mdx @@ -21,7 +21,7 @@ Click **New Connection…**, select **etcd**, enter host and port, then click ** | **Port** | Client port, `2379` by default | | **Username / Password** | The etcd user to authenticate as. Leave both empty on a server that has no authentication | -### Options tab fields +### Options section fields | Field | Description | |-------|-------------| @@ -45,7 +45,7 @@ etcd://127.0.0.1:2379 etcds://127.0.0.1:2379 ``` -Both schemes import. Neither switches TLS on by itself; set **TLS Mode** on the Options tab. +Both schemes import. Neither switches TLS on by itself; set **TLS Mode** in the Options section. ## Browsing keys @@ -87,7 +87,7 @@ Quote a key that holds a space, a quote or an invisible character. Inside quotes ## SSL/TLS -TLS here is set by **TLS Mode** on the Options tab, not by the connection's SSL mode, and it starts **Disabled**. **Required (skip verify)** encrypts without checking the certificate, **Verify CA** checks it against the **CA Certificate** you name, and **Verify Identity** adds the hostname check. **Client Certificate** and **Client Key** cover mutual TLS under either verifying mode. See [SSL/TLS](/connections/ssl) for the concepts. +TLS here is set by **TLS Mode** in the Options section, not by the connection's SSL mode, and it starts **Disabled**. **Required (skip verify)** encrypts without checking the certificate, **Verify CA** checks it against the **CA Certificate** you name, and **Verify Identity** adds the hostname check. **Client Certificate** and **Client Key** cover mutual TLS under either verifying mode. See [SSL/TLS](/connections/ssl) for the concepts. The **CA Certificate** may be PEM or DER. **Verify CA** needs one, since it checks no hostname, and a connection without it is refused. **Verify Identity** with no **CA Certificate** checks the system trust store. A file that cannot be read fails the connection rather than falling back to the system trust store. diff --git a/databases/influxdb.mdx b/databases/influxdb.mdx index 2171d8a..f86ad85 100644 --- a/databases/influxdb.mdx +++ b/databases/influxdb.mdx @@ -24,7 +24,7 @@ For a server on a private network, open the **Network** tab and set **Connect vi | **Token** | An API token. Leave it empty for a 3.x server started with `--without-auth` | | **Database** | The database (3.x) or bucket (2.x) the sidebar opens. Switch it later from the database list | | **Organization** | 2.x only. Optional when the token sees one organization | -| **Skip TLS Verification** | Options tab. Trusts any certificate, even under **Verify CA** or **Verify Identity** | +| **Skip TLS Verification** | Options section. Trusts any certificate, even under **Verify CA** or **Verify Identity** | TablePro reads the server version from `/ping` when it connects, and picks the API from it: `/api/v3` on 3.x, `/api/v2` and the v1 `/query` endpoint on 2.x. A wrong token fails the connection instead of the first query: 3.x checks it on `/ping`, and on 2.x TablePro lists one bucket with it. A 1.x server is refused at connect. diff --git a/databases/mongodb.mdx b/databases/mongodb.mdx index b6abb65..0a8de0f 100644 --- a/databases/mongodb.mdx +++ b/databases/mongodb.mdx @@ -28,7 +28,7 @@ The query tab is a JavaScript shell. Write `db.orders.find({status: "new"})` the | **Username** | - | Leave empty for local dev without auth | | **Password** | - | | | **Database** | - | Opens straight into that database. Leave it empty to browse them all | -| **Auth Database** | - | Options tab. Where your user account lives, usually `admin` | +| **Auth Database** | - | Options section. Where your user account lives, usually `admin` | | **Auth Mechanism** | Default | SCRAM-SHA-1, SCRAM-SHA-256, X.509, or AWS IAM, under Authentication | | **AWS Session Token** | - | Under Authentication, once **Auth Mechanism** is AWS IAM. Kept in the Keychain | @@ -38,7 +38,7 @@ Naming a **Database** skips listing every database on the server, which is worth AWS IAM takes the access key ID in **Username** and the secret access key in **Password**. Temporary credentials also need their session token in **AWS Session Token**. -Also on the Options tab: **Read Preference**, **Write Concern**, **Use SRV Record**, **Replica Set** name, and **Legacy UUID Encoding**. The server has to be MongoDB 4.0 or later; the driver refuses to connect to anything older. +Also in the Options section: **Read Preference**, **Write Concern**, **Use SRV Record**, **Replica Set** name, and **Legacy UUID Encoding**. The server has to be MongoDB 4.0 or later; the driver refuses to connect to anything older. **Write Concern** covers every insert, update and delete, from a query tab or from a save in the data grid, unless the statement passes its own `writeConcern`. Index, collection and database commands, and `db.runCommand`, go to the server as written. On a server that is not a replica set, pick **Default**, **Majority** or **1**: with **2** or **3** every write fails with `cannot use 'w' > 1 when a host is not replicated`. `journal` and `wtimeoutMS` in a pasted connection URL go out with every write too. @@ -68,7 +68,7 @@ An SRV connection does not open through an SSH tunnel or another tunnel. The rec ## Replica sets -The **Hosts** field takes comma-separated pairs (`host1:27017,host2:27017,host3:27017`), the primary is discovered, and writes are routed to it. Set the replica set name on the Options tab. A multi-host URI pastes in directly: +The **Hosts** field takes comma-separated pairs (`host1:27017,host2:27017,host3:27017`), the primary is discovered, and writes are routed to it. Set the replica set name in the Options section. A multi-host URI pastes in directly: ```text mongodb://user:pass@host1:27017,host2:27017,host3:27017/db?replicaSet=rs0 @@ -425,7 +425,7 @@ The MongoDB driver is compiled into TablePro Mobile, with the same C driver and **Connection refused**: check MongoDB is running (`brew services start mongodb-community`) and that the port and `bindIp` in `mongod.conf` match what you entered. -**Authentication fails on connect**: the error names the database that was authenticated against. If your user does not live there, set **Auth Database** on the Options tab; otherwise check the username, password, and auth mechanism. The MQL editor does not parse `db.getUsers()` or `db.createUser()`; read users with `db.runCommand({"usersInfo": 1})`. +**Authentication fails on connect**: the error names the database that was authenticated against. If your user does not live there, set **Auth Database** in the Options section; otherwise check the username, password, and auth mechanism. The MQL editor does not parse `db.getUsers()` or `db.createUser()`; read users with `db.runCommand({"usersInfo": 1})`. **Timeout**: for Atlas, add your IP to the cluster's access list first. Otherwise verify host and port and check the network and firewall. diff --git a/databases/oceanbase.mdx b/databases/oceanbase.mdx index a66263a..7b0bbdc 100644 --- a/databases/oceanbase.mdx +++ b/databases/oceanbase.mdx @@ -14,7 +14,7 @@ The tenant goes in the user name: `root@test` on an observer's port 2881, `root@ | **Database** | empty | Optional. Leave it empty and open one in the tenant with `Cmd+K` | | **SSL Mode** | Preferred | TLS first, plain text if the server refuses | -**Release the Server Connection After** is on the Options tab. AWS IAM, Cloud SQL Auth Proxy and Unix socket are not offered; reach a private cluster through an [SSH tunnel](/connections/ssh-tunneling). +**Release the Server Connection After** is in the Options section. AWS IAM, Cloud SQL Auth Proxy and Unix socket are not offered; reach a private cluster through an [SSH tunnel](/connections/ssh-tunneling). ## Connection URL diff --git a/databases/redis.mdx b/databases/redis.mdx index c72d7be..53275ce 100644 --- a/databases/redis.mdx +++ b/databases/redis.mdx @@ -25,8 +25,8 @@ The sidebar splits keys into folders at every `:`, and each key gets a grid row | **Port** | `6379` | Standalone only | | **Username** | - | Redis 6 ACL user, sent as `AUTH username password`. Empty signs in as `default` | | **Password** | - | Empty for a server with no `requirepass`, and for a `nopass` ACL user | -| **Database Index** | `0` | Options tab. Type the index or use the stepper; connecting fails with the server's error if it has no such database | -| **Key Separator** | `:` | Options tab. What the sidebar splits key names on | +| **Database Index** | `0` | Options section. Type the index or use the stepper; connecting fails with the server's error if it has no such database | +| **Key Separator** | `:` | Options section. What the sidebar splits key names on | No minimum server version. ACL users need Redis 6, a Sentinel ACL user needs 6.2, and Cluster mode reads routing tips from Redis 7 where they exist. @@ -86,7 +86,7 @@ Set **Authentication** to an AWS IAM mode (Access Key, Profile, or SSO). A short ## Browsing keys -`user:1` and `user:2` sit under a `user` folder, nested as deep as the key goes (`app:cache:session:1`). Change the separator on the Options tab. When the tree cannot load, the server's error takes its place; right-click **Keys** and choose **Refresh** to try again. +`user:1` and `user:2` sit under a `user` folder, nested as deep as the key goes (`app:cache:session:1`). Change the separator in the Options section. When the tree cannot load, the server's error takes its place; right-click **Keys** and choose **Refresh** to try again. Redis keys grouped by namespace in the sidebar with values in the data grid diff --git a/databases/sap-hana.mdx b/databases/sap-hana.mdx index 06e03c1..ad56471 100644 --- a/databases/sap-hana.mdx +++ b/databases/sap-hana.mdx @@ -25,7 +25,7 @@ In SAP HANA Cloud Central, the instance's **SQL Endpoint** reads `host:443`. The | **Username** | - | Database user | | **Password** | - | Stored in the macOS Keychain | | **SSL Mode** | Verify Identity | On the **Network** tab. There is no fallback to plain TCP | -| **TLS Server Name** | Empty | On the **Options** tab. The name **Verify Identity** checks the certificate against. Empty uses the host | +| **TLS Server Name** | Empty | On the **Options** section. The name **Verify Identity** checks the certificate against. Empty uses the host | Schema names are case-sensitive. HANA stores an unquoted name in uppercase, so a schema created as `app` is `APP`, and **Schema** has to say `APP`. diff --git a/databases/spanner.mdx b/databases/spanner.mdx index c1df098..90ca238 100644 --- a/databases/spanner.mdx +++ b/databases/spanner.mdx @@ -24,7 +24,7 @@ Click **Create Connection…**, select **Spanner**, pick an auth method, fill in | **Service Account Key** | Service account only | A `.json` key file path, or the key JSON itself | | **OAuth Client ID**, **OAuth Client Secret** | OAuth only | From Google Cloud Console > APIs & Services > Credentials | | **OAuth Refresh Token** | No | OAuth only. Tried before the token saved by sign-in | -| **REST Endpoint** | No | Options tab. Empty means `https://spanner.googleapis.com` | +| **REST Endpoint** | No | Options section. Empty means `https://spanner.googleapis.com` | A custom **REST Endpoint** has to be an `https` address under `googleapis.com`, such as a regional or Private Service Connect endpoint. Credentials are never sent anywhere else. Any Spanner version works; it is a managed service. diff --git a/databases/tidb.mdx b/databases/tidb.mdx index d64ea7d..640b2f5 100644 --- a/databases/tidb.mdx +++ b/databases/tidb.mdx @@ -13,7 +13,7 @@ Point the connection at a TiDB server's SQL port, never at PD or TiKV. No minimu | **Database** | empty | Optional. Leave it empty and open one with `Cmd+K` | | **SSL Mode** | Preferred | TLS first, plain text if the server refuses. Use **Required** on TiDB Cloud | -**Release the Server Connection After** is on the Options tab. AWS IAM, Cloud SQL Auth Proxy and Unix socket are not offered; reach a private cluster through an [SSH tunnel](/connections/ssh-tunneling). +**Release the Server Connection After** is in the Options section. AWS IAM, Cloud SQL Auth Proxy and Unix socket are not offered; reach a private cluster through an [SSH tunnel](/connections/ssh-tunneling). ## Connection URL diff --git a/databases/typesense.mdx b/databases/typesense.mdx index 982c217..3d8902f 100644 --- a/databases/typesense.mdx +++ b/databases/typesense.mdx @@ -24,7 +24,7 @@ For a node on a private server, open the **Network** tab and set **Connect via** | **Host** | Node hostname. `localhost` for a local server, `xxx.a1.typesense.net` for Typesense Cloud | | **Port** | `8108` by default. Typesense Cloud answers on `443` | | **API Key** | Sent as `X-TYPESENSE-API-KEY` on every request. Stored in the Keychain | -| **Skip TLS Verification** | Options tab. Trusts any certificate, even under **Verify CA** or **Verify Identity** | +| **Skip TLS Verification** | Options section. Trusts any certificate, even under **Verify CA** or **Verify Identity** | ## Connection URL @@ -131,7 +131,7 @@ Creating a collection happens here, with `POST /collections`. The structure edit ## SSL/TLS -The connection's SSL mode picks the scheme: **Disabled** talks HTTP, anything else talks HTTPS. Typesense Cloud is HTTPS on port 443. **Skip TLS Verification** on the Options tab accepts any certificate, which covers a self-signed proxy in front of a local node. See [SSL/TLS](/connections/ssl) for the concepts. +The connection's SSL mode picks the scheme: **Disabled** talks HTTP, anything else talks HTTPS. Typesense Cloud is HTTPS on port 443. **Skip TLS Verification** in the Options section accepts any certificate, which covers a self-signed proxy in front of a local node. See [SSL/TLS](/connections/ssl) for the concepts. ## Limitations diff --git a/databases/weaviate.mdx b/databases/weaviate.mdx index a6ae9ed..0712f07 100644 --- a/databases/weaviate.mdx +++ b/databases/weaviate.mdx @@ -25,7 +25,7 @@ For a node on a private server, open the **Network** tab and set **Connect via** | **Port** | `8080` by default. Weaviate Cloud answers on `443` | | **Auth Method** | None, or API Key | | **API Key** | Sent as an `Authorization: Bearer` header, and only when **Auth Method** is API Key | -| **Skip TLS Verification** | Options tab. Trusts any certificate, even under **Verify CA** or **Verify Identity** | +| **Skip TLS Verification** | Options section. Trusts any certificate, even under **Verify CA** or **Verify Identity** | ## Authentication diff --git a/features/ai-assistant.mdx b/features/ai-assistant.mdx index 2f0cfd8..d6bc0d2 100644 --- a/features/ai-assistant.mdx +++ b/features/ai-assistant.mdx @@ -199,4 +199,4 @@ Every message carries a system prompt built from **Settings > AI > Context**, so Apple Intelligence runs inside macOS and sends nothing over the network. Ollama, llama.cpp, and MLX run on your own machine, so nothing reaches a third party. Every other provider is a network call to that vendor under the terms of your account with them. -Per connection, **AI Policy** under **Access** on the connection form's **Options** tab takes **Use Default**, **Always Allow**, **Ask Each Time**, or **Never**. A change applies to an open connection from the next message or tool call. The app-wide default is **Ask Each Time**: the chat asks before its first message on a connection, and one **Allow** covers every chat and the inline suggestions on that connection until it disconnects. **Never** also blocks external AI tool calls against that connection. External clients such as Raycast and Claude Desktop reach the same tools through the [MCP server](/features/mcp), bounded by the connection's **External Clients** level and the token's scope. +Per connection, **AI Policy** under **Access** on the connection form's **Options** section takes **Use Default**, **Always Allow**, **Ask Each Time**, or **Never**. A change applies to an open connection from the next message or tool call. The app-wide default is **Ask Each Time**: the chat asks before its first message on a connection, and one **Allow** covers every chat and the inline suggestions on that connection until it disconnects. **Never** also blocks external AI tool calls against that connection. External clients such as Raycast and Claude Desktop reach the same tools through the [MCP server](/features/mcp), bounded by the connection's **External Clients** level and the token's scope. diff --git a/features/autocomplete.mdx b/features/autocomplete.mdx index 6195531..47f9a32 100644 --- a/features/autocomplete.mdx +++ b/features/autocomplete.mdx @@ -68,7 +68,7 @@ PostgreSQL and PGlite read an unquoted name as lowercase, Oracle and Snowflake a SELECT * FROM mix| -- "MixedCase" ``` -Set how the other names are spelled under **Autocomplete > Identifier case** in the connection's [Options](/connections/connection-form#options) tab: +Set how the other names are spelled under **Autocomplete > Identifier case** in the connection's [Options](/connections/connection-form#options) section: | Value | Snowflake table `MY_TABLE`, typing `my_t` | |-------|-------------------------------------------| diff --git a/features/data-masking.mdx b/features/data-masking.mdx index 29bdefb..4208b8e 100644 --- a/features/data-masking.mdx +++ b/features/data-masking.mdx @@ -7,7 +7,7 @@ Turn on masking before a screen share, a pairing session or a recorded demo on p ## Add a rule -In the [connection form](/connections/connection-form#options), open the **Options** tab and find **Masking**. Click **Add Rule**, then set three things: +In the [connection form](/connections/connection-form#options), open the **Options** section and find **Masking**. Click **Add Rule**, then set three things: | Field | What it takes | |-------|---------------| @@ -24,7 +24,7 @@ Some patterns: | `*password*` | Any column whose name contains `password` | | `inet` with **Match** set to **Type** | Every column declared as `inet` | - + Masking section of the connection form with a Column rule on *.email set to Email and a Column rule on users.ssn set to Last 4 Characters Masking section of the connection form with a Column rule on *.email set to Email and a Column rule on users.ssn set to Last 4 Characters diff --git a/features/icloud-sync.mdx b/features/icloud-sync.mdx index 28b816b..cae0bd9 100644 --- a/features/icloud-sync.mdx +++ b/features/icloud-sync.mdx @@ -45,7 +45,7 @@ Connections that use environment variables also need [approval on each Mac](/fea ## Keeping a connection off iCloud -A localhost or throwaway database is rarely worth a round trip. Mark it **Local only** under **iCloud Sync** on the connection form's **Options** tab, or right-click it and choose **Exclude from iCloud Sync**. It shows a struck-through cloud icon in the connection list, and the flag survives duplicating and exporting. +A localhost or throwaway database is rarely worth a round trip. Mark it **Local only** under **iCloud Sync** on the connection form's **Options** section, or right-click it and choose **Exclude from iCloud Sync**. It shows a struck-through cloud icon in the connection list, and the flag survives duplicating and exporting. Marking a synced connection Local only moves its passwords, passphrases and other secrets to this Mac and removes them from iCloud Keychain. Your other Macs, iPhone and iPad keep the connection but ask for its passwords again. The form says so before you save, and the menu item asks first. A secret this Mac cannot read or save keeps its iCloud Keychain copy. Passwords of a shared SSH or credential profile belong to the profile and stay where it syncs. A connection that was already Local only keeps any older iCloud Keychain copies until you turn Local only off and on again. diff --git a/features/safe-mode.mdx b/features/safe-mode.mdx index 5818984..3c8f87d 100644 --- a/features/safe-mode.mdx +++ b/features/safe-mode.mdx @@ -3,7 +3,7 @@ title: Safe Mode description: Per-connection query execution controls, from no restrictions to full read-only lockdown --- -Six levels, one per connection. In the [connection form](/connections/connection-form#options), open the **Options** tab and set **Safe Mode** under **Access**. The level decides what stands between a query and the server: nothing, a confirmation, Touch ID, or a refusal. +Six levels, one per connection. In the [connection form](/connections/connection-form#options), open the **Options** section and set **Safe Mode** under **Access**. The level decides what stands between a query and the server: nothing, a confirmation, Touch ID, or a refusal. ## Levels @@ -132,7 +132,7 @@ This is a floor on TablePro's own behavior, not on the database. It stops the ap A write from an external client (Raycast, Cursor, Claude Desktop, any MCP client) clears three locks in order: -1. **External Clients** (per connection: **Blocked** / **Read Only** / **Read & Write**), next to **Safe Mode** under **Access** on the connection form's **Options** tab. A Read Only connection rejects a write before the request reaches the database. Reads also use the driver's read-only mode where supported; see [What Read Only allows](/developers#what-read-only-allows). +1. **External Clients** (per connection: **Blocked** / **Read Only** / **Read & Write**), next to **Safe Mode** under **Access** on the connection form's **Options** section. A Read Only connection rejects a write before the request reaches the database. Reads also use the driver's read-only mode where supported; see [What Read Only allows](/developers#what-read-only-allows). 2. **Token scope** (per integration: `readOnly` / `readWrite` / `fullAccess`), issued by the [pairing flow](/developers/pairing). The effective permission is `MIN(token.scope, connection.externalAccess)`. 3. **Safe Mode**, per query. Everything on this page then applies, Touch ID prompts and confirmation dialogs included. diff --git a/features/sql-editor.mdx b/features/sql-editor.mdx index 58282eb..c6ef0cc 100644 --- a/features/sql-editor.mdx +++ b/features/sql-editor.mdx @@ -104,7 +104,7 @@ The server rolls back what a session leaves open, so closing, disconnecting, qui ### Manual Commit -With **Manual Commit** on, nothing you change is saved until you commit it. A new connection starts with it off. Turn it on under **Access** on the [connection form's](/connections/connection-form#options) **Options** tab, or choose **Database > Manual Commit** while connected: both change the one setting saved with the connection. +With **Manual Commit** on, nothing you change is saved until you commit it. A new connection starts with it off. Turn it on under **Access** on the [connection form's](/connections/connection-form#options) **Options** section, or choose **Database > Manual Commit** while connected: both change the one setting saved with the connection. MySQL, MariaDB, TiDB, OceanBase, Oracle, ClickHouse, Redshift and CockroachDB commit schema and maintenance statements on their own, so Manual Commit is not offered there. The toggle and the menu item are dimmed, with "This database commits schema and maintenance statements on its own, so changes can't wait for Commit." under them, and a connection saved with Manual Commit on runs as if it were off. diff --git a/images/connection-form-fields-dark.png b/images/connection-form-fields-dark.png index 4f5fefc..3829c84 100644 Binary files a/images/connection-form-fields-dark.png and b/images/connection-form-fields-dark.png differ diff --git a/images/connection-form-fields.png b/images/connection-form-fields.png index 4adfdf8..44afd4c 100644 Binary files a/images/connection-form-fields.png and b/images/connection-form-fields.png differ diff --git a/images/connection-form-general-dark.png b/images/connection-form-general-dark.png index 29a501e..3829c84 100644 Binary files a/images/connection-form-general-dark.png and b/images/connection-form-general-dark.png differ diff --git a/images/connection-form-general.png b/images/connection-form-general.png index d463f84..44afd4c 100644 Binary files a/images/connection-form-general.png and b/images/connection-form-general.png differ diff --git a/images/database-type-chooser-dark.png b/images/database-type-chooser-dark.png index 7a697bc..aa78e00 100644 Binary files a/images/database-type-chooser-dark.png and b/images/database-type-chooser-dark.png differ diff --git a/images/database-type-chooser.png b/images/database-type-chooser.png index 50e294e..99cf773 100644 Binary files a/images/database-type-chooser.png and b/images/database-type-chooser.png differ diff --git a/integrations/mcp-clients.mdx b/integrations/mcp-clients.mdx index a0acb5b..d9259e8 100644 --- a/integrations/mcp-clients.mdx +++ b/integrations/mcp-clients.mdx @@ -297,7 +297,7 @@ The bridge is newer than the app it found. Update TablePro. ### This connection is read only for external clients -**External Clients** on that connection is **Read Only** and the statement writes. Change it under **Access** on the connection form's **Options** tab, or run the query in the app's editor. +**External Clients** on that connection is **Read Only** and the statement writes. Change it under **Access** on the connection form's **Options** section, or run the query in the app's editor. ### Forbidden (`-33007`) diff --git a/integrations/raycast.mdx b/integrations/raycast.mdx index 6b4e772..5d6b637 100644 --- a/integrations/raycast.mdx +++ b/integrations/raycast.mdx @@ -73,7 +73,7 @@ under Raycast's [privacy policy](https://www.raycast.com/privacy). | Symptom | What to do | |---|---| -| Paired, but the connection list is empty | TablePro omits every connection the token cannot reach. Either the allowlist you approved left it out, or its **External Clients** level is **Blocked**. Re-pair with the connection selected, or raise the level in the [connection form's Options tab](/connections/connection-form#options). | +| Paired, but the connection list is empty | TablePro omits every connection the token cannot reach. Either the allowlist you approved left it out, or its **External Clients** level is **Blocked**. Re-pair with the connection selected, or raise the level in the [connection form's Options section](/connections/connection-form#options). | | Commands hang on a running TablePro | The MCP server is stopped. Turn on **Enable MCP Server** in **Settings > MCP**; the extension retries on its own. | | `401` | The token was revoked or has expired. Run **Pair with TablePro** again. | | `403` and other MCP errors | See [MCP client troubleshooting](/integrations/mcp-clients#when-it-does-not-work). |