diff --git a/connections/connection-form.mdx b/connections/connection-form.mdx index 825f2d6..7fefc95 100644 --- a/connections/connection-form.mdx +++ b/connections/connection-form.mdx @@ -69,6 +69,7 @@ Encryption sits below the transport. [SSL/TLS](/connections/ssl) covers the mode | **Extensions** | SQLite, and libSQL in Local File mode. Libraries loaded into the database file on every connect. See [Extensions](/databases/sqlite#extensions) | | **Connect timeout** | Maximum seconds for the network transport and remote database to finish connecting. Empty uses 30 seconds; valid values are 1 to 600 | | **Query timeout** | Override of **Settings > General** for this connection. Empty inherits the global value; `0` means no limit. Only drivers that support query timeouts enforce it | +| **Load binary values up to** | MySQL and MariaDB. A binary value above this many KB loads when you open, copy or export it. Empty uses 64; valid values are 1 to 1048576. See [Large binary values](/features/data-grid#large-binary-values) | | **Identifier case** | PostgreSQL, PGlite, Oracle and Snowflake. The case table, column and schema names take in autocomplete and in **Copy as INSERT Statements** and **Copy as UPDATE Statements**. See [Identifier case](/features/autocomplete#identifier-case) | | **Startup Commands** | SQL to run after every connect. See [Startup commands](#startup-commands) | | **Pre-Connect Script** | Shell script run before connecting. A non-zero exit aborts the connect. See [Connection scripts](#connection-scripts) | diff --git a/features/data-grid.mdx b/features/data-grid.mdx index 4a28cf5..ab60990 100644 --- a/features/data-grid.mdx +++ b/features/data-grid.mdx @@ -71,6 +71,14 @@ Hide columns from the columns button in the status bar or from the header menu. Widths, order, and hidden columns are remembered per table, scoped to the connection, database, and schema; **Reset Columns** in the popover puts them back. Right-click a header and choose **Display As** to read a column's stored values in a different form; [Cell and Row Viewers](/features/json-viewer) lists the formats. +### Large binary values + +On MySQL and MariaDB, a binary value larger than the connection's limit stays on the server until you need it, in any table with a primary key. The cell shows the value's size in italics, such as *5.2 MB*. Set the limit under **Options > Load binary values up to** in the [connection form](/connections/connection-form#options); it is 64 KB until you change it. + +The value is read by its primary key when you open the cell, copy it, show its row in the inspector with one row selected, duplicate the row, list the column's values with **Filter Values…**, or export the rows with **Export Results…**. **File > Export** reads every value as before. Set NULL, paste and **Fill Column** read the value first, so undo puts it back. A table without a primary key, a sorted column and a column under a value filter load every value with the page. + +Find and the selection summary skip a value until it loads, and the JSON view shows it as *Not loaded* with its size. Deleting a row whose value never loaded saves normally, but [Data Rewind](/features/change-tracking#restoring-a-save) cannot put that row back. + ### Jump to a column `Cmd+Shift+J`, or **Edit > Find > Jump to Column**, lists every column of the result with its type and its place in the grid. Type part of a name; matching is fuzzy, so `crat` finds `created_at`. `Return` scrolls the selected column into view and puts the cell cursor in it, on the selected row. A hidden column is listed too, marked **Hidden**, and jumping to it shows it first. **Jump to Column** at the foot of the columns popover opens the same panel with the popover's search carried over.