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.
PostgreSQL Connections
TablePro supports PostgreSQL 12 and later via the libpq C connector. Schema browsing, rich type display (JSONB, arrays, UUID, inet), and all standard PostgreSQL query features work out of the box.Quick Setup
Create Connection
Click New Connection, pick PostgreSQL in the chooser sheet, fill in host/port/username/password/database, and click Save & Connect
Connection Settings
| Field | Default | Notes |
|---|---|---|
| Host | localhost | |
| Port | 5432 | |
| Username | postgres | |
| Database | - | Required (unlike MySQL) |

Example Configurations
Local: hostlocalhost:5432, user postgres, “trust” auth (no password) with Homebrew
Docker: host localhost:5432, password from POSTGRES_PASSWORD env
AWS RDS: Use endpoint hostname, standard credentials
Heroku: Parse DATABASE_URL for credentials
Remote: Use SSH tunneling for secure access
Features
Sidebar displays all accessible schemas and tables. Switch databases/schemas with Cmd+K. Table info shows structure (columns, indexes, constraints) and DDL. Full PostgreSQL syntax support:PostgreSQL-Specific Types
Supportsjsonb (formatted JSON), array, uuid, inet (IP), timestamp with time zone, interval, bytea (binary).
Troubleshooting
Connection refused: Check server is running (brew services start postgresql@16), verify listen_addresses in postgresql.conf, ensure firewall allows port 5432.
Auth failed: Check pg_hba.conf for correct auth method (md5/scram-sha-256 for passwords, trust for local dev). Reset password with ALTER USER postgres WITH PASSWORD 'newpassword';
Database doesn’t exist: Connect to postgres database and create it with CREATE DATABASE myapp;
Permission denied: Grant access with GRANT ALL ON DATABASE/SCHEMA/TABLES TO username;
SSL/TLS: Cloud providers (AWS RDS, Heroku, Supabase) typically require SSL. Use Required or Verify CA. For unencrypted alternatives, use SSH tunneling.
Advanced Configuration
Startup Commands (Advanced tab): Set session variables likeSET timezone = 'UTC'; SET search_path TO myschema, public; to apply automatically on connect.
~/.pgpass Support: Use format hostname:port:database:username:password with wildcards (*). Must have chmod 0600 permissions.
Pre-Connect Script (Advanced tab): Run a shell script before connecting (e.g., to refresh credentials from a secrets manager). 10-second timeout.
PostgreSQL Extensions: PostGIS, hstore, ltree work out of the box. Check with SELECT * FROM pg_extension;
Performance: Use EXPLAIN ANALYZE for query optimization. LIMIT large exploratory queries, create indexes, enable pagination.
MySQL Migration Notes: Use SERIAL (not AUTO_INCREMENT), LIMIT y OFFSET x syntax, double quotes for identifiers, GENERATED AS IDENTITY for new schemas.
