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 robi | Polecenie |
|---|
| 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 robi | Polecenie |
|---|
| Połącz się z bazą danych jako użytkownik | psql -U postgres -d shop |
| Połącz się ze zdalnym hostem i portem | psql -h db.example.com -p 5432 -U app -d shop |
| Połącz się za pomocą adresu URL połączenia | psql postgresql://app:secret@localhost:5432/shop |
| Uruchom jedno zapytanie i zakończ | psql -d shop -c "SELECT count(*) FROM users;" |
| Uruchom plik SQL | psql -d shop -f setup.sql |
| Utwórz bazę danych z powłoki | createdb shop |
| Usuń bazę danych z powłoki | dropdb shop |
Bazy danych i schematy
| Co robi | SQL |
|---|
| Utwórz bazę danych | CREATE DATABASE shop; |
| Usuń bazę danych | DROP DATABASE shop; |
| Pokaż bieżącą bazę danych | SELECT current_database(); |
| Utwórz schemat | CREATE SCHEMA sales; |
| Pokaż kolejność wyszukiwania schematów | SHOW search_path; |
| Szukaj najpierw w danym schemacie | SET search_path TO sales, public; |
| Pokaż wersję serwera | SELECT version(); |
Tabele i typy danych
| Co robi | SQL |
|---|
| Utwórz tabelę z kluczem identity | CREATE 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ę kolumny | ALTER TABLE users RENAME COLUMN country TO country_code; |
| Zmień typ kolumny | ALTER 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 identity | TRUNCATE orders, users RESTART IDENTITY; |
| Usuń tabelę, jeśli istnieje | DROP TABLE IF EXISTS products; |
| Dokładna liczba dziesiętna dla kwot | numeric(10,2) |
| Data i czas ze strefą czasową | timestamptz |
| Losowy UUID | SELECT gen_random_uuid(); |
| Typ wyliczeniowy (enum) | CREATE TYPE mood AS ENUM ('happy', 'sad'); |
Ograniczenia i klucze
| Co robi | SQL |
|---|
| Dodaj klucz główny | ALTER TABLE logs ADD PRIMARY KEY (id); |
| Klucz obcy, który usuwa wiersze podrzędne | CREATE 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ń ograniczenie | ALTER 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 robi | SQL |
|---|
| Dopasowanie bez rozróżniania wielkości liter | SELECT * FROM users WHERE name ILIKE 'a%'; |
| Dopasowanie wyrażenia regularnego | SELECT * FROM users WHERE email ~ '@example\.com$'; |
| Pierwszy wiersz w każdej grupie | SELECT 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 wierszy | SELECT * FROM users ORDER BY id FETCH FIRST 5 ROWS ONLY; |
| Rzutowanie za pomocą :: | SELECT '42'::integer + 1; |
| Wartość zastępcza dla NULL | SELECT name, COALESCE(email, 'none') FROM users; |
| Porównanie traktujące NULL-e jako równe | SELECT * FROM users WHERE email IS DISTINCT FROM 'asha@example.com'; |
| Wygeneruj ciąg liczb | SELECT * FROM generate_series(1, 5); |
| Agregacja do łańcucha znaków | SELECT string_agg(name, ', ' ORDER BY name) FROM users; |
| Agregacja warunkowa | SELECT count(*) FILTER (WHERE status = 'paid') AS paid, count(*) AS total FROM orders; |
Wstawianie, aktualizacja, usuwanie i upsert
| Co robi | SQL |
|---|
| Wstaw wiersz i odbierz nowe id | INSERT INTO users (name, email) VALUES ('Dana', 'dana@example.com') RETURNING id; |
| Wstaw kilka wierszy | INSERT 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 duplikaty | INSERT INTO users (name, email) VALUES ('Ben', 'ben@example.com') ON CONFLICT DO NOTHING; |
| Zaktualizuj i zobacz zmienione wiersze | UPDATE employees SET salary = salary * 1.1 WHERE department = 'IT' RETURNING name, salary; |
| Aktualizacja na podstawie innej tabeli | UPDATE orders SET status = 'vip' FROM users WHERE orders.user_id = users.id AND users.country = 'IN'; |
| Usuń i zobacz, co zostało usunięte | DELETE FROM orders WHERE status = 'refunded' RETURNING id; |
| Usuwanie z użyciem innej tabeli | DELETE FROM orders USING users WHERE orders.user_id = users.id AND users.active = false; |
| Skopiuj wiersze do nowej tabeli | CREATE TABLE paid_orders AS SELECT * FROM orders WHERE status = 'paid'; |
JSONB
| Co robi | SQL |
|---|
| Pobierz pole jako JSON | SELECT profile -> 'plan' FROM users; |
| Pobierz pole jako tekst | SELECT profile ->> 'plan' FROM users; |
| Pobierz zagnieżdżone pole jako tekst | SELECT profile #>> '{address,city}' FROM users; |
| Wiersze, których JSON zawiera wartość | SELECT * FROM users WHERE profile @> '{"plan": "pro"}'; |
| Wiersze, które mają dany klucz | SELECT * FROM users WHERE profile ? 'city'; |
| Ustaw klucz | UPDATE users SET profile = jsonb_set(profile, '{plan}', '"team"') WHERE id = 2; |
| Scal obiekty | UPDATE users SET profile = profile || '{"beta": true}'; |
| Usuń klucz | UPDATE users SET profile = profile - 'city'; |
| Zbuduj JSON z kolumn | SELECT jsonb_build_object('id', id, 'name', name) FROM users; |
| Wiersze jako tablica JSON | SELECT jsonb_agg(users) FROM users; |
| Indeks dla wyszukiwań @> i ? | CREATE INDEX users_profile_idx ON users USING gin (profile); |
Tablice
| Co robi | SQL |
|---|
| Literał tablicy | SELECT 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ści | SELECT * FROM users WHERE tags @> ARRAY['sql', 'python']; |
| Jeden wiersz na element | SELECT name, unnest(tags) FROM users; |
| Dodaj element na końcu | UPDATE users SET tags = array_append(tags, 'sql') WHERE id = 2; |
| Długość tablicy | SELECT name, cardinality(tags) FROM users; |
Daty i czas
| Co robi | SQL |
|---|
| Teraz, ze strefą czasową | SELECT now(); |
| Dzisiaj | SELECT current_date; |
| Dodaj interwał | SELECT current_date + INTERVAL '7 days'; |
| Wiersze z ostatnich 30 dni | SELECT * FROM orders WHERE created_at > now() - INTERVAL '30 days'; |
| Obetnij do miesiąca | SELECT date_trunc('month', created_at) AS month, sum(amount) FROM orders GROUP BY 1 ORDER BY 1; |
| Wyodrębnij część daty | SELECT 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 datami | SELECT name, age(current_date, hired_on) FROM employees; |
| Sformatuj datę jako tekst | SELECT 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 robi | SQL |
|---|
| Łączenie (NULL daje NULL) | SELECT name || ' <' || email || '>' FROM users; |
| Łączenie z pominięciem NULL-i | SELECT concat_ws(' ', name, email) FROM users; |
| Wielkie i małe litery | SELECT upper(name), lower(name) FROM users; |
| Długość | SELECT name, length(name) FROM users; |
| Fragment łańcucha | SELECT substring(name FROM 1 FOR 2) FROM users; |
| Zamiana tekstu | SELECT replace(email, '@example.com', '') FROM users; |
| Wydzielenie części po separatorze | SELECT split_part(email, '@', 2) FROM users; |
| Zamiana z wyrażeniem regularnym | SELECT regexp_replace('a1b22c', '[0-9]+', '', 'g'); |
| Usuń spacje z brzegów | SELECT trim(' hi '); |
CTE i funkcje okna
| Co robi | SQL |
|---|
| Nazwij podzapytanie za pomocą WITH | WITH 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 grupie | SELECT name, department, ROW_NUMBER() OVER (PARTITION BY department ORDER BY salary DESC) FROM employees; |
| Ranking z remisami | SELECT name, DENSE_RANK() OVER (ORDER BY salary DESC) FROM employees; |
| Suma narastająca | SELECT id, amount, sum(amount) OVER (ORDER BY id) FROM orders; |
| Wartość z poprzedniego wiersza | SELECT name, salary, LAG(salary) OVER (ORDER BY hired_on) FROM employees; |
| Złącz każdy wiersz z jego własnym podzapytaniem | SELECT 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 robi | SQL |
|---|
| Indeks B-tree (domyślny) | CREATE INDEX orders_user_idx ON orders (user_id); |
| Indeks unikalny | CREATE UNIQUE INDEX employees_name_idx ON employees (name); |
| Indeks wielokolumnowy | CREATE INDEX orders_user_created_idx ON orders (user_id, created_at); |
| Indeks częściowy | CREATE INDEX orders_paid_idx ON orders (created_at) WHERE status = 'paid'; |
| Indeks na wyrażeniu | CREATE 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ów | CREATE INDEX CONCURRENTLY orders_status_idx ON orders (status); |
| Usuń indeks | DROP INDEX IF EXISTS orders_user_idx; |
| Zobacz plan | EXPLAIN SELECT * FROM orders WHERE user_id = 1; |
| Zobacz plan z rzeczywistymi czasami | EXPLAIN ANALYZE SELECT * FROM orders WHERE user_id = 1; |
Transakcje i blokady
| Co robi | SQL |
|---|
| Rozpocznij, potem zatwierdź albo wycofaj | BEGIN; UPDATE employees SET salary = 0 WHERE id = 3; ROLLBACK; |
| Wycofaj część transakcji | BEGIN; INSERT INTO users (name) VALUES ('Gil'); SAVEPOINT s1; DELETE FROM users WHERE name = 'Gil'; ROLLBACK TO s1; COMMIT; |
| Ostrzejsza izolacja | BEGIN ISOLATION LEVEL SERIALIZABLE; SELECT count(*) FROM orders; COMMIT; |
| Zablokuj odczytywane wiersze | BEGIN; SELECT * FROM orders WHERE id = 1 FOR UPDATE; COMMIT; |
| Kolejka zadań: pomiń zablokowane wiersze | BEGIN; SELECT id FROM orders WHERE status = 'paid' ORDER BY id LIMIT 1 FOR UPDATE SKIP LOCKED; COMMIT; |
Użytkownicy, role i uprawnienia
| Co robi | SQL |
|---|
| Utwórz rolę z możliwością logowania | CREATE ROLE app LOGIN PASSWORD 'change-me'; |
| Dostęp tylko do odczytu do tabeli | GRANT SELECT ON users TO app; |
| Dostęp do odczytu do każdej tabeli w schemacie | GRANT SELECT ON ALL TABLES IN SCHEMA public TO app; |
| Odbierz uprawnienie | REVOKE SELECT ON users FROM app; |
| Zmień hasło | ALTER ROLE app PASSWORD 'new-secret'; |
| Pokaż bieżącego użytkownika | SELECT current_user; |
Konserwacja i monitorowanie
| Co robi | SQL |
|---|
| Działające zapytania | SELECT pid, state, query FROM pg_stat_activity WHERE state <> 'idle'; |
| Anuluj zapytanie | SELECT pg_cancel_backend(12345); |
| Zakończ połączenie | SELECT pg_terminate_backend(12345); |
| Rozmiar tabeli razem z indeksami | SELECT pg_size_pretty(pg_total_relation_size('orders')); |
| Rozmiar bazy danych | SELECT pg_size_pretty(pg_database_size(current_database())); |
| Zaktualizuj statystyki planera | ANALYZE orders; |
| Odzyskaj martwe wiersze | VACUUM orders; |
| Przepisz tabelę do minimalnego rozmiaru (blokuje ją) | VACUUM FULL orders; |
| Pokaż ustawienie | SHOW work_mem; |
| Zmień ustawienie dla tej sesji | SET work_mem = '64MB'; |
Kopia zapasowa i przywracanie
Polecenia powłoki z narzędzi klienckich PostgreSQL.
| Co robi | Polecenie |
|---|
| Zrzuć bazę danych do pliku SQL | pg_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 SQL | psql -d shop -f shop.sql |
| Przywróć zrzut w formacie custom | pg_restore -d shop shop.dump |
| Zrzuć wszystkie bazy danych i role | pg_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.