Логічні назви

Таблиця й кожен її стовпець можуть мати, крім назви, ще й логічну назву. Логічна назва — та, яку читають люди, як-от Customer Name для CUST_NM. Сама назва — це фізична назва, яку записують схема SQL і генератор коду.
Відображення назв визначає, яку з двох назв показує полотно ERD: назви, логічні назви чи обидві — див. відображення назв.
Логічна назва також може дати своїй таблиці чи стовпцю фізичну назву, сформовану зі слів і термінів на вкладці словника, — див. формування фізичних назв.
Стовпець можна прив’язати до домену, тобто іменованого типу даних, як-от Name для VARCHAR(100), що зберігається на аркуші Domains вкладки словника, і тоді стовпець має тип даних цього домену — див. клітинка домену.
Схема SQL може записувати кожну логічну назву в порожній коментар — див. логічні назви як коментарі.

Відображення назв

Є три варіанти відображення назв, і кожен по-своєму показує заголовок і рядки таблиці:

• Варіант Physical Names, що діє в новій діаграмі, не показує логічних назв. Заголовок показує назву таблиці, а поки увімкнено View Option → Table Comment, ще й її коментар, і кожен рядок показує свої клітинки в порядку стовпців.
• Варіант Logical Names показує логічну назву на місці кожної назви: у заголовку та в кожному рядку там, де в порядку стовпців стоїть Name. Клітинка типу в рядку може представляти домен стовпця, як описано нижче.
• Варіант Both Names показує логічну назву поруч із назвою. Заголовок показує логічну назву, потім назву, потім коментар, а кожен рядок отримує клітинку Logical Name, яку порядок стовпців за замовчуванням розміщує безпосередньо перед Name.

На місці порожньої логічної назви, зокрема й такої, що складається лише з пробілів, показується приглушений замінник. У варіанті Logical Names це назва, показана на її місці, або заповнювач table чи column, коли назва теж порожня. У варіанті Both Names це заповнювач logical.

У варіанті Logical Names стовпець, прив’язаний до іменованого домену на аркуші Domains вкладки словника, показує в клітинці типу назву цього домену замість свого типу даних. Кожен інший стовпець показує там свій тип даних.
Поки увімкнено View Option → Domain, домен має окрему клітинку, а клітинка типу показує тип даних, тож жоден рядок не показує домен двічі — див. клітинка домену.

Ширина кожної таблиці відповідає клітинкам, які вона показує в поточному варіанті, тому перемикання змінює розміри таблиць і заново прокладає їхні лінії зв’язку. Жодна таблиця не переміщується.
За масштабу 70% і менше таблиця згортається до своєї назви — див. збільшення/зменшення масштабу. У варіанті Logical Names вона показує логічну назву або, поки логічної назви немає, приглушену назву. У варіанті Both Names вона показує логічну назву, а під нею в окремому рядку — назву, або лише назву, поки логічної назви немає.

Перевірки словника можуть показувати логічну назву чи назву червоним або бурштиновим кольором там, де вони її позначають, — див. позначки на полотні.

Перемикання відображення назв

Перемкнути варіант можна в чотирьох місцях, і кожне з них показує Physical Names, Logical Names і Both Names з галочкою біля варіанта, що діє:

• Кнопка Name View на панелі інструментів полотна, між чотирма нотаціями зв’язків і режимом дзен. Вона показує назву варіанта, що діє, зі стрілкою вниз, а її підказка — Name View. Клацання відкриває список над панеллю інструментів, а вибір варіанта його закриває.
• Пункт Name View у контекстному меню полотна, одразу після View Option: підменю з трьома варіантами. Після вибору меню залишається відкритим.
• Такий самий список на панелі інструментів вкладки візуалізації в режимі Flow, після меню відображення рядків — див. панель інструментів.
• Пункт Name View у швидкому пошуку, розміщений одразу після Tab і доступний лише на вкладці ERD. Його підменю відкривається з підсвіченим варіантом, що діє.

Усі чотири задають один і той самий варіант. На верхній панелі інструментів кнопки для нього немає.

Перемикання зберігає виділення й не записується в історію змін.
Якщо клітинку у фокусі новий варіант не показує, фокус переходить на клітинку, показану на її місці: назва й логічна назва заміняють одна одну, так само як тип і домен. Редактор клітинки, відкритий у цій клітинці, закривається. Увімкнення чи вимкнення View Option → Domain переносить фокус так само.
Поки блокування Name View увімкнено, як у новій діаграмі, перемикання змінює лише ваш власний екран, а у файлі зберігається варіант, який діяв на момент блокування. Коли блокування вимкнено, файл зберігає варіант, на який ви перемикаєтеся, — див. блокування.

Введення логічної назви

Варіант Physical Names не показує логічних назв, тому, щоб ввести логічну назву на полотні, перемкніться на варіант Logical Names або Both Names:

• У варіанті Logical Names клітинки назв у заголовку й рядках містять логічні назви, тому фізичну назву в цьому варіанті на полотні редагувати не можна.
• У варіанті Both Names клітинки логічних назв містять логічні назви, а клітинки назв — фізичні назви.

Клітинка логічної назви редагується так само, як будь-яка інша: почніть клавішею Enter або подвійним клацанням — див. редагування таблиць. Коли редактор клітинки відкривається для порожньої логічної назви, він показує як заповнювач те, що показувала клітинка: назву у варіанті Logical Names і logical у варіанті Both Names.
Введення тексту змінює лише логічну назву. Фізична назва формується з неї, коли редактор закривається (Enter, Tab, Escape або клацання деінде) після зміни логічної назви, і це окремий крок відміни після вашого введення. Фізична назва, яку ви задали самі, залишається без змін — див. формування фізичних назв.
Коли співавтор або агент для програмування замінює діаграму, поки клітинку логічної назви відкрито, редактор клітинки лишається відкритим, доки нова діаграма все ще має цю таблицю чи стовпець, а ваше відображення назв усе ще показує клітинку. Повторне завантаження діаграми в редактор, як це робить Obsidian, коли файл змінюється поза ним, одразу закриває редактор клітинки. У будь-якому разі закриття формує фізичну назву лише тоді, коли таблиця чи стовпець містить логічну назву, яку ви ввели, і ніколи з тієї, яку принесла нова діаграма.

Tab і Shift + Tab переходять між клітинками, які показує варіант, у їхньому порядку — див. клавіша Tab:

• У варіанті Logical Names — логічна назва в заголовку, потім коментар таблиці, потім клітинки кожного рядка в порядку стовпців, де логічна назва стоїть на місці назви.
• У варіанті Both Names — логічна назва, назва й коментар у заголовку, потім клітинки кожного рядка в порядку стовпців, де за замовчуванням першою йде клітинка Logical Name.

Alt + Enter (Windows/Linux) або ⌥ + Enter (Mac) додає стовпець і переводить фокус на першу клітинку, яку малює його рядок. За типового порядку стовпців це його клітинка назви, яка у варіанті Logical Names є його логічною назвою, а у варіанті Both Names — клітинка Logical Name, тож можна почати з логічної назви — див. додавання стовпців.

Стовпець зовнішнього ключа, який додає зв’язок, копіює логічну назву й домен свого ключа разом із його типом — див. ідентифікувальні зв’язки.
Копіювання стовпців в електронну таблицю й вставлення стовпців з неї використовують клітинки, які показує варіант, зокрема клітинки логічної назви й домену — див. копіювання/вставлення стовпців.

Доповнення назв термінів

Поки ви вводите текст у клітинку логічної назви, у заголовку чи в рядку, список під клітинкою пропонує терміни, назви яких починаються з цього тексту, без урахування регістру й пробілів перед ним. Термін — це ціла логічна назва, що зберігається на аркуші Terms вкладки словника разом із фізичною назвою та доменом, які вона дає. Список показує до восьми термінів, відсортованих за назвою, з підсвіченим введеним текстом. Поки жоден термін так не починається, списку немає.

• Спочатку нічого не підсвічено. ↑ і ↓ переміщують підсвічування, переходячи по колу на обох кінцях, а підсвічений термін показує клавішу Enter.
• Enter на підсвіченому терміні записує його назву як логічну назву й завершує редагування. Якщо фізичну назву ви не задавали самі, той самий крок відміни одразу формує фізичну назву з терміна, а стовпцю також дає домен терміна. Enter без підсвіченого терміна завершує редагування й зберігає введений текст.
• Клацання терміна записує його так само й залишає редактор відкритим.
• Escape, поки показано список, закриває лише список, а наступне натискання Escape завершує редагування.
• Tab переходить далі з текстом у тому вигляді, у якому його введено, а фізична назва формується з нього, коли редактор закривається.
• Поки метод введення складає символ, стрілки й Enter використовуються для складання символу.

Що термін дає таблиці чи стовпцю, описано в розділі формування фізичних назв.

Клітинка домену

Параметр View Option → Domain (за замовчуванням вимкнено) додає кожному рядку клітинку домену в кожному варіанті там, де в порядку стовпців стоїть Domain, за замовчуванням одразу після DataType — див. параметри відображення таблиць.
Клітинка показує назву домену, до якого прив’язано стовпець, або приглушений заповнювач domain для стовпця, не прив’язаного до жодного домену зі списку аркуша Domains.

Enter або подвійне клацання відкриває над клітинкою список вибору: порожнє поле з текстом клітинки як заповнювачем, а під ним None, потім кожен іменований домен аркуша Domains у порядку аркуша. Спочатку підсвічено прив’язаний домен або None.

• Введення тексту залишає в списку лише домени, назви яких містять цей текст, без урахування регістру, прибирає None і підсвічує перший домен. ↑ і ↓ переміщують підсвічування.
• Enter прив’язує стовпець до підсвіченого домену, а клацання — до того, який клацнули. І те, і те дає стовпцю тип даних домену одним кроком відміни й завершує редагування. None відв’язує стовпець від домену й зберігає його тип даних.
• Введений текст ніколи не записується в стовпець. Поки на аркуші Domains немає жодного іменованого домену, списку немає, а Enter завершує редагування, нічого не записуючи.

У варіанті Logical Names з вимкненим параметром View Option → Domain клітинка типу, яка показує назву домену, відкриває цей список вибору, а клітинка, яка показує тип даних, відкриває редактор типу даних — див. автодоповнення типів даних. Щоб прив’язати домен до стовпця, який не має домену, увімкніть клітинку домену.
Прив’язаний стовпець має тип даних свого домену й змінюється слідом за ним, коли змінюється тип домену, а введення іншого типу в його клітинку DataType відв’язує його від домену — див. домени й типи даних.

За межами полотна

Більшість інших місць, де показується назва таблиці чи стовпця, теж враховує відображення назв:

• Варіант Physical Names показує назву.
• Варіант Logical Names показує логічну назву або, поки логічна назва порожня, назву, приглушену там, де це місце може її приглушити.
• Варіант Both Names показує логічну назву, а після неї назву: приглушену в рядку тексту, у другому рядку підпису в режимі Graph і в дужках там, де обидві назви мають уміститися в одному тексті, як-от Member (member). Таблиця чи стовпець без логічної назви показує лише назву.

Список, відсортований за назвою, як-от таблиці в оглядачі чи рядки # у швидкому пошуку, залишається відсортованим за назвою в кожному варіанті й ніколи не сортується за логічною назвою.

Місця, які враховують варіант:

• На вкладці візуалізації — картки режиму Flow (див. назви на картках), а також підписи й попередній перегляд під час наведення в режимі Graph (див. як читати граф і попередній перегляд під час наведення).
• Вікно властивостей таблиці: його мітки, а на вкладці Indexes — рядки Columns і список Index order — див. індекси.
• Рядки таблиць і стовпців в оглядачі, а також таблиці, перелічені під кожною групою таблиць.
• Рядки # у швидкому пошуку — див. пошук у діаграмі.
• Дерево змін і обидві сторони перегляду відмінностей.
• Вікно зіставлення стовпців, а також підказка <parent> has no primary key to copy, яку може показувати кнопка Create new columns, поки малюється зв’язок, — див. створення зв’язків.
• Копія рядків, яку перетягування стовпця несе над порожнім полотном і яка показує клітинки назви й типу кожного рядка так, як їх показує рядок, — див. зміна порядку й переміщення стовпців.
• Стовпець Target аркуша Checks вкладки словника — див. аркуш перевірок.
• Експортоване зображення.

Кілька місць показують назви незалежно від варіанта: рядки індексів і зовнішніх ключів в оглядачі, Keys на вкладці Indexes вікна властивостей таблиці, New column: <name> у вікні зіставлення стовпців і розташування, указане поруч із рядком @ або : у швидкому пошуку.

Перегляд відмінностей, подорож у часі, попередній перегляд Force автоматичного розміщення і діалогове вікно Export image відкриваються у відображенні назв, яке ви бачите, незалежно від того, який варіант зберігає файл. Кожне з них зберігає цей варіант, поки воно відкрите.
Кожне автоматичне розміщення, а також Import або Import and Add зі схеми SQL, GraphQL, DBML чи AML розміщують таблиці з тією шириною, яку вони мають у вашому варіанті.

Пошук за логічною назвою

Логічні назви знаходяться в кожному варіанті відображення назв, зокрема й у варіанті Physical Names, де полотно їх не показує:

• Пошук і заміна шукає їх як один тип тексту, Logical names, однаково для таблиць і стовпців, і цей тип увімкнено, коли пошук відкривається вперше. Заміна логічної назви формує з неї фізичну назву так само, як і введення.
• У швидкому пошуку # знаходить таблицю за її назвою або логічною назвою, а @ знаходить стовпець за будь-якою з них, причому поруч зі збігом за логічною назвою показується Logical name. Частина @ для таблиці, перед ., теж збігається з назвою або логічною назвою таблиці.

Перемикання відображення назв змінює те, як названо результати, але ніколи не змінює того, що знайдено.

Співавтори

У сеансі спільного редагування логічні назви й прив’язки до доменів доходять до кожного редактора, як і будь-яка інша зміна.
Поки блокування Name View увімкнено, кожен редактор має власний варіант, і перемикання видно лише в редакторі, де його зроблено. Поки блокування вимкнено, перемикання в будь-якому редакторі, що не перебуває в режимі лише для читання, перемикає всі редактори — див. блокування, де також описано, як увімкнення чи вимкнення блокування впливає на варіант у кожному редакторі.
Коли клітинку у фокусі учасника ваш варіант не показує, його колір з’являється на клітинці, яку ваш варіант показує на її місці: клітинка назви у варіанті Physical Names з’являється на вашій клітинці логічної назви у варіанті Logical Names і навпаки, а клітинка типу й домен, показаний замість неї, зіставляються так само.

Агент для програмування, що працює через MCP-сервер, задає логічні назви й прив’язує домени незалежно від варіанта, який ви бачите, і не має інструмента для перемикання відображення назв — див. словники і налаштування.

Режим лише для читання

У редакторі з атрибутом readonly працює кожен список вибору варіанта відображення назв: кнопка Name View на панелі інструментів полотна, Name View у контекстному меню полотна й у швидкому пошуку та список на панелі інструментів режиму Flow.
Перемикання там змінює лише цей екран незалежно від блокування: файл, співавтори й історія змін зберігають відображення таким, яким воно було. Щойно редактор знову стає доступним для запису, вибране відображення залишається на цьому екрані до наступного перемикання тут або, поки блокування вимкнено, доки його не перемкне співавтор чи документ не завантажать знову.
Логічні назви й домени там редагувати не можна, тому не відкривається ні редактор клітинки, ні список термінів, ні список вибору домену, а пункти Derive Physical Name Again і Derive Physical Names Again не пропонуються.
Параметр View Option → Domain показує або ховає клітинку домену лише на цьому екрані, як і кожен параметр відображення там, а коли редактор знову стає доступним для запису, повертаються параметри відображення, які містить документ.