Udostępnij za pośrednictwem


Dostępność funkcji dla konstruktora interfejsu API danych

Te tabele zawierają listę funkcji dostępnych w narzędziu Data API Builder (DAB).

Wersja bazy danych

Database Abbreviation Min. wersja
SQL Server MSSQL Wersja 2016
Azure SQL Database MSSQL Nie dotyczy (PaaS)
Azure SQL Managed Instance MSSQL Nie dotyczy (PaaS)
SQL Server na maszynach wirtualnych Azure MSSQL Wersja 2016
SQL Server z obsługą Arc MSSQL Wersja 2016
Baza danych SQL na platformie Fabric MSSQL Nie dotyczy (PaaS)
Azure Cosmos DB for NoSQL COSMOSDB Nie dotyczy (PaaS)
PostgreSQL PGSQL Wersja 11
Elastyczny serwer Azure Database dla PostgreSQL PGSQL Wersja 11
MySQL MySQL Wersja 8
Usługa Azure Database for MySQL — serwer elastyczny MySQL Wersja 5.7
Azure Synapse Analytics (dedykowana pula SQL) DWSQL¹ Nie dotyczy (PaaS)

Domyślne poziomy izolacji transakcji

Konstruktor interfejsu API danych używa następujących domyślnych poziomów izolacji transakcji.

Typ bazy danych Poziom izolacji Więcej informacji
Microsoft SQL Odczyt zatwierdzony Azure SQL
PostgreSQL Odczyt zatwierdzony PostgreSQL
MySQL Powtarzalny odczyt MySQL

Środowiska chmury i hostingu

Konstruktor interfejsu API danych działa w dowolnym środowisku z obsługą kontenerów. Poniżej przedstawiono typowe cele wdrażania w chmurze:

Środowisko Wsparte
Microsoft Azure ✅ Tak
Amazon Web Services (AWS) ✅ Tak
Google Cloud Platform (GCP) ✅ Tak
Dowolny inny dostawca usług w chmurze ✅ Tak
Na miejscu ✅ Tak

GraphQL

Feature MSSQL Cosmos PGSQL MySQL DWSQL¹
Paginacja ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Throttling ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Filtrowanie ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Agregacja ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✅ Tak
Sortowania ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Wybór ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Typ zapytania ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Typ mutacji ✅ Tak ⚠️ Częściowe ✅ Tak ✅ Tak ✅ Tak
Multi-Mutation ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Grupa zaawansowana wg ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✅ Tak
Zaawansowane posiadanie ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✅ Tak
Generowanie schematu ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Atrybut schematu (@model) ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Atrybut schematu (@authorize) ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Schemat udostępniony przez użytkownika ✖️ Nie ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie
Subscription ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Nitro ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Nagłówki pamięci podręcznej ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Pamięć podręczna poziomu 1: pamięć ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Poziom 2 Pamięci podręcznej: Redis ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak

Nawigacja po relacji GraphQL

Feature MSSQL Cosmos PGSQL MySQL DWSQL¹
Jedno-To-Many/ zapytanie ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Jeden-To-Many / mutacja ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✅ Tak
Wiele —To-Many/zapytanie ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Wiele-To-Many / mutacja ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✅ Tak
Relacje między źródłami ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Sprzężenia między źródłami ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie

REST

Feature MSSQL Cosmos² PGSQL MySQL DWSQL¹
PUT ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
POST ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
PATCH ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
DELETE ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
GET ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Paginacja ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Podobne do danych OData $Select ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Podobne do danych OData $Filter ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Podobne do danych OData $Count ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Podobne do danych OData $OrderBy ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Podobne do danych OData $First ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
$After (Stronicowanie kursora) ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Dokument OpenAPI ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Interfejs użytkownika struktury Swagger ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Interfejs OpenAPI obsługujący uprawnienia ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Zaawansowane ścieżki REST ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Bez klucza PUT i PATCH ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Nagłówki pamięci podręcznej ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Pamięć podręczna poziomu 1: pamięć ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Poziom 2 Pamięci podręcznej: Redis ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Ładunki gotowe do użycia POCO ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
OpenAPIReference ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie

Obsługiwane obiekty bazy danych

Feature MSSQL Cosmos PGSQL MySQL DWSQL¹
Tables ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Views ✅ Tak ✖️ Nie ✅ Tak ✖️ Nie ✅ Tak
Procedury przechowywane ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✅ Tak
Parametry proc ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✅ Tak
Functions ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Collections ✖️ Nie ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie
Mapowanie pól ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak

Uprawnienia jednostki

Feature MSSQL Cosmos PGSQL MySQL DWSQL¹
Create ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
REad ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Update ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
DUsuń ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Execute ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✅ Tak
Uwzględnij pola ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Wykluczanie pól ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak

Zasady bazy danych

Feature MSSQL Cosmos PGSQL MySQL DWSQL¹
Create ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✅ Tak
REad ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Update ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
DUsuń ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
Execute ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
zasadySingle-Table ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✅ Tak
Zasady obejmujące wiele tabel ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Zasady żądania ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie

Funkcje uwierzytelniania

Feature MSSQL Cosmos PGSQL MySQL DWSQL¹
UAMI (Entra ID)⁴ ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
SAMI (Entra ID)⁴ ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Azure EasyAuth ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
On-Behalf-Of (OBO) ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Nieuwierzytelniony dostawca ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Dziedziczenie roli ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Zabezpieczenia klucza interfejsu API ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie

Inne funkcje

Feature MSSQL Cosmos PGSQL MySQL DWSQL¹
Natywna obsługa kodu JSON ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Natywna obsługa kodu XML ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Natywna obsługa wektorów ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Automatyczna konfiguracja ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Kompresja odpowiedzi HTTP ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Application Insights ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Analiza dzienników ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Rejestrowanie plików ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Kontekst sesji ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Wiele źródeł danych ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Sprzężenia między źródłami ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
OpenTelemetry ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Punkty końcowe kondycji ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Niestandardowe poziomy dziennika ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
.NET Aspire ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
MCP³ ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak

Serwer MCP

Uwaga / Notatka

Funkcje serwera MCP wymagają konstruktora interfejsu API danych w wersji 1.7 lub nowszej.

Feature MSSQL Cosmos PGSQL MySQL DWSQL¹
Narzędzie DML: CREATE ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Narzędzie DML: ODCZYT ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Narzędzie DML: UPDATE ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Narzędzie DML: DELETE ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Narzędzie DML: EXECUTE ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Narzędzie DML: DESCRIBE ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Procedura składowana jako narzędzie ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✅ Tak
Niestandardowe narzędzia MCP ✅ Tak ✖️ Nie ✖️ Nie ✖️ Nie ✅ Tak
Instrukcje dotyczące serwera ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Metadane obiektu ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Metadane pola ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Metadane parametrów ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
CZYTAJ: Stronicowanie ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
ODCZYTU: $Select ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
ODCZYTU: $Filter ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
ODCZYTU: $Count ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
ODCZYTU: $OrderBy ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
ODCZYTU: $First ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak
ODCZYTU: $After ✅ Tak ✖️ Nie ✅ Tak ✅ Tak ✅ Tak

Platformy orkiestracji kontenerów

Konstruktor interfejsu API danych działa na dowolnej platformie środowiska uruchomieniowego kontenera lub orkiestracji. Typowe platformy obejmują:

Platforma Wsparte
Azure Container Apps (ACA) ✅ Tak
Azure Container Instances (ACI) ✅ Tak
Azure Kubernetes Service (AKS) ✅ Tak
AwS Elastic Container Service (ECS) ✅ Tak
AWS Elastic Kubernetes Service (EKS) ✅ Tak
Google Kubernetes Engine (GKE) ✅ Tak
Kubernetes (dowolna dystrybucja) ✅ Tak
Docker ✅ Tak
Dowolne inne środowisko uruchomieniowe kontenera ✅ Tak

Usługi wdrażania platformy Azure

Feature MSSQL Cosmos PGSQL MySQL DWSQL¹
Azure Container Apps ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Azure Container Instances ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Azure Kubernetes Services ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Aplikacja sieciowa Azure dla kontenerów ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Azure Red Hat OpenShift ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Azure Spring Apps ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Azure Service Fabric ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Maszyna wirtualna platformy Azure ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak

Nieobsługiwane typy danych

Konstruktor interfejsu API danych nie obsługuje niektórych typów danych dla każdej platformy bazy danych. Te ograniczenia są zwykle spowodowane ograniczeniami serializacji lub brakiem natywnej obsługi w bazowym sterowniku bazy danych.

Microsoft SQL

Typ danych Description
geography Dane geoprzestrzenne reprezentujące powierzchnię Ziemi.
geometry Planowanie danych przestrzennych przy użyciu współrzędnych kartezjańskich.
hierarchyid Hierarchiczne zarządzanie danymi.
json Dane sformatowane w formacie JSON.
rowversion Przechowywanie wersji wierszy dla kontrolki współbieżności.
sql_variant Wartości różnych typów danych obsługiwanych przez program SQL Server.
vector Dane wektorowe.
xml Dane sformatowane w formacie XML.

PostgreSQL

Typ danych Description
bytea Magazyn ciągów binarnych.
date Daty kalendarza (rok, miesiąc, dzień).
smalldatetime Mniej precyzyjny magazyn daty i godziny.
datetime2 Nie natywne; zwykle obsługiwane przez timestampprogram .
timestamptz Daty i godziny ze strefą czasową.
time Godzina dnia bez daty.
localtime Bieżący czas na podstawie zegara systemowego.

MySQL

Typ danych Description
UUID Unikatowe identyfikatory uniwersalne.
DATE Daty kalendarza.
SMALLDATETIME Mniej precyzyjny magazyn daty i godziny.
DATETIME2 Nie natywne; zwykle obsługiwane przez datetimeprogram .
DATETIMEOFFSET Daty i godziny ze strefą czasową.
TIME Godzina dnia bez daty.
LOCALTIME Bieżący czas na podstawie zegara systemowego.

Azure Cosmos DB for NoSQL

Usługa Azure Cosmos DB for NoSQL jest niezależna od schematu, więc ograniczenia typu danych nie mają zastosowania w taki sam sposób, jak relacyjne bazy danych.

Przypisy dolne

Baza danych DWSQL odzwierciedla obsługę tylko dedykowanej puli SQL. Bezserwerowa pula SQL nie jest obsługiwana.

Usługa Cosmos ² jest obsługiwana w języku DAB za pośrednictwem języka GraphQL. Język DAB nie generuje punktów końcowych REST dla usługi Cosmos, ponieważ interfejs API dla noSQL udostępnia natywny interfejs API REST. Aby uzyskać więcej informacji, zobacz Azure Cosmos DB: DOKUMENTACJA interfejsu API REST.

³ MCP (Model Context Protocol) to funkcja na poziomie punktu końcowego, a nie specyficzna dla bazy danych.

Obsługa tożsamości zarządzanej ⁴ korzysta z platformy Azure DefaultAzureCredential, która obsługuje tożsamości zarządzane System-Assigned (SAMI) i User-Assigned (UAMI). Funkcja UAMI wymaga ustawienia zmiennej środowiskowej AZURE_CLIENT_ID .

⚠✔ Częściowe mutacje usługi Cosmos DB oznaczają, że są obsługiwane podstawowe operacje tworzenia, aktualizacji i usuwania, ale nie wszystkie typy mutacji (takie jak mutacja wielokrotna) są dostępne.