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

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

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

Database	Abbreviation	Мин. Версия
SQL Server	Семейство SQL	Версия 2016
Azure SQL	Семейство SQL	N/A (PaaS)
Microsoft Fabric SQL	Семейство SQL	N/A (PaaS)
Azure Cosmos DB для NoSQL	Cosmos DB	N/A (PaaS)
PostgreSQL	PGSQL	Версия 11
MySQL	MySQL	Версия 8
Azure Synapse Analytics (выделенный пул SQL)	SQLDWno	N/A (PaaS)

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

Ключом этой таблицы является то, что построитель API данных может выполняться в любой среде с поддержкой контейнеров.

Окружающая среда	Поддерживается
Microsoft Azure	✅ Да
Amazon Web Services (AWS)	✅ Да
Google Cloud Platform (GCP)	✅ Да
Oracle Cloud Infrastructure (OCI)	✅ Да
IBM Cloud	✅ Да
Alibaba Cloud	✅ Да
On-premises	✅ Да

GraphQL

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

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

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

REST

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

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

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

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

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

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

Feature	Семейство SQL	Cosmos DB	PGSQL	MySQL	SQLDWno
Cповторное изменение	✅ Да	✖️ Нет	✖️ Нет	✖️ Нет	✅ Да
REad	✅ Да	✖️ Нет	✅ Да	✅ Да	✅ Да
Update	✅ Да	✖️ Нет	✅ Да	✅ Да	✅ Да
Delete	✅ Да	✖️ Нет	✅ Да	✅ Да	✅ Да
Execute	✖️ Нет	✖️ Нет	✖️ Нет	✖️ Нет	✖️ Нет
ПолитикиSingle-Table	✅ Да	✖️ Нет	✖️ Нет	✖️ Нет	✅ Да
Политики с несколькими таблицами	✖️ Нет	✖️ Нет	✖️ Нет	✖️ Нет	✖️ Нет
Политика запроса	✖️ Нет	✖️ Нет	✖️ Нет	✖️ Нет	✖️ Нет

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

Feature	Семейство SQL	Cosmos DB	PGSQL	MySQL	SQLDWno
UAMI (идентификатор записи)⁴	✅ Да	✅ Да	✅ Да	✅ Да	✅ Да
SAMI (Идентификатор Записи)⁴	✅ Да	✅ Да	✅ Да	✅ Да	✅ Да
Azure EasyAuth	✅ Да	✅ Да	✅ Да	✅ Да	✅ Да
Сквозная безопасность	✖️ Нет	✖️ Нет	✖️ Нет	✖️ Нет	✖️ Нет
Безопасность ключа API	✖️ Нет	✖️ Нет	✖️ Нет	✖️ Нет	✖️ Нет

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

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

СЕРВЕР MCP

Замечание

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

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

Поддержка Azure (контейнеры)

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

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

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

SQL Server и Azure 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 не зависит от схемы, поэтому ограничения типов данных не применяются так же, как реляционные базы данных.

Сноски

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

² Cosmos DB поддерживается в DAB с помощью GraphQL. DAB не создает конечные точки REST для Cosmos DB, так как 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 означает, что поддерживаются базовые операции создания, обновления и удаления, но не все типы мутаций (например, многомутационные) доступны.