postgis-skill

Skill dedykowany pracy z PostGIS — rozszerzeniem PostgreSQL do obsługi danych geoprzestrzennych. Zawiera praktyczne wskazówki, typowe pułapki i konwencje kodowania, które pomogą Ci pisać wydajne i czytelne zapytania SQL do operacji na geometrii i geografii. Dowiesz się, jak prawidłowo indeksować dane przestrzenne, debugować błędy, strukturyzować migracje i unikać częstych błędów przy pracy z rastrem i wektorami.

1. Zainstaluj PostGIS jako rozszerzenie PostgreSQL — uruchom CREATE EXTENSION postgis; w bazie danych, którą chcesz używać do pracy z danymi geoprzestrzennymi.

2. Przed pisaniem zapytań sprawdź wersję i status instalacji za pomocą SELECT postgis_full_version(); — upewnij się, że wszystkie komponenty są zainstalowane i zaktualizowane.

3. Przy tworzeniu tabel z danymi przestrzennymi stosuj konwencje: kolumnę geometryczną nazwij geom, a kolumnę geograficzną geog. Dodaj indeksy BRIN dla dużych tabel przeznaczonych do ad-hoc zapytań, a dla tabel cache z kluczem głównym rozważ użycie klauzuli including w indeksie.

4. Pisz kod SQL małymi literami, chyba że instrukcja mówi inaczej. Funkcje PostGIS zapisuj zgodnie z oficjalnym manuelem (np. ST_Segmentize z dużymi literami). Każde CREATE lub CTE opatrz komentarzem -- wyjaśniającym jego cel.

5. Przy debugowaniu upewnij się, że komunikaty błędów są zrozumiałe dla programisty — nie używaj fallbacków typu lat/lon=0, zamiast tego obsługuj brak danych w reszcie kodu i poinformuj użytkownika. Migracje SQL pisz idempotentnie (drop if exists + create as) i zawsze twórz pary up/down dla łatwości iteracji.

6. Przy pracy z rasterami importuj dane bezpośrednio do bazy zamiast operować na systemie plików przez GDAL — zarządzaj wszystkim wewnątrz PostgreSQL.