tldr/pages/common/psql.md

# psql

> PostgreSQL command-line client.

- Connect to database. It connects to localhost using default port 5432 with default user as currently logged in user:

`psql {{database}}`

- Connect to database on given server host running on given port with given username, without a password prompt:

`psql -h {{host}} -p {{port}} -U {{username}} {{database}}`

- Connect to database; user will be prompted for password:

`psql -h {{host}} -p {{port}} -U {{username}} -W {{database}}`

- Execute a single SQL query or PostgreSQL command on the given database. Note: useful in shell scripts:

`psql -c '{{query}}' {{database}}`

- Execute commands from a file on the given database:

`psql {{database}} -f {{file.sql}}`