docs: sync MDX content with implementation

This commit is contained in:
t8y2 committed 2026-05-17 11:35:15 +08:00
1 parent 71f9f11eec
commit 3337826b89
37 files changed
+738 -218

No files matched your search

+17
View File
@@ -40,6 +40,17 @@ You can edit data directly in the grid:
All changes are staged locally first. Before saving, DBX shows the SQL it is about to execute.
## When Editing Is Available
Editing is available when DBX can identify the target table and enough key information to generate reviewable `UPDATE`, `INSERT`, or `DELETE` statements. Simple table browsing is usually editable. Ad-hoc joins, aggregates, expressions, or result sets without usable keys are treated as read-only.
| Result Type | Typical Behavior |
|---|---|
| Opened table data | Editable when the database and table support edits |
| Simple `SELECT * FROM table` | Often editable if primary key or row identity is available |
| Joins, aggregates, computed columns | Read-only result set |
| Redis or MongoDB views | Use their dedicated editors instead of relational row SQL |
## SQL Preview
<Callout type="warn">
@@ -53,6 +64,8 @@ The preview shows `UPDATE`, `INSERT`, or `DELETE` statements. Use it to confirm:
- Delete operations match the expected records
- `NULL`, empty strings, and default values are handled correctly
If the preview looks too broad, cancel the save and narrow the filter or selection first.
## Cell Details
Click a cell to open the detail panel. It is useful for values that are awkward to edit directly inside a table:
@@ -73,3 +86,7 @@ Click a cell to open the detail panel. It is useful for values that are awkward
| INSERT | Copy selected rows as executable `INSERT` statements |
Before exporting, check the active filters and sort order so the exported data matches what you expect.
## Pagination And Large Results
DBX can page result sets and keep large grids responsive with virtual scrolling. For large tables, prefer database-side `WHERE` and `ORDER BY` clauses instead of relying only on client search, because the database can use indexes and return a smaller result set.