postgresql-syntax-reference

Umiejętność dostępu do gramatyki PostgreSQL (gram.y) i reguł parsera. Używaj jej podczas generowania DDL, walidacji składni SQL, rozumienia precedencji słów kluczowych i implementacji zaawansowanych konstrukcji takich jak triggery, indeksy, kolumny generowane czy ograniczenia. Zawiera lokalne kopie plików Yacc/Bison oraz Flex lexera — możesz wyszukiwać reguły gramatyki dla każdego typu instrukcji SQL (CREATE TABLE, ALTER TABLE, CREATE TRIGGER, CREATE FUNCTION, CREATE VIEW, CREATE SEQUENCE, CREATE TYPE, CREATE POLICY) i poznawać ich podstruktury oraz opcjonalne elementy.

1. Zainstaluj umiejętność w swoim środowisku Claude/Copilot, wskazując ścieżkę do repozytorium pgschema i katalogu .claude/skills/postgres_syntax. 2. Gdy pracujesz nad generowaniem DDL w kodzie (np. internal/diff/.go), wyzwij umiejętność pytaniem o konkretną instrukcję SQL — na przykład "Jaka jest struktura CreateTrigStmt w gramatyce PostgreSQL?" lub "Jakie są opcjonalne elementy TriggerWhen?". 3. Umiejętność przeszukuje lokalny plik internal/gram.y za pomocą grep lub bezpośredniego odczytu, aby znaleźć regułę gramatyki odpowiadającą Twojemu zapytaniu. 4. Zapoznaj się z tabelą Statement Types → Grammar Rules w README, aby szybko zlokalizować nazwę reguły dla instrukcji, którą chcesz zrozumieć. 5. Gdy potrzebujesz szczegółów dotyczących podstruktury (np. jakie są alternatywne opcje dla CREATE INDEX), pytaj o konkretne pod-reguły — umiejętność wyjaśni notację Yacc/Bison (UPPERCASE dla tokenów, lowercase dla reguł, | dla alternatyw, opt_ dla elementów opcjonalnych). 6. Używaj wyników do walidacji składni SQL w swoim kodzie lub do zrozumienia, jak PostgreSQL obsługuje zaawansowane konstrukcje takie jak triggery warunkowe, indeksy wyrażeń czy polityki bezpieczeństwa na poziomie wierszy.