Switching to TablePro

Move your connections from TablePlus, Sequel Ace, DBeaver, DataGrip, Beekeeper Studio or Navicat, what comes across, what does not, and how to get your shortcuts back

Most of a migration is one dialog. File > Import from Other App… reads the connections your current client already has, including groups and folders, and the source app does not need to be running.

This page covers the rest: what does not come across, and what to do about it.

Import your connections

1. Open the importer

   File > Import from Other App…

2. Pick your current client

   TablePlus, Sequel Ace, DBeaver, DataGrip and Beekeeper Studio are read in place. Navicat is the exception: export first with File > Export Connections in Navicat, with Export Password turned on, then point TablePro at the .ncx file.

3. Review and import

   Deselect anything you do not want, resolve duplicates, click Import.

4. Open one before you delete the old app

   Connect to a connection that had a password. That is the only check that proves the credential came across, and deleting the source app is the one step you cannot undo.

Pick the client you're coming from

Review before anything is saved

SSH tunnel and SSL settings come across with the connection. Which engines each source carries, and the quirks of each one, are in Connection Sharing.

About passwords

Where your old client keeps them	What the import does
Its own encrypted store: DBeaver, Beekeeper Studio, Navicat	Decrypts it and runs start to finish with nothing to click
The macOS Keychain: TablePlus, Sequel Ace, DataGrip	macOS asks permission once per item. Choose Always Allow rather than Allow and the run stops asking

A DataGrip project protected by a master password cannot be read at all. Import those connections and set their passwords in TablePro.

What does not come across

Not imported	What to do
Saved queries and snippets	Re-save the ones you actually use as Favorites with Cmd+D. To keep a whole folder of .sql files in sync instead, including one tracked in git, Linked Folders does that and needs a Starter license
Query history	Starts fresh. TablePro records history per connection from the first query you run, searchable with Cmd+Y
Column widths, sort order and per-table filters	Rebuilt as you browse. TablePro saves these per table on its own
Keyboard shortcuts	See the next section

Getting your shortcuts back

TablePro follows macOS conventions, so a good number of chords already match whatever you were using: Cmd+N, Cmd+W, Cmd+S, Cmd+O, Cmd+Q, Cmd+F, and Cmd+Enter to run a query.

Where yours differ, rebind them in Settings > Keyboard (Cmd+,). Record the chord you are used to and TablePro warns you if something else already claims it.

Settings > Keyboard, where every rebindable shortcut lives

Set these up on your first day:

Job	TablePro
Run the statement under the cursor	Cmd+Enter
Run every statement	Cmd+Shift+Enter
Jump to any table, database or saved query by name	Cmd+Shift+O
Switch database	Cmd+K
Query history	Cmd+Y
Cancel a running query	Cmd+.
Format the query	Cmd+Shift+L
Explain the query	Cmd+Option+E
Save the query as a favorite	Cmd+D

A few cannot be reassigned, so learn them rather than fight them: editor built-ins such as Cmd+/ for comment, Cmd+[ and Cmd+] for indent, tab selection Cmd+1 through Cmd+9, and text size Cmd+= and Cmd+-. The recorder tells you when you hit one.

Coming from TablePlus, where Cmd+F opens the row filter? Rebind Toggle Filters to Cmd+F in Settings > Keyboard and choose Reassign when it asks. Find gives up Cmd+F while the filter bar holds it, and takes it back if you move the filter bar off again.

If you use Vim bindings, turn on Vim Mode in Settings > Editor and most of this section stops mattering.

The full list is in Keyboard Shortcuts.

Coming from a client TablePro cannot import

Two other routes exist.

A connection URL. Add from Existing > Import from URL takes a postgres://, mysql:// or similar URL and fills in the form. Fastest path when you only have a handful of connections.

Import from URL

A project folder. Open Project Folder reads the database settings out of a project’s config files, so a repository with a .env, docker-compose.yml or framework config becomes a connection without you typing a host.

If your database is not supported yet

A database missing from the connection form may still be one click away in Settings > Plugins > Browse.

Settings > Plugins > Browse

If it is genuinely not there, open a request on GitHub. Driver coverage is tracked in the open, and the supported database list is the current answer.