Поделиться через


Часто задаваемые вопросы о построителе API данных

Получите ответы на часто задаваемые вопросы о построителе API данных для баз данных Azure.

General

Что такое построитель API данных?

Построитель API данных для баз данных Azure предоставляет современные конечные точки REST и GraphQL для баз данных Azure.

Как установить CLI Data API Builder?

С помощью .NET CLI можно установить Data API builder CLI. Дополнительные сведения см. в руководстве по установке.

Несколько мутаций

Что такое поддержка нескольких мутаций в GraphQL?

Поддержка нескольких мутаций для GraphQL позволяет выполнять несколько мутаций в одном запросе. Сегодня поддержка ограничена созданием операций.

Каковы текущие ограничения на использование нескольких мутаций с GraphQL?

Текущие ограничения на использование нескольких мутаций с GraphQL:

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

Как авторизация работает с множеством мутаций в GraphQL?

Авторизация для нескольких мутаций в GraphQL обрабатывается аналогично отдельным мутациям. Все сущности, участвующие в операции множественной мутации, должны быть настроены для поддержки одной и той же роли из запроса. Например, если операция множественного изменения создаёт как сущность Книга, так и Издатель, обе сущности должны иметь одну и ту же проверенную роль.

Дополнительные сведения об авторизации см. в руководстве по авторизации.

Поддерживают ли несколько мутаций в GraphQL атомарное поведение?

Да, множество мутаций GraphQL поддерживают атомарные свойства. Если какая-либо из мутаций в операции многократной мутации завершается сбоем, вся операция отменяется. Если все мутации успешно выполнены, вся транзакция фиксируется.

Как использовать несколько мутаций в GraphQL?

Чтобы использовать несколько мутаций в GraphQL, ознакомьтесь с руководством "Использование нескольких мутаций в GraphQL".

Как работает безопасность на уровне строк с несколькими мутациями в GraphQL?

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

Дополнительные сведения о безопасности на уровне строк см. в статье о реализации безопасности на уровне строк в SQL.