psql ni mteja wa mstari-amri shirikishi wa PostgreSQL — unatumika kuunganisha kwenye hifadhidata na kuendesha maswali, kukagua schema, na kusimamia hifadhidata. Una meta-commands maalum (zinazoanza na \) kwa urambazaji na usimamizi, zaidi ya kuendesha SQL.
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
Meta-commands hizi za \ zinakuruhusu kuchunguza na kusimamia hifadhidata haraka — \dt (orodhesha jedwali), \d tablename (kagua muundo wa jedwali), na \l (orodhesha hifadhidata) zinatumika mara kwa mara.
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 ni zana muhimu ya kila siku kwa kufanya kazi moja kwa moja na PostgreSQL — watengenezaji na DBAs wanaitumia mara kwa mara kuunganisha, kuuliza, kukagua, na kusimamia hifadhidata, hivyo kujua misingi yake ni maarifa ya kivitendo na ya msingi kwa kazi ya Postgres.
Ingawa zana za GUI zipo, psql ni kiolesura cha ulimwengu kinachopatikana kila wakati (kipo popote Postgres ilipo), na meta-commands zake (\) zinaifanya iwe na nguvu hasa kwa uchunguzi na usimamizi wa haraka wa hifadhidata ambao SQL safi haiwezi kufanya kwa urahisi: \dt (orodhesha jedwali), \d tablename (kagua muundo kamili wa jedwali — safu wima, aina, indexes, constraints — hitaji la mara kwa mara), \l (orodhesha hifadhidata), \du (orodhesha watumiaji/roles), na nyingine zinakuruhusu kurambaza na kuelewa hifadhidata haraka.
Kujua jinsi ya kuunganisha (kwa chaguo au URL), kuendesha maswali na hati (-f kwa faili, -c kwa amri za mara moja), kutumia meta-commands kwa ukaguzi, na mipangilio yenye manufaa (\x kwa onyesho la safu pana linalosomeka, \timing kwa muda wa maswali) ni maarifa ya kivitendo ya kila siku kwa mtengenezaji au msimamizi yeyote wa Postgres.
Kwa kuwa psql ndio kiolesura sanifu na cha kawaida cha mstari-amri kwa PostgreSQL — kinachotumika kwa utengenezaji, kutatua hitilafu, usimamizi, uandishi wa hati, na uchunguzi — kuelewa amri zake muhimu na mtiririko wa kazi ni maarifa yenye thamani, yanayotumika mara kwa mara yanayofanya kazi na Postgres kuwa na ufanisi, na ni ujuzi wa msingi unaotarajiwa kwa yeyote anayefanya kazi na hifadhidata moja kwa moja.