Czym jest psql i jakie są jego podstawowe komendy?

Question

Accepted Answer

**`psql`** to interaktywny klient wiersza poleceń PostgreSQL — używany do łączenia się z bazą danych, uruchamiania zapytań, inspekcji schematu i administracji bazą danych. Ma specjalne **meta-komendy** (zaczynające się od `\`) do nawigacji i administracji, poza uruchamianiem SQL.

## Łączenie się

```bash
psql -U username -d database_name -h host -p 5432   # connect with options
psql postgresql://user:pass@host:5432/dbname        # or a connection URL
psql mydb                                            # connect to a local database
```

## Podstawowe meta-komendy (komendy ze sleszem wstecznym)

```text
\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)
	iming       toggle query timing
\?            help on meta-commands
\h SELECT     help on a SQL command
\q            quit
```

Te meta-komendy `\` umożliwiają szybką eksplorację i administrację bazą danych — `\dt` (lista tabel), `\d tablename` (inspekcja struktury tabeli) i `\l` (lista baz danych) są używane stale.

## Uruchamianie zapytań i skryptów

```sql
SELECT * FROM users LIMIT 5;          -- run SQL directly (end with ;)
```

```bash
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)
```

## Przydatne ustawienia

```text
\x auto       auto-switch to vertical display for wide results
	iming on    show how long each query takes
\e            open the last query in an editor
\set, \pset   configure variables and output formatting
```

## Dlaczego to ważne

`psql` to niezbędne, codzienne narzędzie do bezpośredniej pracy z PostgreSQL — programiści i administratorzy baz danych używają go stale do łączenia, wykonywania zapytań, inspekcji i administracji bazami danych, więc znajomość jego podstaw to praktyczna, fundamentalna wiedza dla pracy z Postgresem.

Chociaż istnieją narzędzia GUI, `psql` to uniwersalny, zawsze dostępny interfejs (obecny wszędzie tam, gdzie zainstalowany jest Postgres), a jego **meta-komendy** (`\`) czynią go szczególnie potężnym do szybkiej eksploracji bazy danych i administracji, której czysty SQL nie potrafi zrobić wygodnie: `\dt` (lista tabel), `\d tablename` (inspekcja pełnej struktury tabeli — kolumny, typy, indeksy, ograniczenia — stała potrzeba), `\l` (lista baz danych), `\du` (lista użytkowników/ról) i inne pozwalają na szybką nawigację i zrozumienie bazy danych.

Znajomość jak się łączyć (z opcjami lub URL), uruchamiać zapytania i skrypty (`-f` dla plików, `-c` dla jednorazowych poleceń), używać meta-komend do inspekcji oraz przydatnych ustawień (`\x` do czytelnego wyświetlania szerokich wierszy, `	iming` do pomiaru czasu zapytań) to codziennie praktyczna wiedza dla każdego programisty lub administratora Postgresa.

Ponieważ `psql` to standardowy, wszechobecny interfejs wiersza poleceń PostgreSQL — używany do rozwoju, debugowania, administracji, skryptowania i eksploracji — zrozumienie jego podstawowych komend i przepływu pracy to cenna, często stosowana wiedza, która sprawia, że praca z Postgresem jest wydajna, i jest to podstawowa kompetencja oczekiwana od każdego pracującego bezpośrednio z bazą danych.