112 najczęstszych pytań i problemów związanych z PostgreSQL

Zebraliśmy w jednym miejscu 112 najczęstszych pytań i problemów, na które trafiają administratorzy i programiści pracujący z PostgreSQL - od instalacji, połączeń i konfiguracji, przez uprawnienia, VACUUM, blokady i WAL, po backup, replikację, wysoką dostępność i tuning. Każdy wpis to konkretny problem z wyjaśnieniem przyczyny i rozwiązaniem krok po kroku. Kliknij grupę poniżej albo przewiń listę.

Chcesz przejść przez to od podstaw? Zajrzyj do naszego bezpłatnego kursu administracji PostgreSQL - każdy problem z tej listy odsyła do właściwej lekcji.

Instalacja i uruchomienie klastra

• PostgreSQL nie startuje po instalacji - od czego zacząć diagnozę
• Klaster PostgreSQL nie uruchamia się - jak czytać komunikat pg_ctl
• Port 5432 jest zajęty - jak uruchomić PostgreSQL na innym porcie
• Jak poprawnie zatrzymać i zrestartować klaster PostgreSQL
• PostgreSQL nie wstaje po nagłym wyłączeniu serwera - recovery
• PostgreSQL na Red Hat, Rocky lub Alma nie startuje po instalacji - brak initdb
• Gdzie są katalogi i pliki klastra PostgreSQL (PGDATA)
• Jak zmienić port nasłuchu klastra PostgreSQL

Połączenia i dostęp

• Nie mogę połączyć się z PostgreSQL - connection refused
• Błąd: no pg_hba.conf entry for host - jak skonfigurować dostęp
• PostgreSQL nie przyjmuje połączeń z sieci - listen_addresses
• FATAL: password authentication failed - jak naprawić
• Too many connections - jak zwiększyć limit i po co pooling
• Jak połączyć się z bazą przez pgAdmin4 krok po kroku
• peer authentication failed - logowanie lokalne przez psql
• Jak skonfigurować PgBouncer, gdy brakuje połączeń

Konfiguracja serwera

• Zmiana parametru w postgresql.conf nie działa - reload czy restart
• Na których poziomach ustawiać parametry PostgreSQL (klaster, baza, sesja)
• Jak sprawdzić aktualną wartość parametru i skąd pochodzi
• Jak skonfigurować logi serwera PostgreSQL (co i gdzie logować)
• Jak bezpiecznie zmienić shared_buffers i work_mem
• PostgreSQL nie czyta zmian z pliku konfiguracyjnego - który plik jest aktywny

Użytkownicy, role i uprawnienia

• permission denied for table - jak nadać właściwe uprawnienia
• permission denied for schema public - zmiany w PostgreSQL 15
• Jak utworzyć użytkownika i nadać mu prawa w PostgreSQL
• Role grupowe - jak zarządzać uprawnieniami zbiorczo
• Jak ustawić i zmienić hasło administratora i użytkowników
• Nowy użytkownik nie widzi tabel - domyślne uprawnienia (default privileges)
• Jak odebrać uprawnienia i usunąć rolę, która jest właścicielem obiektów

Zobacz też: Szkolenie Administracja, replikacja i tuning baz danych PostgreSQL

Bazy, schematy i przestrzenie tabel

• Zapytanie nie widzi tabeli - jak działa search_path
• Jak utworzyć bazę i sklonować istniejącą (template)
• Jak przenieść dane na inny dysk - przestrzenie tabel (tablespace)
• Nie mogę usunąć bazy - database is being accessed by other users
• Jak sprawdzić rozmiar bazy, tabeli i indeksów
• Po co są schematy i jak je organizować w PostgreSQL

VACUUM, autovacuum i bloat

• Tabela puchnie mimo usuwania wierszy - czym jest bloat
• Autovacuum nie nadąża - jak go dostroić
• Ostrzeżenie o transaction ID wraparound - jak zareagować
• VACUUM vs VACUUM FULL - czym się różnią i kiedy który
• Jak sprawdzić, które tabele wymagają VACUUM i ANALYZE
• Statystyki są nieaktualne - kiedy uruchomić ANALYZE
• UPDATE produkuje bloat mimo autovacuum - HOT update i fillfactor
• VACUUM FULL blokuje tabelę na godziny - jak odzyskać miejsce online przez pg_repack
• Autovacuum blokuje wydajność w godzinach szczytu - jak go okiełznać

Blokady, sesje i transakcje

• Zapytanie wisi zablokowane - jak znaleźć blokującą sesję
• deadlock detected - jak zdiagnozować i uniknąć zakleszczeń
• idle in transaction blokuje bazę - jak temu zaradzić
• Jak awaryjnie rozłączyć sesję (pg_terminate_backend)
• Jak anulować długie zapytanie bez ubijania sesji (pg_cancel_backend)
• Jak podejrzeć aktywne zapytania i blokady w pg_stat_activity
• could not serialize access due to concurrent update - błąd poziomu izolacji transakcji
• Transakcja się nie kończy - zapomniany COMMIT/ROLLBACK

WAL, checkpointy i miejsce na dysku

• Katalog pg_wal rośnie i zapełnia dysk - dlaczego i co zrobić
• Dysk pełny - PostgreSQL przestał przyjmować zapisy
• checkpoints are occurring too frequently - jak dostroić
• Nieużywany slot replikacji trzyma WAL - jak to wykryć
• Jak bezpiecznie odzyskać miejsce zajęte przez pg_wal
• Po co jest WAL i jak działają checkpointy

Backup logiczny

• Jak zrobić i odtworzyć backup bazy przez pg_dump
• pg_dump vs pg_dumpall - co wybrać i czym się różnią
• Odtwarzanie z pg_dump się wywala - kolejność i zależności
• Jak backupować tylko wybrane tabele lub schemat
• Backup trwa zbyt długo - format custom i równoległość
• Role i uprawnienia nie wróciły po odtworzeniu - pg_dumpall --globals

Backup fizyczny i PITR

• Jak zrobić gorący backup fizyczny (pg_basebackup)
• Point-in-time recovery - jak odtworzyć bazę do konkretnej chwili
• Jak skonfigurować ciągłą archiwizację WAL (archive_command)
• Zimny backup i przenoszenie klastra na inny serwer
• pgBackRest - backup i odtwarzanie klasy enterprise
• Barman - centralny backup i recovery dla PostgreSQL
• Kopie przyrostowe i różnicowe w PostgreSQL - jak je robić
• pgBackRest w klastrze Patroni przestaje robić backup po przełączeniu primary

Replikacja fizyczna i streaming

• Standby nie nadąża za primary - jak zmierzyć i zmniejszyć lag
• Jak zbudować replikację strumieniową hot-standby krok po kroku
• Replika przestała się synchronizować - jak wznowić replikację
• Rodzaje replikacji w PostgreSQL - którą wybrać
• Sloty replikacji - kiedy ich używać i jak nie zapełnić dysku
• Ktoś usunął dane na produkcji, a replika od razu to powtórzyła - opóźniona replika (recovery_min_apply_delay)
• canceling statement due to conflict with recovery - długie zapytania na replice są przerywane
• wal-shipping i warm standby - kiedy zamiast streamingu

Replikacja logiczna

• Replikacja logiczna nie przenosi zmian - publication i subscription
• Konflikt w replikacji logicznej - jak go rozwiązać
• Replikacja fizyczna czy logiczna - kiedy która
• Jak zmigrować bazę między wersjami przez replikację logiczną
• Częste problemy z replikacją i jak je diagnozować
• Po failoverze replikacja logiczna przestaje działać - slot logiczny został na starym primary

Failover i wysoka dostępność (Patroni)

• Jak zapewnić automatyczny failover w PostgreSQL (Patroni)
• Split-brain w klastrze HA - jak do niego nie dopuścić
• Patroni z etcd - najczęstsze błędy konfiguracji
• Jak ręcznie przełączyć rolę primary (switchover) w Patroni
• Stary primary po failoverze nie wraca jako replika - pg_rewind i oś czasu (timeline)
• cannot execute INSERT in a read-only transaction - aplikacja trafia na replikę
• Po awarii primary aplikacja nie widzi nowego mastera - VIP i HAProxy
• Jak zarządzać klastrem Patroni na co dzień (patronictl)

Wydajność i tuning

• Zapytania są wolne - od czego zacząć tuning w PostgreSQL
• Jak czytać plan zapytania (EXPLAIN ANALYZE)
• PostgreSQL nie używa indeksu - dlaczego i jak to naprawić
• Jak dobrać shared_buffers, work_mem i effective_cache_size
• Zbyt wolny start - pg_prewarm i rozgrzewanie cache
• Które indeksy są nieużywane i jak je znaleźć
• Sekwencyjne skanowanie dużej tabeli - kiedy to problem

Monitoring i diagnostyka

• Co się dzieje w bazie teraz - pg_stat_activity w praktyce
• Jak włączyć i czytać pg_stat_statements (najcięższe zapytania)
• Jak śledzić użytkowników i zmiany na obiektach (pg_audit)
• Które zapytania zapisać w logu (log_min_duration_statement)
• Brak historii obciążenia bazy - jak monitorować PostgreSQL w Percona PMM
• pg_stat_statements nie pokazuje rozkładu czasów zapytań - kiedy sięgnąć po pg_stat_monitor

Upgrade, rozszerzenia i narzędzia

• Jak zaktualizować klaster PostgreSQL do nowej wersji (pg_upgrade)
• psql - podstawowe narzędzie administratora, które warto znać
• Jak zaplanować zadania cykliczne w bazie (pg_cron)
• Jak odpytać tabele w innej bazie (dblink i postgres_fdw)
• ERROR: could not load library - jak zainstalować rozszerzenie