Menu
CoddyTech

PostgreSQL Cheat Sheet: polecenia psql

Ostatnia aktualizacja

Polecenia psql

Metapolecenia działają w psql (terminalowym kliencie PostgreSQL), a nie na serwerze. Zaczynają się od ukośnika wstecznego i nie potrzebują średnika.

Co robiPolecenie
Lista baz danych\l
Połącz się z inną bazą danych\c shop
Lista tabel\dt
Lista tabel we wszystkich schematach\dt *.*
Opis tabeli (kolumny, indeksy, klucze)\d users
Opis z informacjami o przechowywaniu i komentarzami\d+ users
Lista schematów\dn
Lista widoków\dv
Lista indeksów\di
Lista funkcji\df
Lista ról (użytkowników)\du
Pokaż bieżące połączenie\conninfo
Uruchom SQL z pliku\i setup.sql
Włącz lub wyłącz pomiar czasu zapytań\timing
Widok rozszerzony (jedna kolumna w wierszu)\x
Edytuj ostatnie zapytanie w swoim edytorze\e
Pomoc do składni SQL\h CREATE TABLE
Lista wszystkich metapoleceń\?
Zakończ psql\q

Łączenie z terminala

Co robiPolecenie
Połącz się z bazą danych jako użytkownikpsql -U postgres -d shop
Połącz się ze zdalnym hostem i portempsql -h db.example.com -p 5432 -U app -d shop
Połącz się za pomocą adresu URL połączeniapsql postgresql://app:secret@localhost:5432/shop
Uruchom jedno zapytanie i zakończpsql -d shop -c "SELECT count(*) FROM users;"
Uruchom plik SQLpsql -d shop -f setup.sql
Utwórz bazę danych z powłokicreatedb shop
Usuń bazę danych z powłokidropdb shop

Bazy danych i schematy

Co robiSQL
Utwórz bazę danychCREATE DATABASE shop;
Usuń bazę danychDROP DATABASE shop;
Pokaż bieżącą bazę danychSELECT current_database();
Utwórz schematCREATE SCHEMA sales;
Pokaż kolejność wyszukiwania schematówSHOW search_path;
Szukaj najpierw w danym schemacieSET search_path TO sales, public;
Pokaż wersję serweraSELECT version();

Tabele i typy danych

Co robiSQL
Utwórz tabelę z kluczem identityCREATE TABLE products (id integer GENERATED ALWAYS AS IDENTITY PRIMARY KEY, name text NOT NULL, price numeric(10,2) CHECK (price >= 0), created_at timestamptz DEFAULT now());
Dodaj kolumnęALTER TABLE users ADD COLUMN phone text;
Zmień nazwę kolumnyALTER TABLE users RENAME COLUMN country TO country_code;
Zmień typ kolumnyALTER TABLE users ALTER COLUMN age TYPE smallint;
Ustaw wartość domyślnąALTER TABLE users ALTER COLUMN active SET DEFAULT false;
Usuń kolumnęALTER TABLE users DROP COLUMN tags;
Opróżnij tabelę i zresetuj jej identityTRUNCATE orders, users RESTART IDENTITY;
Usuń tabelę, jeśli istniejeDROP TABLE IF EXISTS products;
Dokładna liczba dziesiętna dla kwotnumeric(10,2)
Data i czas ze strefą czasowątimestamptz
Losowy UUIDSELECT gen_random_uuid();
Typ wyliczeniowy (enum)CREATE TYPE mood AS ENUM ('happy', 'sad');

Ograniczenia i klucze

Co robiSQL
Dodaj klucz głównyALTER TABLE logs ADD PRIMARY KEY (id);
Klucz obcy, który usuwa wiersze podrzędneCREATE TABLE reviews (id integer PRIMARY KEY, user_id integer REFERENCES users(id) ON DELETE CASCADE);
Dodaj ograniczenie sprawdzające (check)ALTER TABLE orders ADD CONSTRAINT amount_positive CHECK (amount > 0);
Unikalność, w której NULL-e liczą się jako równe (15+)CREATE TABLE emails (address text UNIQUE NULLS NOT DISTINCT);
Ustaw kolumnę jako wymaganąALTER TABLE users ALTER COLUMN country SET NOT NULL;
Usuń ograniczenieALTER TABLE users DROP CONSTRAINT users_email_key;

Zapytania (dodatki PostgreSQL)

Standardowe SELECT, WHERE i JOIN znajdziesz w SQL cheat sheet; tutaj są formy specyficzne dla PostgreSQL.

Co robiSQL
Dopasowanie bez rozróżniania wielkości literSELECT * FROM users WHERE name ILIKE 'a%';
Dopasowanie wyrażenia regularnegoSELECT * FROM users WHERE email ~ '@example\.com$';
Pierwszy wiersz w każdej grupieSELECT DISTINCT ON (user_id) user_id, amount FROM orders ORDER BY user_id, amount DESC;
Limit i przesunięcie (offset)SELECT * FROM users ORDER BY id LIMIT 10 OFFSET 20;
Standardowy limit wierszySELECT * FROM users ORDER BY id FETCH FIRST 5 ROWS ONLY;
Rzutowanie za pomocą ::SELECT '42'::integer + 1;
Wartość zastępcza dla NULLSELECT name, COALESCE(email, 'none') FROM users;
Porównanie traktujące NULL-e jako równeSELECT * FROM users WHERE email IS DISTINCT FROM 'asha@example.com';
Wygeneruj ciąg liczbSELECT * FROM generate_series(1, 5);
Agregacja do łańcucha znakówSELECT string_agg(name, ', ' ORDER BY name) FROM users;
Agregacja warunkowaSELECT count(*) FILTER (WHERE status = 'paid') AS paid, count(*) AS total FROM orders;

Wstawianie, aktualizacja, usuwanie i upsert

Co robiSQL
Wstaw wiersz i odbierz nowe idINSERT INTO users (name, email) VALUES ('Dana', 'dana@example.com') RETURNING id;
Wstaw kilka wierszyINSERT INTO users (name) VALUES ('Eli'), ('Femi');
Upsert (wstaw albo zaktualizuj)INSERT INTO users (name, email) VALUES ('Asha K', 'asha@example.com') ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name;
Wstaw, pomijając duplikatyINSERT INTO users (name, email) VALUES ('Ben', 'ben@example.com') ON CONFLICT DO NOTHING;
Zaktualizuj i zobacz zmienione wierszeUPDATE employees SET salary = salary * 1.1 WHERE department = 'IT' RETURNING name, salary;
Aktualizacja na podstawie innej tabeliUPDATE orders SET status = 'vip' FROM users WHERE orders.user_id = users.id AND users.country = 'IN';
Usuń i zobacz, co zostało usunięteDELETE FROM orders WHERE status = 'refunded' RETURNING id;
Usuwanie z użyciem innej tabeliDELETE FROM orders USING users WHERE orders.user_id = users.id AND users.active = false;
Skopiuj wiersze do nowej tabeliCREATE TABLE paid_orders AS SELECT * FROM orders WHERE status = 'paid';

JSONB

Co robiSQL
Pobierz pole jako JSONSELECT profile -> 'plan' FROM users;
Pobierz pole jako tekstSELECT profile ->> 'plan' FROM users;
Pobierz zagnieżdżone pole jako tekstSELECT profile #>> '{address,city}' FROM users;
Wiersze, których JSON zawiera wartośćSELECT * FROM users WHERE profile @> '{"plan": "pro"}';
Wiersze, które mają dany kluczSELECT * FROM users WHERE profile ? 'city';
Ustaw kluczUPDATE users SET profile = jsonb_set(profile, '{plan}', '"team"') WHERE id = 2;
Scal obiektyUPDATE users SET profile = profile || '{"beta": true}';
Usuń kluczUPDATE users SET profile = profile - 'city';
Zbuduj JSON z kolumnSELECT jsonb_build_object('id', id, 'name', name) FROM users;
Wiersze jako tablica JSONSELECT jsonb_agg(users) FROM users;
Indeks dla wyszukiwań @> i ?CREATE INDEX users_profile_idx ON users USING gin (profile);

Tablice

Co robiSQL
Literał tablicySELECT ARRAY[1, 2, 3];
Wiersze, w których tablica zawiera wartośćSELECT * FROM users WHERE 'sql' = ANY(tags);
Wiersze, w których tablica zawiera wszystkie wartościSELECT * FROM users WHERE tags @> ARRAY['sql', 'python'];
Jeden wiersz na elementSELECT name, unnest(tags) FROM users;
Dodaj element na końcuUPDATE users SET tags = array_append(tags, 'sql') WHERE id = 2;
Długość tablicySELECT name, cardinality(tags) FROM users;

Daty i czas

Co robiSQL
Teraz, ze strefą czasowąSELECT now();
DzisiajSELECT current_date;
Dodaj interwałSELECT current_date + INTERVAL '7 days';
Wiersze z ostatnich 30 dniSELECT * FROM orders WHERE created_at > now() - INTERVAL '30 days';
Obetnij do miesiącaSELECT date_trunc('month', created_at) AS month, sum(amount) FROM orders GROUP BY 1 ORDER BY 1;
Wyodrębnij część datySELECT EXTRACT(YEAR FROM hired_on) FROM employees;
Różnica między datami (w dniach)SELECT DATE '2026-12-25' - DATE '2026-11-17';
Wiek między datamiSELECT name, age(current_date, hired_on) FROM employees;
Sformatuj datę jako tekstSELECT to_char(hired_on, 'DD Mon YYYY') FROM employees;
Zamień tekst na datęSELECT to_date('17/11/2026', 'DD/MM/YYYY');
Przelicz na strefę czasowąSELECT now() AT TIME ZONE 'Asia/Kolkata';

Funkcje tekstowe

Co robiSQL
Łączenie (NULL daje NULL)SELECT name || ' <' || email || '>' FROM users;
Łączenie z pominięciem NULL-iSELECT concat_ws(' ', name, email) FROM users;
Wielkie i małe literySELECT upper(name), lower(name) FROM users;
DługośćSELECT name, length(name) FROM users;
Fragment łańcuchaSELECT substring(name FROM 1 FOR 2) FROM users;
Zamiana tekstuSELECT replace(email, '@example.com', '') FROM users;
Wydzielenie części po separatorzeSELECT split_part(email, '@', 2) FROM users;
Zamiana z wyrażeniem regularnymSELECT regexp_replace('a1b22c', '[0-9]+', '', 'g');
Usuń spacje z brzegówSELECT trim(' hi ');

CTE i funkcje okna

Co robiSQL
Nazwij podzapytanie za pomocą WITHWITH paid AS (SELECT user_id, sum(amount) AS total FROM orders WHERE status = 'paid' GROUP BY user_id) SELECT * FROM paid WHERE total > 50;
Rekurencyjne CTE (liczenie do 5)WITH RECURSIVE n(i) AS (SELECT 1 UNION ALL SELECT i + 1 FROM n WHERE i < 5) SELECT i FROM n;
Numeruj wiersze w każdej grupieSELECT name, department, ROW_NUMBER() OVER (PARTITION BY department ORDER BY salary DESC) FROM employees;
Ranking z remisamiSELECT name, DENSE_RANK() OVER (ORDER BY salary DESC) FROM employees;
Suma narastającaSELECT id, amount, sum(amount) OVER (ORDER BY id) FROM orders;
Wartość z poprzedniego wierszaSELECT name, salary, LAG(salary) OVER (ORDER BY hired_on) FROM employees;
Złącz każdy wiersz z jego własnym podzapytaniemSELECT u.name, o.amount FROM users u CROSS JOIN LATERAL (SELECT amount FROM orders WHERE user_id = u.id ORDER BY amount DESC LIMIT 1) o;

Indeksy

Co robiSQL
Indeks B-tree (domyślny)CREATE INDEX orders_user_idx ON orders (user_id);
Indeks unikalnyCREATE UNIQUE INDEX employees_name_idx ON employees (name);
Indeks wielokolumnowyCREATE INDEX orders_user_created_idx ON orders (user_id, created_at);
Indeks częściowyCREATE INDEX orders_paid_idx ON orders (created_at) WHERE status = 'paid';
Indeks na wyrażeniuCREATE INDEX users_lower_email_idx ON users (lower(email));
Indeks pokrywający (skany tylko z indeksu)CREATE INDEX orders_user_cover_idx ON orders (user_id) INCLUDE (amount);
Budowanie bez blokowania zapisówCREATE INDEX CONCURRENTLY orders_status_idx ON orders (status);
Usuń indeksDROP INDEX IF EXISTS orders_user_idx;
Zobacz planEXPLAIN SELECT * FROM orders WHERE user_id = 1;
Zobacz plan z rzeczywistymi czasamiEXPLAIN ANALYZE SELECT * FROM orders WHERE user_id = 1;

Transakcje i blokady

Co robiSQL
Rozpocznij, potem zatwierdź albo wycofajBEGIN; UPDATE employees SET salary = 0 WHERE id = 3; ROLLBACK;
Wycofaj część transakcjiBEGIN; INSERT INTO users (name) VALUES ('Gil'); SAVEPOINT s1; DELETE FROM users WHERE name = 'Gil'; ROLLBACK TO s1; COMMIT;
Ostrzejsza izolacjaBEGIN ISOLATION LEVEL SERIALIZABLE; SELECT count(*) FROM orders; COMMIT;
Zablokuj odczytywane wierszeBEGIN; SELECT * FROM orders WHERE id = 1 FOR UPDATE; COMMIT;
Kolejka zadań: pomiń zablokowane wierszeBEGIN; SELECT id FROM orders WHERE status = 'paid' ORDER BY id LIMIT 1 FOR UPDATE SKIP LOCKED; COMMIT;

Użytkownicy, role i uprawnienia

Co robiSQL
Utwórz rolę z możliwością logowaniaCREATE ROLE app LOGIN PASSWORD 'change-me';
Dostęp tylko do odczytu do tabeliGRANT SELECT ON users TO app;
Dostęp do odczytu do każdej tabeli w schemacieGRANT SELECT ON ALL TABLES IN SCHEMA public TO app;
Odbierz uprawnienieREVOKE SELECT ON users FROM app;
Zmień hasłoALTER ROLE app PASSWORD 'new-secret';
Pokaż bieżącego użytkownikaSELECT current_user;

Konserwacja i monitorowanie

Co robiSQL
Działające zapytaniaSELECT pid, state, query FROM pg_stat_activity WHERE state <> 'idle';
Anuluj zapytanieSELECT pg_cancel_backend(12345);
Zakończ połączenieSELECT pg_terminate_backend(12345);
Rozmiar tabeli razem z indeksamiSELECT pg_size_pretty(pg_total_relation_size('orders'));
Rozmiar bazy danychSELECT pg_size_pretty(pg_database_size(current_database()));
Zaktualizuj statystyki planeraANALYZE orders;
Odzyskaj martwe wierszeVACUUM orders;
Przepisz tabelę do minimalnego rozmiaru (blokuje ją)VACUUM FULL orders;
Pokaż ustawienieSHOW work_mem;
Zmień ustawienie dla tej sesjiSET work_mem = '64MB';

Kopia zapasowa i przywracanie

Polecenia powłoki z narzędzi klienckich PostgreSQL.

Co robiPolecenie
Zrzuć bazę danych do pliku SQLpg_dump -U postgres shop > shop.sql
Zrzut w formacie niestandardowym (custom)pg_dump -Fc -U postgres shop > shop.dump
Zrzuć jedną tabelępg_dump -t orders shop > orders.sql
Przywróć zrzut SQLpsql -d shop -f shop.sql
Przywróć zrzut w formacie custompg_restore -d shop shop.dump
Zrzuć wszystkie bazy danych i rolepg_dumpall > cluster.sql
Eksportuj zapytanie do CSV (z psql)\copy (SELECT * FROM orders) TO 'orders.csv' CSV HEADER
Importuj CSV (z psql)\copy orders (user_id, amount, status) FROM 'orders.csv' CSV HEADER

Wszystkie polecenia psql i instrukcje PostgreSQL, po które sięgasz, w tabelach do skopiowania: najpierw łączenie i polecenia \d, potem tabele, upsert, JSONB, daty, funkcje okna, indeksy, role, kopie zapasowe i konserwacja.

SQL na tej stronie to składnia PostgreSQL 17, a większość działa też we wcześniejszych wersjach. Instrukcje SQL sprawdzono na PostgreSQL 17; aby wypróbować którąś, wklej ją do edytora online PostgreSQL, który ma przykładowe tabele.

PostgreSQL cheat sheet: FAQ

Czym są polecenia psql?
psql to terminalowy klient PostgreSQL. Oprócz SQL rozumie metapolecenia zaczynające się od ukośnika wstecznego: \l wyświetla bazy danych, \c łączy się z jedną z nich, \dt wyświetla tabele, \d users opisuje tabelę, a \q kończy pracę. Działają w samym psql, więc nie potrzebują średnika i nie działają w innych klientach.
Jak wyświetlić wszystkie tabele w PostgreSQL?
W psql wpisz \dt (albo \dt *.* dla wszystkich schematów). W SQL, z dowolnego klienta: SELECT table_name FROM information_schema.tables WHERE table_schema = 'public';
Czy SQL w PostgreSQL różni się od MySQL?
Rdzeń (SELECT, JOIN, GROUP BY) jest taki sam. PostgreSQL dodaje ILIKE, rzutowanie ::, RETURNING, DISTINCT ON, upsert z ON CONFLICT, tablice i JSONB, a tam, gdzie MySQL używa AUTO_INCREMENT, stosuje kolumny identity.
Jaka jest różnica między JSON a JSONB?
json przechowuje tekst dokładnie tak, jak go zapisano; jsonb przechowuje przetworzoną postać binarną, usuwa zduplikowane klucze i białe znaki oraz obsługuje indeksy (GIN) i operatory takie jak @> i ?. Używaj jsonb, chyba że potrzebujesz dokładnego oryginalnego tekstu.
Czy mogę ćwiczyć te zapytania online?
Tak. Edytor online PostgreSQL uruchamia dowolne zapytanie na prawdziwej bazie danych PostgreSQL 17 w przeglądarce, z przykładowymi tabelami, które możesz edytować. Instrukcje wymagające uprawnień serwera, takie jak CREATE DATABASE czy CREATE ROLE, potrzebują twojego własnego PostgreSQL.
Czy ten PostgreSQL cheat sheet jest darmowy?

Tak. Możesz go za darmo czytać, kopiować i drukować, bez rejestracji.

Ilustracja języków programowania w Coddy

Naucz się języka PostgreSQL z Coddy

Zacznij