Перейти к основному содержимому

Федерация GraphQL-сервисов

Федерация GraphQL-сервисов (также unitedstoragedata) позволяет построить единый шлюз для обращения к нескольким сервисам как внутренними, так и внешним, одновременно.

Для обращения к сервису доступа к хранилищу данных следует использовать Endpoint сервиса: [url стенда]/services/unitedstoragedata/graphql.

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

Для сервисов самостоятельно реализующих протокол GraphQL, сервис доступа к данным предоставляет возможность доступа пользователей к схеме и данным через единую точку доступа. Следует принять во внимание что:

  • Разработчик Продукта самостоятельно определяет состав сервисов для включения в Федерацию GraphQL-сервисов.
  • Перечень платформенных сервисов для включения в Федерацию GraphQL-сервисов задается в сервисе публикации конфигурационнных файлов.
  • Перечень внешних сервисов задается администратором самостоятельно.
  • Администратор настраивает параметры подключения к внешним сервисам на стендах при развертывании продуктов.

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

Чтобы включить сервисы в Федерацию GraphQL-сервисов, необходимо разработать и опубликовать модель федерации, на этапе разработки Продуктов необходимо выполнить следующие действия:

  • создать файл с расширением .mdfed, например system_federation.mdfed в системном проекте;
  • открыть редактор модели федерации;
  • сформировать новую модель, либо получить текущую опубликованную модель, нажав кнопку Загрузить, и отредактировать её;
  • опубликовать проект;
  • включить в состав инсталляции Платформы сформированную и опубликованную модель после окончания разработки Продуктов.
к сведению

В составе сервиса федерации GraphQL-сервисов может одновременно использоваться только один файл с разрешением .mdfed.