Граф связей
функциональныйИнтерактивная ER-диаграмма таблиц базы данных и внешних ключей.
Интерактивная ER-диаграмма для базы данных: одна карточка на таблицу, одна стрелка на внешний ключ. Стрелка всегда указывает на ссылочную таблицу, так что цепочка стрелок читается как цепочка зависимостей. Откройте её из контекстного меню базы данных, пункт «Инструменты» (Tools).
Она читает каталог напрямую, без этапа моделирования, ничего не нужно синхронизировать. На экране отображается то, что база данных считает своими внешними ключами прямо сейчас, и Обновить повторно считывает их.
Выбор того, что отображается на канвасе
- Таблицы - это Таблицы панель с Все / Нет / Связанные через FK кнопки и список флажков по таблицам. По умолчанию вид начинается с самых связанных таблиц, так что схема из 600 таблиц открывается диаграммой, а не клубком; самостоятельный выбор таблиц снимает этот предел и может включать таблицы вообще без связей.
- Фильтр - введите в поле фильтра для затемнения всего, что не соответствует
schema.tableне совпадает. Несовпавшие таблицы остаются на месте, выделенные серым, поэтому вы сохраняете форму диаграммы, пока ищете в ней нужное. - Фокус - если открыта из таблицы, диаграмма показывает эту таблицу и её ближайших соседей. Показать все возвращает остальное.
Что отображает каждая карточка
Четыре переключателя задают уровень детализации, каждый независимо:
| Переключить | Показывает |
|---|---|
| Столбцы | Каждый столбец таблицы в порядке следования (ordinal). Столбцы, участвующие во внешнем ключе, выделены. Размер карточек подгоняется под весь список — ничего не обрезается. |
| Типы | Тип данных каждого столбца, прижатый к правому краю карточки, чтобы он не мешал даже длинному имени столбца. |
| Пустые значения (NULL) | NULL или NOT NULL для каждого столбца. Столбец, чью допустимость NULL движок не сообщил, ничего не говорит, вместо того чтобы угадывать. |
| FK (Внешние ключи) | Сами стрелки связей. Если выключить, останутся только карточки таблиц. |
«Типы» и «NULL» описывают строки столбцов, поэтому применяются, только когда включены «Столбцы». Когда столбцы показаны, стрелка крепится к точном столбце с каждой стороны вместо края коробки.
Компоновка
- Макет - Сетка является детерминированным порядком по строкам; Наложено размещает ссылаемые таблицы по одну сторону от ссылающихся на них — так иерархия читается лучше.
- Ширина - кнопки − и + изменяют размер всех карточек таблиц, и макет распределяется соответственно, так что расширение карточек не приводит к их перекрытию. Полезно, когда имена столбцов или типы данных длинные.
- Тянуть карточку, чтобы разместить её вручную; перетащенные карточки сохраняют своё положение при изменении макета. Сбросить макет возвращает всё на место.
- Масштабирование и панорамирование - прокручивайте для панорамирования, ⌘-прокрутка (Ctrl-прокрутка на Windows и Linux) или щипком для масштабирования от 25% до 300%, Подогнать чтобы охватить всю диаграмму, а кнопка с процентом возвращает на 100%.
- Вынести в окно диаграмму в отдельное окно с настраиваемым размером, сохранив текущее выделение и расположение, — когда диаграмма нужна рядом с редактором, а не поверх него.
- Нажмите на таблицу чтобы показать его в дереве схемы.
Экспорт
Всё в разделе Экспорт экспортирует что перед вами, текущий выбор таблицы, текущая компоновка, включая любые перетаскиваемые вами карточки, и текущие переключатели столбцов/типов/допустимости NULL. Каждый формат можно скопировать в буфер обмена или сохранить в файл.
| Формат | Что вы получаете | Подходит для |
|---|---|---|
| SVG | Диаграмма ровно в том виде, как нарисована, — прямоугольники, стрелки, позиции и цвета текущей темы — как векторное изображение. | Вставка в документ, вики или слайд в любом размере. |
| Mermaid | Вот erDiagram блок: одна сущность на таблицу с её ключевыми столбцами, одна линия связи на каждое ограничение. | Markdown, который отображает сам себя - GitHub, GitLab и большинство вики нативно рисуют Mermaid, и он остаётся удобным для диффов при ревью. |
| DBML | A Table блок на таблицу с её ключевыми столбцами, плюс Ref на связь. | Подача схемы в инструменты, читающие DBML, и хранение текстового первоисточника модели в системе контроля версий. |
Mermaid и DBML описывают связи, а не полную схему: они содержат таблицы и столбцы, участвующие в ключах. Для полного, исполняемого DDL используйте Скрипт как CREATE ниже.
Скрипт как CREATE
Скрипт как CREATE в панели инструментов превращает таблицы в текущем обзоре в один исполняемый скрипт и открывает его в новой вкладке редактора для проверки. «В обзоре» — это ровно то, что показывает холст: таблицы, которые вы выбрали в Таблицы панели, или выделенная таблица и её соседи, пока активен фокус. Ничего не выполняется.
Вкладка привязана к соединению и базе данных самой диаграммы, даже если вы переключите рабочую область на другое подключение, пока скрипт строится. Кнопка подписана Генерация скрипта… во время выполнения, так что один клик открывает одну вкладку.
- Порядок зависимостей - таблицы, на которые ссылаются, создаются раньше ссылающихся, поэтому скрипт выполняется сверху вниз на пустой базе данных — при условии, что любая таблица за пределами выбранного набора, на которую ссылается выбранная таблица, уже там существует. Каждая такая ссылка помечается предупреждением.
- Циклы - когда внешние ключи образуют цикл (A ссылается на B, а B на A), все таблицы всё равно создаются, а каждый внешний ключ, который указывал бы на ещё не созданную таблицу, переносится в
ALTER TABLE … ADD CONSTRAINTпосле каждойCREATE TABLE. Ссылки таблицы на саму себя остаются на месте. - Предупреждения - всё, что стоит проверить, указывается как
-- WARNINGстроки вверху: цикл зависимостей, ссылочное действие, которое движок не принимает, значение по умолчанию, требующее существования последовательности, ссылку на таблицу вне выбранного набора, сбой чтения каталога (например, ограничений CHECK или описаний) или таблицу, метаданные которой вообще не удалось прочитать. Нечитаемая таблица записывается как-- SKIPPEDстроку вместо обрыва скрипта, а внешние ключи, которые на неё указывают, записываются в конце закомментированными, чтобы остаток скрипта всё равно выполнялся.
Что содержит скрипт каждого движка
| Движок | Включено | Не включено |
|---|---|---|
| SQL Server / Azure SQL | Построено по каталогу: типы столбцов, допустимость NULL, именованные значения по умолчанию, идентификация с реальными начальным значением и шагом, вычисляемые столбцы (PERSISTED сохраняются), параметры сортировки столбцов, отличающиеся от параметров сортировки базы данных по умолчанию, первичный ключ, ограничения CHECK, индексы, внешние ключи с их ссылочными действиями, файловая группа таблицы (ON и TEXTIMAGE_ON), ROW или PAGE сжатие данных таблицы и каждого индекса, а также описания таблицы и столбцов. | Триггеры и разрешения. Индексы columnstore скриптуются как обычные индексы, а индекс, чьи разделы используют разное сжатие, скриптуется без него. Темпоральные таблицы с системным версионированием, секционированные таблицы, таблицы, оптимизированные для памяти, и таблицы с кластеризованным индексом columnstore скриптуются как обычные таблицы, и предупреждение в начале скрипта указывает, что было исключено. |
| PostgreSQL (и CockroachDB) | Построено по каталогу: типы столбцов в том виде, как их печатает сам PostgreSQL (массивы, перечисления, домены, длины), идентификационные столбцы (ALWAYS или BY DEFAULT), сгенерированные столбцы, значения по умолчанию, первичный ключ, ограничения CHECK, индексы, внешние ключи и описания. serial столбец записывается как BY DEFAULT столбец идентичности, потому что его последовательность не является частью скрипта. | Последовательности, секционирование, триггеры, безопасность на уровне строк, владельцы и параметры хранения. |
| MySQL / MariaDB | Родной для сервера SHOW CREATE TABLE текст, воспроизведённый как написано: точные типы столбцов, наборы символов и сопоставления, сгенерированные столбцы, ON UPDATE, ограничения CHECK, индексы, параметры таблицы и комментарии. Активный AUTO_INCREMENT= счётчик сбрасывается, поэтому копия начинается с 1, а внешний ключ, ссылающийся на ещё не созданную таблицу, переносится в ALTER TABLE … ADD. | Триггеры и права. Если SHOW CREATE TABLE не удаётся для таблицы, она собирается заново из каталога без наборов символов, сопоставлений, ограничений CHECK и табличных опций, и об этом говорится в предупреждении. |
| База данных Oracle | Построено по каталогу: типы столбцов с точностью и длиной (NUMBER(p,s), RAW(n)), длины символов с указанной семантикой (VARCHAR2(10 CHAR) или VARCHAR2(10 BYTE)), INTEGER столбцы как INTEGER, столбцы identity, виртуальные столбцы, значения по умолчанию, первичный ключ, ограничения CHECK, индексы, внешние ключи (Oracle принимает только ON DELETE CASCADE и SET NULL), и описания. | Предложения хранения, табличные пространства, партиционирование, параметры сортировки столбцов и триггеры. |
| SQLite, libSQL, DuckDB, ClickHouse | Собственный хранимый движком CREATE текст, воспроизведённый в порядке зависимостей, за которым следуют индексы таблицы для SQLite, libSQL и DuckDB. Это сохраняет такие конструкции движка, как ClickHouse ENGINE и у SQLite WITHOUT ROWID. | Триггеры и все остальное, что движок хранит вне собственного определения таблицы. |
Это скрипт из живой базы данных, а не из визуального редактора моделей: диаграмма остаётся только для чтения, а внешний ключ к таблице за пределами выбранного набора сохраняется как написано, так что эта таблица должна существовать везде, где вы запускаете скрипт. Прорисовка новых таблиц и связей на канве — дело будущего.



