Udostępnij przez

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 Rodzina SQL Wersja 2016
Azure SQL Rodzina SQL Nie dotyczy (PaaS)
Microsoft Fabric SQL Rodzina SQL Nie dotyczy (PaaS)
Azure Cosmos DB for NoSQL Cosmos DB Nie dotyczy (PaaS)
PostgreSQL PGSQL Wersja 11
MySQL MySQL Wersja 8
Azure Synapse Analytics (dedykowana pula SQL) SQLDW¹ Nie dotyczy (PaaS)

Środowiska chmury i hostingu

Kluczem do tej tabeli jest to, że konstruktor interfejsu API danych może działać w dowolnym środowisku z obsługą kontenerów.

Środowisko Wsparte
Microsoft Azure ✅ Tak
Amazon Web Services (AWS) ✅ Tak
Google Cloud Platform (GCP) ✅ Tak
Oracle Cloud Infrastructure (OCI) ✅ Tak
IBM Cloud ✅ Tak
Chmura Alibaba ✅ Tak
Na miejscu ✅ Tak

GraphQL

Feature Rodzina SQL Cosmos DB PGSQL MySQL SQLDW¹
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 Rodzina SQL Cosmos DB PGSQL MySQL SQLDW¹
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 Rodzina SQL Cosmos DB² PGSQL MySQL SQLDW¹
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
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 Rodzina SQL Cosmos DB PGSQL MySQL SQLDW¹
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 Rodzina SQL Cosmos DB PGSQL MySQL SQLDW¹
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 Rodzina SQL Cosmos DB PGSQL MySQL SQLDW¹
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 Rodzina SQL Cosmos DB PGSQL MySQL SQLDW¹
UAMI (Entra ID)⁴ ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
SAMI (Entra ID)⁴ ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Azure EasyAuth ✅ Tak ✅ Tak ✅ Tak ✅ Tak ✅ Tak
Zabezpieczenia przekazywane ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie
Zabezpieczenia klucza interfejsu API ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie ✖️ Nie

Inne funkcje

Feature Rodzina SQL Cosmos DB PGSQL MySQL SQLDW¹
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
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 Rodzina SQL Cosmos DB PGSQL MySQL SQLDW¹
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
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

Pomoc techniczna platformy Azure (kontenery)

Feature Rodzina SQL Cosmos DB PGSQL MySQL SQLDW¹
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.

SQL Server i Azure 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 (obecnie w wersji zapoznawczej).
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 (obecnie w wersji zapoznawczej).
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

¹ SqlDW odzwierciedla obsługę tylko dedykowanej puli SQL. Bezserwerowa pula SQL nie jest obsługiwana.

² Usługa Cosmos DB 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 DB, 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.

  • Last updated on