Начало редактирования

Редактирование начинается с контекстного меню, которое открывается щелчком правой кнопкой мыши.

Щелчок правой кнопкой мыши по таблице, заметке, группе таблиц или связи вместо этого открывает собственное меню этого элемента.
Щелчок правой кнопкой мыши по уже выделенной таблице, заметке или группе таблиц сохраняет все выделение, поэтому такие пункты, как Color и Delete selected, действуют на все выделенное — см. Множественное выделение.

Экран приветствия

В веб-приложении, Google Drive, VS Code, Obsidian и IDE JetBrains пустая диаграмма открывается с экраном приветствия поверх холста ERD. Элемент <erd-editor> на вашей собственной странице показывает этот экран, только если страница включает его с помощью свойства enableWelcomeScreen.
Диаграмма считается пустой, пока в ней нет ни одной таблицы, ни одной отображаемой заметки и ни одной отображаемой группы таблиц, поэтому заметки и группы, скрытые в Параметрах вида, не учитываются. Экран исчезает, как только в диаграмме появляется любой из этих элементов, и возвращается всякий раз, когда диаграмма снова становится пустой, например после удаления последней таблицы или отмены добавления первой.
Он не отображается в редакторе только для чтения, в режиме дзен, пока открыто окно «Свойства таблицы» или пока холст занимают просмотр различий, предварительный просмотр Автоматического размещения или путешествие во времени.

Под заголовком Right-click the canvas for every action. находится меню:

• Пункт New Table добавляет таблицу, как и Alt + N.
• Пункт New Memo добавляет заметку, как и Alt + M. Пока заметки скрыты, он не отображается.
• Пункт Import заменяет меню пунктом Back и форматами json, Schema SQL, GraphQL, DBML и AML. При выборе формата запрашивается файл этого формата, и он загружается вместо пустой диаграммы — см. Импорт и экспорт файлов. Пункт Back или клавиша Escape возвращает к первому меню.
• Пункт Command Palette открывает Быстрый поиск, как и Ctrl + K (Windows/Linux) или ⌘ + K (Mac).
• Пункт Shortcuts открывает Настройки на вкладке Shortcuts.

Если холст достаточно широк, пункты New Table, New Memo и Command Palette показывают сочетание клавиш, которое сейчас привязано к их команде, в том числе переназначенное хостом.
Когда фокус клавиатуры находится на пункте меню, клавиши ↑ и ↓ перемещают его по пунктам по кругу, Home и End переходят к первому и последнему пункту, а Enter или Space нажимает пункт в фокусе. Все остальные сочетания клавиш по-прежнему работают, поэтому Alt + N и здесь добавляет таблицу.
Щелчки принимает только меню: нажатие в любом другом месте экрана доходит до холста, а щелчок правой кнопкой мыши по холсту, как обычно, открывает контекстное меню.

Если на холсте есть место, нарисованные от руки стрелки указывают на:

• кнопку Search на панели инструментов: Search commands and tables
• кнопки Theme и Display Language: Pick a theme and a language либо Pick a theme или Pick a language, если на панели инструментов отображается только одна из них, — см. Язык и тема
• панель инструментов холста внизу: Pan, zoom and draw relationships

Пока отображается Обозреватель, экран приветствия перекрывает только холст рядом с ним.
Стрелка, кнопка которой на панели инструментов находится над Обозревателем, не отображается. Стрелка к кнопкам Theme и Display Language не отображается только тогда, когда обе ее кнопки находятся над Обозревателем; до тех пор она указывает на ту из них, которая еще находится над холстом.
Подпись, которой не хватает места рядом со своей стрелкой, вместо этого располагается под стрелкой.

Создание таблицы

Создайте таблицу через контекстное меню, с помощью кнопки New Table на панели инструментов холста или сочетанием клавиш Alt + N.

Создание заметки

Создайте заметку через контекстное меню, с помощью кнопки New Memo на панели инструментов холста или сочетанием клавиш Alt + M.
Пока View Option → Memos выключен, заметки скрыты, пункт New Memo нигде не предлагается, а Alt + M не добавляет заметку — см. Параметры вида таблиц.

Заметка — это произвольная текстовая запись на холсте. Щелкните внутри заметки и введите текст; текст сохраняется вместе с документом.
Клавиша Escape закрывает поле редактирования заметки, сохраняя введенный текст и оставляя заметку выделенной, а повторное нажатие Escape снимает выделение.
Чтобы изменить размер заметки, перетащите ее границу. Кнопка x в ее заголовке, которая отображается, пока указатель находится над заметкой, удаляет заметку.
Щелчок правой кнопкой мыши по заметке открывает не поле редактирования, а ее меню: Color, Remove color, пока у выделенного элемента есть цвет, и Delete, который называется Delete selected, пока заметка входит в число двух или более выделенных элементов. Выделенная заметка также удаляется клавишами, которыми удаляются таблицы, — см. Удаление таблиц и заметок.

Создание группы таблиц

Группа таблиц — это рамка, которая вмещает таблицы, и ей можно задать имя и цвет. Создайте ее одним из двух способов:

• Выберите New Table Group в контекстном меню или в Быстром поиске, нажмите кнопку New Table Group на панели инструментов холста либо нажмите Alt + G (Windows/Linux) или ⌥ + G (Mac), затем нарисуйте рамку на холсте перетаскиванием. Каждая таблица, центр которой находится внутри рамки, попадает в новую группу, если только она уже не входит в другую группу, — см. Рисование группы.
• Выделите таблицы и выберите Group selected tables в контекстном меню таблицы или Group Selected Tables в Быстром поиске либо нажмите T, затем G — см. Группировка выделенных таблиц.

Задание имени и цвета, перемещение, изменение размера и все остальное описаны в разделе Группы таблиц.

Создание связи

Начните создание связи через контекстное меню, с панели инструментов холста внизу холста или с помощью сочетания клавиш. У каждого типа связи свое сочетание:

• Zero One: Ctrl + Alt + 1 (Windows/Linux) или ⌘ + ⌥ + 1 (Mac)
• Zero N: Ctrl + Alt + 2 (Windows/Linux) или ⌘ + ⌥ + 2 (Mac)
• One Only: Ctrl + Alt + 3 (Windows/Linux) или ⌘ + ⌥ + 3 (Mac)
• One N: Ctrl + Alt + 4 (Windows/Linux) или ⌘ + ⌥ + 4 (Mac)

Когда тип связи активирован, курсор меняется. Щелкните сначала родительскую таблицу, затем дочернюю.
Родительская таблица получает первичный ключ, если у нее его нет, а для каждого столбца первичного ключа родительской таблицы дочерняя таблица получает столбец внешнего ключа с флагом Not Null и тем же типом данных, значением по умолчанию и комментарием.
Исключение составляет ключ типа serial: его внешний ключ получает целочисленный тип, который хранит serial, например integer для serial4 — см. Идентифицирующие связи.
Каждый столбец внешнего ключа получает имя по своему ключу: к имени из одного слова, например id, спереди добавляется имя родительской таблицы (user_id), имя из нескольких слов, например member_id, сохраняется, а имя, которое уже есть в дочерней таблице, получает номер (user_id_2) — см. Имена столбцов внешнего ключа.
Если щелкнуть одну и ту же таблицу два раза, рисуется рекурсивная связь.
У новой связи оба параметра, On Delete и On Update, изначально имеют значение Not set; измените их в контекстном меню связи — см. ON DELETE и ON UPDATE.
Чтобы отменить рисование, нажмите Escape или еще раз нажмите то же сочетание клавиш. Отмена рисования оставляет выделение как есть, а следующее нажатие Escape снимает его.

Если после выбора родительской таблицы навести указатель на таблицу, на которой может закончиться связь, эта таблица обводится контуром и рядом с ней появляются две кнопки:

• Кнопка Create new columns (+) рисует связь с новыми столбцами внешнего ключа, как и щелчок по таблице.
• Кнопка Map to existing columns (значок ссылки) завершает рисование и открывает окно «Сопоставить столбцы» для этих двух таблиц, чтобы связь могла использовать столбцы, которые уже есть в дочерней таблице. Пока вы не нажмете кнопку Map, ничего не записывается.

Родительская таблица тоже показывает эти кнопки, как только указатель немного сместится от места, где вы по ней щелкнули, поэтому рекурсивную связь также можно сопоставить с существующими столбцами.
У пальца нет наведения, поэтому при рисовании пальцем кнопки не появляются вовсе, а касание дочерней таблицы сразу рисует связь; перо показывает их так же, как мышь.
Если к тому моменту, когда вы доходите до дочерней таблицы, родительская таблица лишилась первичного ключа, например из-за отмены или правки соавтора, кнопка Create new columns отображается приглушенной со всплывающей подсказкой <parent> has no primary key to copy, а щелчок по дочерней таблице завершает рисование, и ничего не рисуется.

Дублирование таблиц и заметок

Существующие таблицы и заметки можно дублировать копированием и вставкой, а также перетаскиванием с зажатой клавишей Alt — см. Работа с таблицами.