Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tablepro.app/llms.txt

Use this file to discover all available pages before exploring further.

Import & Export

Export data in five formats (CSV, JSON, SQL, MQL, XLSX), import SQL files with gzip support, and paste tabular data from the clipboard into the grid.

Export Data

  1. Run a query or open a table
  2. Click Export in the toolbar (Cmd+Shift+E)
  3. Choose a format, select tables, configure options
  4. Click Export
MongoDB: SQL export is not available. Use CSV, JSON, MQL, or XLSX. MQL generates db.collection.insertMany([...]) scripts for mongosh.
Redis: SQL and MQL exports are not available. Use CSV, JSON, or XLSX.
Export dialog

Export Formats

OptionDefault
Header rowYes
Delimiter (comma, semicolon, tab, pipe)Comma
Quote handling (always, as needed, never)As needed
NULL to empty stringsYes
Line breaks in values to spacesNo
Line ending (LF, CRLF, CR)LF
Decimal separator (period, comma)Period
Formula sanitizationYes
CSV export options

Exporting Query Results

Right-click the results grid and select Export Results…, or go to File > Export Results…. Choose a format, configure options, and click Export. Only in-memory results are exported.
Use LIMIT in your query to control export size for large tables.

Exporting Entire Tables

Click a table in the sidebar and click Export, or run SELECT * FROM table_name and export.
Export multiple tables at once via the export dialog’s tree view. SQL exports support per-table options for structure, DROP, and data.

Streaming Export

Table exports stream rows directly from the database to disk (shipped v0.33.0). No in-memory buffering, no row-count limit: tables larger than RAM export fine. Properties:
  • Streamed write per row, constant memory regardless of table size
  • Atomic file write: the destination file appears only on success, partial files are removed on failure
  • Cancellable from the progress dialog. Cancellation removes the partial file
  • Per-row error handling, configurable in the export dialog:
ModeBehavior
Stop and RollbackStop on first row error and discard the output file.
Stop and CommitStop on first row error but keep rows already written.
Skip and ContinueSkip the failing row, log it, and continue. A summary lists skipped rows at the end.
Streaming applies to whole-table exports. Result-grid exports use in-memory data.

Clipboard Paste (CSV/TSV)

Paste tabular data directly into the data grid. Press Cmd+V after selecting a row. Format is auto-detected: tabs parse as TSV, commas as CSV.

Import Data

Import .sql and .sql.gz files. Statements execute directly against your database: backups, migrations, seed data.
MongoDB: SQL import is not available. Use mongoimport or the MQL shell.

Import Workflow

1

Open Import Dialog

Click File > Import (Cmd+Shift+I), or drag and drop a .sql / .sql.gz file onto the app.
2

Configure Options

Set encoding, transaction wrapping, and foreign key check options.
3

Preview and Import

Review the SQL preview, statement count, and file size. Click Import to execute.
Import dialog

Import Options

OptionDescriptionDefault
On errorHow to handle failed statements (see below)Stop and Rollback
EncodingFile encoding: UTF-8, UTF-16, Latin1, or ASCIIUTF-8
Wrap in transactionExecute all statements within a single transactionYes
Disable foreign key checksTemporarily disable FK constraints during importYes
For PostgreSQL the checkbox runs SET session_replication_role = replica, which requires the REPLICATION role or superuser. Most managed Postgres providers (RDS, Neon, Supabase) reject it, so the checkbox may have no effect there. TablePro’s SQL exports already emit foreign key constraints with ALTER TABLE ... ADD CONSTRAINT after data load, so the dump round-trips without needing the privilege. For MySQL the checkbox runs SET FOREIGN_KEY_CHECKS = 0 and is supported on standard accounts. SQLite uses PRAGMA foreign_keys = OFF. Drivers without an equivalent (most NoSQL drivers) ignore the option.

Error Handling Modes

Three modes for handling errors during import:
ModeBehavior
Stop and RollbackStops on first error. If transaction is enabled, rolls back all changes. Default.
Stop and CommitStops on first error. Commits statements that succeeded before the error.
Skip and ContinueLogs failed statements and continues importing. Shows a summary with all errors at the end. Transaction wrapping is disabled in this mode.
In Skip and Continue mode, failed statements are collected (up to 1,000) with line numbers and error messages. After import completes, a summary dialog shows how many succeeded vs failed, with a scrollable error list and a “Copy Errors to Clipboard” button.

Progress and Errors

During import, a progress bar shows statements processed and overall completion.
Import progress