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

Zebraliśmy w jednym miejscu 100 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
• 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

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
• 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
• 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ć

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
• 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ć

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
• 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)

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

Sprawdź szkolenie: Administracja, replikacja i tuning baz danych PostgreSQL

To szkolenie może być dofinansowane z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5

Sprawdź szkolenie: Zaawansowana administracja PostgreSQL (HA, DR, monitoring, skalowanie)

To szkolenie może być dofinansowane z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5