Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions customization/data-settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ The picker lists the monospaced families installed on your Mac, at 10 to 24 pt.
| Auto-show inspector on row select | Off | Opens the inspector on selecting a row, in a query result as well as a table. A pane you left on the assistant stays on it |
| Smart value detection | On | Reads id-like binary columns as UUIDs, timestamp-named integer columns as dates, and binary columns holding UTF-8 as text. Override per column with Display As, see [Cell and Row Viewers](/features/json-viewer) |
| Show invisible characters | On | Marks zero-width, control and special space characters in cells and value fields. See [Invisible characters](/features/data-grid#invisible-characters) |
| Wrap text in cells | Off | New tabs open with long values wrapped onto up to 10 lines. Open tabs keep their own choice. See [Wrap text](/features/data-grid#wrap-text) |
| Color values by type | Off | Draws strings, numbers, dates, binary, JSON, UUID and enum values in the theme's **Values** colors. See [Appearance](/customization/appearance#editing-a-theme) |
| Default row sort | Primary key | Or First column, No sorting (engine order). Applied when a table first opens; a table with no primary key keeps the engine's order; clicking a column header overrides it |
| Sort direction | Ascending | Or Descending. Sets the default row sort's direction and which way the first click on a column header sorts |
Expand Down
11 changes: 11 additions & 0 deletions features/data-grid.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,17 @@ Hide columns from the columns button in the status bar or from the header menu.

Widths, order, hidden and frozen 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.

### Wrap text

Choose **View > Wrap Text**, or **Wrap Text** on the header menu, to show long values on several lines. A row grows to fit its tallest cell, up to 10 lines; a value that needs more ends in an ellipsis. A line break stored in the value starts a new line. With wrap off, every row is one line and a line break shows as a space.

<Frame caption="Rows grow to fit wrapped values">
<img className="block dark:hidden" src="/images/data-grid-wrap-text.png" alt="Notes table with Wrap Text on: long body values run over several lines and short rows stay one line" />
<img className="hidden dark:block" src="/images/data-grid-wrap-text-dark.png" alt="Notes table with Wrap Text on: long body values run over several lines and short rows stay one line" />
</Frame>

Wrap applies to the whole grid of one tab, in tables, views and query results, and is saved with the tab. **Wrap text in cells** in [data settings](/customization/data-settings) sets it for new tabs.

### Freeze columns

Right-click a column's header and choose **Freeze Up to This Column** to hold it and every column before it beside the row numbers. The rest scroll under them, and a line marks where the frozen columns end. Select, copy, edit, find and jump to a frozen column as to any other. **Unfreeze Columns** on the header menu lets them scroll again.
Expand Down
Binary file added images/data-grid-wrap-text-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/data-grid-wrap-text.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions linux/data-grid.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -64,4 +64,5 @@ On ClickHouse, Cassandra and ScyllaDB a save is a series of statements, each lan
- `Alt+Left` and `Alt+Right` move the focused column, and `Shift+Alt+Left` and `Shift+Alt+Right` narrow and widen it. Dragging a header moves the column, and dragging its edge resizes it.
- **Columns…** hides and shows columns. **Reset Columns** there goes back to the table's own order.
- Order, hidden columns and widths are kept per table.
- **Wrap Text** on a header's menu shows long values on up to 10 lines, with a line break in the value starting a new line. It applies to the tab's whole grid, and **Wrap Text** in Preferences sets it for new tabs.
- `Ctrl+J` on a foreign key cell opens the row it points at in a new tab. **Show Referencing Rows** on a saved row opens the rows that point at it.
4 changes: 4 additions & 0 deletions windows/data-grid.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,10 @@ A table opened from the object tree shows one page of rows, 1,000 by default. Ed
<img className="hidden dark:block" src="/images/windows-data-grid-dark.png" alt="Artist table with the first name underlined on a yellow fill and row 25 struck through on red" />
</Frame>

## Wrap long values

Choose **Wrap text** in the **View** menu or on a column header's menu to show long values on up to 10 lines. A row grows to fit its tallest cell, and a line break in the value starts a new line. The choice is kept with the tab; **Wrap text in cells** in Settings sets it for new tabs.

## Count a large table

A table counts its rows when it opens, so **Last page** and **Go to page** know where the end is. A table the database estimates at more rows than **Settings > Pagination > Count rows if estimate less than** skips that count: the status reads `1-1,000 of about 2,000,000 rows`, and **Count rows** in the toolbar counts it on request.
Expand Down
Loading