Docs
⌘ K

2 минуты

Генератор кода безопасного субграфа

Subgraph Uncrashable⁠ — это инструмент генерации кода, который создает набор вспомогательных функций из схемы GraphQL проекта. Он гарантирует, что все взаимодействия с объектами в Вашем субграфе будут полностью безопасными и последовательными.

Зачем интегрироваться с Subgraph Uncrashable?

  • Непрерывная работоспособность: неправильная обработка объектов может привести к сбоям в работе субграфа, что может нарушить работу проектов, зависимых от The Graph. Настройте вспомогательные функции, чтобы сделать ваши субграфы “неподвластными сбоям” и обеспечить бесперебойную работу бизнеса.

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

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

Ключевые особенности

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

  • Фреймворк также включает в себя способ создания пользовательских, но безопасных функций установки для групп переменных объектов (через config-файл). Таким образом, пользователь не сможет загрузить/использовать устаревшую graph entity, и также не сможет забыть о сохранении или установке переменной, которая требуется функцией.

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

Subgraph Uncrashable можно запустить как необязательный флаг с помощью команды Graph CLI codegen.

graph codegen -u [options] [<subgraph-manifest>]

Ознакомьтесь с документацией по subgraph uncrashable⁠ или посмотрите это видеоруководство⁠, чтобы узнать больше и начать разрабатывать более безопасные субграфы.