Convert PostgreSQL backup to psql

Upload a .backup or .dump file and get back a psql SQL script you can load straight into your database. Types are preserved rather than flattened to text. Free, no registration, up to 10MB.

Click to upload or drag and drop

CSV, Excel, SQLite, SQL, DBF (max 10 MB)

How your data is typed in psql

Generated from the converter's own psql type mapping — this is what it actually emits, not an example.

Your datapsql type
Whole numberBIGINT
Decimal (money)NUMERIC(10,2)
Floating pointDOUBLE PRECISION
True / falseBOOLEAN
DateDATE
Date and timeTIMESTAMP
Short textTEXT
Long textTEXT
Binary dataBYTEA

Working from a PostgreSQL backup

A PostgreSQL backup is not one thing. pg_dump can write plain SQL, a compressed custom-format archive or a tar archive, and all three routinely end up carrying the same .dump or .backup extension.

  • The first five bytes decide: PGDMP means an archive, which is unpacked with pg_restore, and anything else is treated as plain SQL. The extension is never trusted for this.
  • pg_restore is run with --file=- to print SQL to a pipe, so your backup is converted without ever being restored into a live PostgreSQL server: nothing connects to a database and nothing is created.
  • The directory format, pg_dump -Fd, is a folder rather than a file and cannot be uploaded. Re-dump it as -Fc or as plain SQL.

Running the script through psql

psql is PostgreSQL's command-line client rather than the database itself, and the script is written to be fed straight into it. Everything here is about the tool you run, not about the server you run it against.

  • From inside a session already open, \i dump.sql runs the file without leaving the prompt. The script contains no backslash meta-commands of its own, so nothing in it can collide with yours.
  • There is no BEGIN and no COMMIT anywhere in the file. Statements commit as they go, so a failure halfway leaves the tables already created: pass -1 to wrap the whole load in a single transaction, or -v ON_ERROR_STOP=1 to stop at the first error instead of carrying on past it.
  • The script switches standard_conforming_strings on itself instead of trusting the server default, so it behaves identically against a session that has been moved off it.
  • It sets client_encoding to UTF8 for the same reason. The file is written as UTF-8 with nothing to announce that, and psql would otherwise decode it using whatever the client locale says.

Reading PostgreSQL backup

  • Reads pg_dump custom-format archives (.backup, .dump) — pgAdmin's default backup option — as well as plain SQL dumps.
  • Data written as COPY blocks is read, not just INSERT statements. COPY is pg_dump's default, so a reader that only understands INSERT returns your tables with none of their rows.
  • Primary keys declared by a later ALTER TABLE, which is how pg_dump writes them, are preserved.

Writing psql

  • Backslashes are left alone, because PostgreSQL treats them as ordinary characters — doubling them would corrupt every Windows path.
  • Auto-increment columns become GENERATED BY DEFAULT AS IDENTITY.
  • Binary data is written as bytea, and identifiers respect the 63-character limit.

What you get

A ZIP containing dump.sql, plus a README with the exact command to load it. If anything about your data needed a judgement call, a _warnings.txt explains it.

Load this dump into PostgreSQL:

  psql -U USER -d DATABASE -f dump.sql

Create the database first if it does not exist:

  createdb -U USER DATABASE

Questions

Is converting PostgreSQL backup to psql free?
Yes. Files up to 10MB convert free with no account. There is a limit of five conversions per day per IP address.
Will my PostgreSQL backup data keep its types in psql?
Yes — that is the point. Whole numbers, decimals, dates and booleans are mapped to real psql types rather than everything becoming text. The mapping table above shows exactly what you get.
Do you store my file?
No. The file is written to a temporary directory, converted, and the directory is deleted as soon as your download has been sent.

This conversion, under other names

Convert PostgreSQL backup to something else

Convert something else to psql