Документация / DBML

Таблицы

Определение таблицы

Таблица объявляется ключевым словом Table: необязательный префикс схемы, имя таблицы и список столбцов.

Table table_name {
  column_name column_type [column_settings]
}

Table schema_name.table_name {
  column_name column_type [column_settings]
}

Правила:

  • имя типа, содержащее пробелы, берётся в двойные кавычки: "double precision";
  • сложные типы вроде decimal(1,2) записываются как есть;
  • имена столбцов — обычным текстом или в двойных кавычках: "quoted name";
  • настройки указываются в квадратных скобках [];
  • строковые значения — в одинарных кавычках: 'string'.

Псевдоним таблицы

Таблице можно задать псевдоним и использовать его в связях:

Table very_long_user_table as U {
  ...
}

Ref: U.id < posts.user_id

Настройки таблицы

Настройки таблицы указываются в квадратных скобках после имени:

  • headercolor: <цвет> — цвет заголовка таблицы на диаграмме (см. Заметки и оформление);
  • note: 'строка' — заметка к таблице.
Table users [headercolor: #3498DB, note: 'Пользователи системы'] {
  id integer [primary key]
  username varchar(255) [not null, unique]
}

Обновлено: 27 сентября 2026 г.