• Русский

      • UUID

      Введение

      В NocoBase UUID (UUID) используется для генерации уникального идентификатора UUID.

      UUID подходит для синхронизации между системами, идентификации в публичных API, импорта и экспорта. По сравнению с автоинкрементным ID он в меньшей степени раскрывает объём данных.

      Если нужен только первичный ключ по умолчанию для внутренних задач NocoBase, обычно достаточно Snowflake ID. Если нужен короткий идентификатор, выберите Nano ID илипоследовательность.

      Сценарии использования

      UUID подходит для следующих бизнес-сценариев:

      • Идентификатор синхронизации с внешней системой
      • Идентификатор публичного API
      • Идентификатор записи при миграции между базами данных
      • Идентификатор записи, не раскрывающий закономерность инкрементирования

      Создание конфигурации

      На странице «Configure fields» таблицы данных нажмите «Add field» и выберите «UUID», чтобы создать поле UUID.

      20240512173354

      КонфигурацияОписание
      Field interfaceТип интерфейса поля. Для UUID соответствует uuid и определяет способ ввода и отображения на странице.
      Field display nameНазвание поля, отображаемое в интерфейсе, например «UUID», «Внешний идентификатор» или «Публичный ID». Рекомендуется использовать название, понятное сотрудникам без дополнительных пояснений.
      Field nameИдентификатор поля, используемый для внутренних ссылок в API, полях связей, правах доступа, рабочих процессах и других компонентах. После создания обычно не изменяется; допускаются только буквы, цифры и символы подчёркивания, причём имя должно начинаться с буквы.
      Field typeТип поля на уровне данных. Для поля UUID по умолчанию используется uuid.
      Default valueЗначение по умолчанию. При создании записи оно может подставляться автоматически, если пользователь не ввёл значение.
      Validation rulesОбычно генерируются системой автоматически и не требуют ручной проверки.
      DescriptionОписание поля. Здесь можно указать смысл поля, требования к заполнению, источник данных или ответственного за обслуживание.
      Внимание

      После создания имя поля будет использоваться блоками страниц, правами доступа, рабочими процессами и API. Перед созданием проверьте название, чтобы избежать дополнительных затрат на изменение конфигурации в будущем.

      Свойства поля

      Поле UUID по умолчанию ведёт себя следующим образом:

      СвойствоОписание
      Field interface по умолчаниюuuid.
      Field type по умолчаниюuuid.
      Доступный Field typeuuid.
      Компонент страницыОбычно генерируется автоматически и не требует ручного ввода.
      ФильтрацияПоддерживается точный поиск по UUID.
      СортировкаСортировка поддерживается, но обычно UUID не используется для бизнес-сортировки.
      ПроверкаОбычно генерируется автоматически и обеспечивает уникальность.

      Редактирование конфигурации

      После создания нажмите «Edit» справа от поля, чтобы изменить конфигурацию поля UUID. Редактирование поля используется главным образом для настройки его отображения и применения в NocoBase, например для изменения отображаемого имени, описания, значения по умолчанию, правил проверки или специальных настроек поля.

      Если поле получено из таблицы, уже синхронизированной с основной базой данных, редактирование обычно означает сопоставление поля — преобразование поля базы данных в Field type и Field interface NocoBase.

      КонфигурацияМожно редактироватьОписание
      Field display nameДаИзменяет отображаемое в интерфейсе имя поля, но не меняет идентификатор поля.
      Field nameНетИдентификатор поля обычно нельзя изменить в форме редактирования после создания.
      Field interfaceПри определённых условияхДля полей основной базы данных или синхронизированных полей его можно изменить при сопоставлении полей. Изменение повлияет на способ ввода, отображения и проверки на страницах.
      Field typeПри определённых условияхДля полей основной базы данных или синхронизированных полей его можно изменить при сопоставлении полей. Перед изменением необходимо убедиться, что существующие данные можно использовать с новым типом.
      Default valueДаИзменяет значение по умолчанию для новых записей.
      Validation rulesДаИзменяет правила проверки поля.
      DescriptionДаДополняет информацию о смысле поля, требованиях к заполнению, источнике данных или ответственном за обслуживание.
      Внимание

      Переключение Field type или Field interface — это не просто изменение отображаемого имени. Оно влияет на способ хранения данных, компонент ввода, правила проверки, условия фильтрации и способ использования переменных в рабочих процессах. При большом количестве существующих данных сначала убедитесь, что их формат соответствует новому типу.

      Удаление поля

      Нажмите «Delete» справа от поля, чтобы удалить поле UUID. В основной базе данных также можно выбрать несколько полей и удалить их одновременно.

      При удалении созданного в основной базе данных поля UUID обычно одновременно удаляются настоящий столбец в базе данных и уже имеющиеся в этом столбце данные. При удалении поля, синхронизированного из базы данных или сопоставленного с внешним источником данных, область воздействия зависит от соответствующего источника данных и происхождения поля.

      Предупреждение

      Удаление поля может повлиять на блоки страниц, формы, фильтрацию, права доступа, рабочие процессы, API, импорт и экспорт, а также существующие данные. Перед удалением убедитесь, что поле больше не используется в бизнес-конфигурациях.

      Использование в конфигурации страниц

      Поле UUID подходит для интеграций и сценариев публичной идентификации. 20260710145759

      СценарийНазначение
      Создание таблицыИспользование в качестве первичного ключа или уникального идентификатора.
      APIИспользование в качестве публичного идентификатора записи.
      Синхронизация данныхСинхронизация записей между системами.
      Импорт и экспортСохранение уникальности записей.

      Ссылки по теме

      • Поля — сведения о назначении, категориях и логике сопоставления полей
      • Обычная таблица — создание и управление полями в обычной таблице
      • Snowflake ID — использование идентификатора Snowflake по умолчанию
      • Nano ID — использование короткого случайного идентификатора