pgd

PGD — pgDesigner формат и CLI

.pgd — git-friendly XML-формат pgDesigner для схем PostgreSQL. Полная спецификация: https://pgdesigner.io/docs/pgd-format (XSD: pgd-format.xsd).

CLI: pgdesigner (не pgd).

Non-obvious правила редактирования

• Без числовых ID — объекты по имени; кросс-схемно через schema.table
• <index> — на уровне <schema>, НЕ внутри <table> (частая ошибка при конверсии из PDD)
• Порядок элементов в <table> ломает диф: columns → pk → fk → unique → check → exclude → with → partition-by → partition
• Булевы — строки "true"/"false" (не "0"/"1" как в PDD)
• SQL всегда в CDATA — CHECK, WHERE, тела функций, generated-выражения, bound партиций
• nullable default "true" — для NOT NULL ставь явно nullable="false"
• Атрибуты на одной строке — иначе git-diff будет шумный

Корень

<?xml version="1.0" encoding="UTF-8"?>
<pgd version="1" pg-version="18" default-schema="public">

Иерархия

<pgd>
├── <project>/<settings>     naming, defaults, linting
├── <database>               имя, кодировка, коллация
├── <roles> <tablespaces> <extensions>
├── <types>                  enum, composite, domain, range
├── <sequences>
├── <schema>
│   ├── <table>
│   │   └── column, pk, fk, unique, check, exclude, with,
│   │       partition-by, partition
│   └── <index>              <-- на уровне schema!
├── <views> <functions> <triggers> <policies>
├── <comments> <grants> <rules>
└── <layouts>                позиции/цвета редактора

Канонические сниппеты

Enum (редактор восстанавливает порядок <label> — ручная перестановка не ломает):

<enum name="user_status" schema="public">
  <label>active</label>
  <label>inactive</label>
</enum>

FK (inline в <table>, в отличие от PDD):

<fk name="fk_orders_user" to-table="users" on-delete="cascade" on-update="no action">
  <column name="user_id" references="id"></column>
</fk>

Индекс по выражению / partial / covering:

<index name="idx_users_lower_email" table="users" using="btree">
  <expression><![CDATA[lower(email)]]></expression>
  <where><![CDATA[deleted_at IS NULL]]></where>
  <include><column name="name"></column></include>
</index>