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

Доступность компонентов для построителя API данных

В этих таблицах перечислены функции, доступные в построителе API данных (DAB).

Версия базы данных

Database Abbreviation Мин. Версия
SQL Server MSSQL Версия 2016
База данных SQL Azure MSSQL N/A (PaaS)
Управляемый экземпляр SQL Azure MSSQL N/A (PaaS)
SQL Server на виртуальных машинах Azure MSSQL Версия 2016
SQL Server с поддержкой Arc MSSQL Версия 2016
База данных SQL в Fabric MSSQL N/A (PaaS)
Azure Cosmos DB для NoSQL COSMOSDB N/A (PaaS)
PostgreSQL PGSQL Версия 11
Гибкий сервер Базы данных Azure для PostgreSQL PGSQL Версия 11
MySQL MySQL Версия 8
Azure Database for MySQL — гибкий сервер MySQL Версия 5.7
Azure Synapse Analytics (выделенный пул SQL) DWSQLNO N/A (PaaS)

Уровни изоляции транзакций по умолчанию

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

Тип базы данных Уровень изоляции Дополнительные сведения
Microsoft SQL Read Committed (чтение зафиксированных данных) Azure SQL
PostgreSQL Read Committed (чтение зафиксированных данных) PostgreSQL
MySQL Повторяющаяся операция чтения MySQL

Облачные среды и среды размещения

Построитель API данных выполняется в любой среде с поддержкой контейнеров. Ниже приведены распространенные целевые показатели облачного развертывания:

Окружающая среда Поддерживается
Microsoft Azure ✅ Да
Amazon Web Services (AWS) ✅ Да
Google Cloud Platform (GCP) ✅ Да
Любой другой поставщик облачных служб ✅ Да
On-premises ✅ Да

GraphQL

Feature MSSQL Космос PGSQL MySQL DWSQLNO
Pagination ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Throttling ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Фильтрация ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Агрегация ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✅ Да
Сортировки ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Выбор ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Тип запроса ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Тип мутации ✅ Да ⚠️ Частично ✅ Да ✅ Да ✅ Да
Multi-Mutation ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
Advanced GroupBy ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✅ Да
Дополнительное наличие ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✅ Да
Создание схемы ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Атрибут схемы (@model) ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
Атрибут схемы (@authorize) ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
Предоставленная пользователем схема ✖️ Нет ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет
Subscription ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
Нитро ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Заголовки кэша ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Кэш уровня 1: память ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Кэш уровня 2: Redis ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да

Навигация по связям GraphQL

Feature MSSQL Космос PGSQL MySQL DWSQLNO
One-To-Many / Query ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Один-To-Many / мутация ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✅ Да
МногиеTo-Many / запрос ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Многие-To-Many / мутация ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✅ Да
Связи между источниками ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
Соединения между источниками ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет

REST

Feature MSSQL Cosmos² PGSQL MySQL DWSQLNO
PUT ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
POST ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
PATCH ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
DELETE ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
GET ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Pagination ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
OData-like $Select ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
OData-like $Filter ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
OData-like $Count ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
OData-like $OrderBy ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
OData-like $First ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
$After (разбиение курсора) ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Документ OpenAPI ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Пользовательский интерфейс Swagger ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
OpenAPI с поддержкой разрешений ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Расширенные пути REST ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Без ключа PUT и PATCH ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Заголовки кэша ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Кэш уровня 1: память ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Кэш уровня 2: Redis ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Полезные данные, готовые к POCO ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
OpenAPIReference ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет

Поддерживаемые объекты базы данных

Feature MSSQL Космос PGSQL MySQL DWSQLNO
Tables ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Views ✅ Да ✖️ Нет ✅ Да ✖️ Нет ✅ Да
Хранимые процедуры ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✅ Да
Параметры Proc ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✅ Да
Functions ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
Collections ✖️ Нет ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет
Сопоставление полей ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да

Разрешения сущностей

Feature MSSQL Космос PGSQL MySQL DWSQLNO
Cповторное изменение ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
REad ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Update ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Delete ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Execute ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✅ Да
Включение полей ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Исключение полей ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да

Политика базы данных

Feature MSSQL Космос PGSQL MySQL DWSQLNO
Cповторное изменение ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✅ Да
REad ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Update ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Delete ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
Execute ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
ПолитикиSingle-Table ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✅ Да
Политики с несколькими таблицами ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
Политика запроса ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет

Функции проверки подлинности

Feature MSSQL Космос PGSQL MySQL DWSQLNO
UAMI (идентификатор записи)⁴ ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
SAMI (Идентификатор Записи)⁴ ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Azure EasyAuth ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
От имени (OBO) ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
Неуверенный поставщик ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Наследование ролей ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Безопасность ключа API ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет

Другие возможности

Feature MSSQL Космос PGSQL MySQL DWSQLNO
Поддержка собственного JSON ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
Поддержка собственного XML ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
Поддержка собственных векторов ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
Автоматическая настройка ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
Сжатие HTTP-ответа ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Аналитика приложений ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Log Analytics ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Ведение журнала файлов ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Контекст сеанса ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
Несколько источников данных ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Перекрестное присоединение ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
OpenTelemetry ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Конечные точки работоспособности ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Пользовательские уровни журналов ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
.NET Aspire ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
MCP перекрести ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да

СЕРВЕР MCP

Замечание

Для функций СЕРВЕРА MCP требуется построитель API данных версии 1.7 или более поздней.

Feature MSSQL Космос PGSQL MySQL DWSQLNO
Средство DML: CREATE ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Средство DML: READ ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
DML-tool: UPDATE ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Средство DML: DELETE ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Средство DML: EXECUTE ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Средство DML: ОПИСАНИЕ ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Хранимая процедура как инструмент ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✅ Да
Пользовательские инструменты MCP ✅ Да ✖️ Нет ✖️ Нет ✖️ Нет ✅ Да
Инструкции сервера ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Метаданные объекта ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Метаданные поля ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Метаданные параметров ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
READ: Разбиение на страницы ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
ПРОЧИТАТЬ: $Select ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
ПРОЧИТАТЬ: $Filter ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
ПРОЧИТАТЬ: $Count ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет ✖️ Нет
ПРОЧИТАТЬ: $OrderBy ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
ПРОЧИТАТЬ: $First ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да
ПРОЧИТАТЬ: $After ✅ Да ✖️ Нет ✅ Да ✅ Да ✅ Да

Платформы оркестрации контейнеров

Построитель API данных выполняется на любой платформе среды выполнения контейнера или оркестрации. К общим платформам относятся:

Platform Поддерживается
Приложения контейнеров Azure (ACA) ✅ Да
Экземпляры контейнеров Azure (ACI) ✅ Да
Служба Azure Kubernetes (AKS) ✅ Да
Служба эластичных контейнеров AWS (ECS) ✅ Да
Служба AWS Elastic Kubernetes (EKS) ✅ Да
Google Kubernetes Engine (GKE) ✅ Да
Kubernetes (любое распределение) ✅ Да
Docker ✅ Да
Любая другая среда выполнения контейнера ✅ Да

Службы развертывания Azure

Feature MSSQL Космос PGSQL MySQL DWSQLNO
Приложения контейнеров Azure ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Инстанции контейнеров Azure ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Службы Azure Kubernetes ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Веб-приложение Azure для контейнеров ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Azure Red Hat OpenShift ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Azure Spring Apps ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Azure Service Fabric ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да
Виртуальная машина Azure ✅ Да ✅ Да ✅ Да ✅ Да ✅ Да

Неподдерживаемые типы данных

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

Microsoft SQL

Тип данных Description
geography Геопространственные данные, представляющие поверхность Земли.
geometry Планарные пространственные данные с помощью декартовых координат.
hierarchyid Иерархическое управление данными.
json Форматированные данные JSON.
rowversion Управление версиями строк для элемента управления параллелизмом.
sql_variant Значения различных типов данных, поддерживаемых SQL Server.
vector Векторные данные.
xml Форматированные данные XML.

PostgreSQL

Тип данных Description
bytea Двоичное хранилище строк.
date Даты календаря (год, месяц, день).
smalldatetime Менее точное хранилище даты и времени.
datetime2 Не собственный; обычно обрабатывается timestamp.
timestamptz Даты и время с часовыми поясами.
time Время дня без даты.
localtime Текущее время на основе системных часов.

MySQL

Тип данных Description
UUID Универсальные уникальные идентификаторы.
DATE Даты календаря.
SMALLDATETIME Менее точное хранилище даты и времени.
DATETIME2 Не собственный; обычно обрабатывается datetime.
DATETIMEOFFSET Даты и время с часовыми поясами.
TIME Время дня без даты.
LOCALTIME Текущее время на основе системных часов.

Azure Cosmos DB для NoSQL

Azure Cosmos DB для NoSQL не зависит от схемы, поэтому ограничения типов данных не применяются так же, как реляционные базы данных.

Сноски

Data DWSQL отражает поддержку только выделенного пула SQL. Бессерверный пул SQL не поддерживается.

² Cosmos поддерживается в DAB с помощью GraphQL. DAB не создает конечные точки REST для Cosmos, так как API для NoSQL предоставляет собственный REST API. Дополнительные сведения см. в статье Azure Cosmos DB: справочник по REST API.

Sql MCP (протокол контекста модели) — это возможность уровня конечной точки, а не база данных.

Поддержка управляемых удостоверений ⁴ использует Azure DefaultAzureCredential, которая поддерживает управляемые удостоверения System-Assigned (SAMI) и User-Assigned (UAMI). Для UAMI требуется задать AZURE_CLIENT_ID переменную среды.

⚠️ Частичные для мутаций Cosmos DB означает, что поддерживаются базовые операции создания, обновления и удаления, но не все типы мутаций (например, многомутационные) доступны.

  • Last updated on