Какие назначение у макросов `@Attribute` и `@Relationship` в SwiftData, и чем они отличаются в своей функциональности?

Overview

В SwiftData (iOS 17+) @Attribute и @Relationship — это макросы, которые используются для настройки того, как свойства модели сохраняются и связываются. Они заменяют визуальный редактор моделей Core Data декларативным Swift кодом.

@Attribute

Макрос @Attribute контролирует, как отдельное свойство хранится в базе данных. Основные опции:

• .unique — запрещает дублирование значений во всех экземплярах
• .ephemeral — полностью исключает свойство из сохранения
• .encrypted — хранит значение в защищённом виде

@Relationship

Макрос @Relationship определяет связи между типами моделей. Он контролирует:

• Правила удаления — например, .cascade (автоматически удаляет связанные объекты) или .deny (запрещает удаление, если есть связанные объекты)
• Обратные связи — ссылка обратно на владеющую модель для поддержания согласованности

Ключевые отличия

• @Attribute работает со скалярными свойствами и value-типами (строки, числа и т. д.)
• @Relationship работает со свойствами-моделями (ссылками на другие классы @Model)
• @Attribute настраивает поведение при хранении; @Relationship настраивает целостность графа и навигацию по нему

Резюме

Оба макроса привносят в SwiftData типобезопасную конфигурацию моделей прямо в коде, устраняя необходимость в отдельном файле .xcdatamodeld. Используй @Attribute для тонкой настройки хранения отдельных значений и @Relationship для управления тем, как модели связаны и влияют друг на друга.