psql yra PostgreSQL interaktyvus komandinės eilutės klientas — naudojamas duomenų bazei prisijungti ir užklausoms vykdyti, schemą peržiūrėti ir duomenų bazę administruoti. Jis turi specialias meta-komandas (pradedamas \), kurios skirtos navigacijai ir administravimui, be tiesioginio SQL vykdymo.
psql -U username -d database_name -h host -p 5432
psql postgresql://user:pass@host:5432/dbname
psql mydb
\l list all databases
\c dbname connect to a database
\dt list TABLES in the current database
\d tablename describe a table (columns, types, indexes, constraints)
\di list indexes
\dn list schemas
\du list roles/users
\df list functions
\dv list views
\x toggle expanded display (vertical — readable for wide rows)
\timing toggle query timing
\? help on meta-commands
\h SELECT help on a SQL command
\q quit
Šios \ meta-komandos leidžia greitai peržiūrėti ir administruoti duomenų bazę — \dt (lentelių sąrašas), \d tablename (lentelės struktūros inspektavimas) ir \l (duomenų bazių sąrašas) naudojami nuolat.
SELECT * FROM users LIMIT 5; -- run SQL directly (end with ;)
psql -d mydb -f script.sql -- run a SQL FILE
psql -d mydb -c "SELECT count(*) FROM users" -- run a single command and exit
\i script.sql -- run a file from within psql
\copy users TO 'users.csv' CSV HEADER -- export to CSV (client-side)
\x auto auto-switch to vertical display for wide results
\timing on show how long each query takes
\e open the last query in an editor
\set, \pset configure variables and output formatting
psql yra esminė, kasdienė priemonė tiesiogiai dirbti su PostgreSQL — kūrėjai ir duomenų bazės administratoriai jį naudoja nuolat norint prisijungti, vykdyti užklausas, inspektuoti ir administruoti duomenų bazes, todėl žinoti jo pagrindus yra praktinis, fundamentalus žinias Postgres darbui.
Nors GUI priemonės egzistuoja, psql yra universalus, visada prieinamas sąsaja (prieinamas kur tik yra Postgres), ir jo meta-komandos (\) daro jį ypač galingu greitai duomenų bazę peržiūrint ir administruojant, ką grynasis SQL negali patogumo atžvilgiu daryti: \dt (lentelių sąrašas), \d tablename (inspektuoti pilną lentelės struktūrą — stulpeliai, tipai, indeksai, apribojimai — nuolatinis poreikis), \l (duomenų bazių sąrašas), \du (vartotojų/vaidmenų sąrašas) ir kiti leidžia greitai naviguoti ir suprasti duomenų bazę.
Žinoti kaip prisijungti (su parinktimis arba URL), vykdyti užklausas ir skriptus (-f failams, -c vienkartinėms komandoms), naudoti meta-komandas inspektavimui ir naudingus nustatymus (\x skaitomam plačių eilučių vaizdu, \timing užklausų laikui matuoti) yra kasdienės praktinės žinios bet kuriam Postgres kūrėjui ar administratoriui.
Kadangi psql yra standartinis, visur pasitaikantis komandinės eilutės sąsaja su PostgreSQL — naudojama vystymuisi, derinimui, administravimui, skriptavimui ir eksploracijai — suprasti jo esminius dydžius ir darbo srauto yra vertinga, dažnai taikoma žinia, kuri padarytų darbą su Postgres efektyvų ir ji yra pagrindinė kompetencija, tikimasi iš bet kurio, dirbančio su duomenų baze tiesiogiai.