Стабильные идентификаторы

Стабильные идентификаторы — это внешне стабильный уникальный идентификатор данного объекта. Они позволяют потребителям данных согласовывать объекты в канале Common Data Format (CDF) с другими репозиториями данных. На языке баз данных внешние идентификаторы — это форма внешнего ключа, который позволяет потребителям данных связывать объекты в канале CDF с другими базами данных.

Например, если кандидатом является «Роберт Брэйди», потребитель данных может не сразу связать этого человека с «Бобом Брэйди» в своей базе данных изображений. Однако данные CDF и база данных изображений могут указывать на то, что этот человек является законодателем 01469, как указано в базе данных THOMAS Библиотеки Конгресса. Затем потребитель данных может связать изображение с кандидатом.

Для всех стабильных идентификаторов должны выполняться следующие условия:

  • Стабильность. Стабильный идентификатор для данного уникального объекта, такого как Person или Party , не должен меняться в разных версиях канала данных. Другими словами, стабильный идентификатор не должен меняться со временем для конкретной сущности.
  • Уникальность. Никогда не используйте повторно стабильный идентификатор для другого объекта, даже если исходный объект больше не присутствует в фиде.
  • Согласованность: при необходимости вы должны использовать один и тот же набор стабильных идентификаторов для кандидатов, партий или округов как для моделирования, так и во время избирательного цикла.

Форматирование данных

Укажите стабильные идентификаторы в следующем формате:

<ExternalIdentifier>
  <Type>other</Type>
  <OtherType>stable</OtherType>
  <Value>match the regex ^[a-zA-Z0-9_-]+$</Value>
</ExternalIdentifier>

Хорошими примерами стабильных идентификаторов являются универсальные уникальные идентификаторы (UUID) и глобальные уникальные идентификаторы (GUID). Они будут выглядеть так:

e55b7dd4-cc98-11ec-9d64-0242ac120002

Чтобы улучшить читаемость данных, лучше добавить дополнительные префиксы и суффиксы для дальнейшего разделения объектов. Например, добавьте префикс per- к лицам или off- , поскольку стабильные идентификаторы не должны соответствовать каким-либо стандартам.

Рекомендуется: per-e55b7dd4-cc98-11ec-9d64-0242ac120002.

Рекомендуется: off-7849514a-e8bc-11ec-8fea-0242ac120002.

Рекомендуется: per-123456789012345

Не рекомендуется: за Джона Доу

  • Риск: другой человек с таким же именем может иметь тот же идентификатор.
  • Риск: изменение данных может повлиять на стабильный идентификатор.

Не рекомендуется: не президент США

Где использовать стабильные идентификаторы

Стабильные идентификаторы обязательны для следующих элементов: