26 октября опубликованы пакеты DBML 11.0.0. В журнале изменений выпуск отмечен как несовместимое обновление: пользовательские свойства получили типизированные значения. DBML служит для описания структуры базы данных в читаемом текстовом виде. На Mentoring.digital поясняем, почему изменение важно прежде всего авторам обработчиков схем.
Что изменилось в пользовательских свойствах
Помимо строк и цветов, пользовательские свойства теперь принимают логические и числовые значения. В изменениях парсера есть проверки для true, чисел со знаком и дробных чисел. Например, свойство pii: true может служить собственной пометкой команды в описании таблицы или колонки.
Такая пометка сама по себе не включает защиту данных, не меняет права в СУБД и не исполняет правило обработки информации. Это данные о схеме, смысл и применение которых определяет ваш инструмент.
Почему интеграция может потребовать правок
Меняется и представление свойства в результате разбора. В тестах проекта прежнее значение вида owner: 'scott' заменено структурой с полями value и type: значение scott и тип string. Обработчик, который ожидает обычную строку прямо по ключу owner, необходимо пересмотреть.
Несовместимое изменение перечислено для dbml-cli, dbml-connector, dbml-core и dbml-parse. Это не новая версия SQL и не обновление самой базы. Речь идёт об инструментах описания схем и данных, которые получают программы при их разборе.
Что проверить перед обновлением пакетов
- Найдите в интеграции обращения к metadata и собственным свойствам таблиц, колонок и групп.
- Сохраните несколько небольших схем с реальными видами значений, включая пустую строку и false, если они нужны вашему процессу.
- Сравните результат разбора до и после обновления: тип, значение и дальнейшее отображение в документации.
- Проверьте генерацию отчётов и экспорта отдельно от успешного запуска CLI. Отсутствие ошибки разбора ещё не подтверждает правильное использование метаданных.
Если вы только изучаете моделирование данных, сначала полезно разделить таблицы, связи и ограничения базы от собственных пояснений к схеме. Эту границу можно обсудить с наставником по SQL на небольшой модели вашего проекта.
