Ketersediaan fitur untuk penyusun API Data

Tabel ini mencantumkan fitur yang tersedia di Penyusun API Data (DAB).

Versi database

Database Abbreviation Min. Versi
SQL Server MSSQL Versi 2016
Azure SQL Database MSSQL N/A (PaaS)
Azure SQL Managed Instance MSSQL N/A (PaaS)
SQL Server di mesin virtual Azure MSSQL Versi 2016
SQL Server dengan dukungan Arc MSSQL Versi 2016
Basis data SQL dalam Fabric MSSQL N/A (PaaS)
Azure Cosmos DB for NoSQL COSMOSDB N/A (PaaS)
PostgreSQL PGSQL Versi 11
Database Azure untuk Server Fleksibel PostgreSQL PGSQL Versi 11
MySQL MySQL Versi 8
Server Fleksibel dari Azure Database untuk MySQL MySQL Versi 5.7
Azure Synapse Analytics (Kumpulan SQL Khusus) DWSQL¹ N/A (PaaS)

Tingkat isolasi transaksi default

Penyusun API Data menggunakan tingkat isolasi transaksi default berikut.

Jenis database Tingkat isolasi Informasi selengkapnya
Microsoft SQL Read Committed (Dibaca Terikat) Azure SQL
PostgreSQL Read Committed (Dibaca Terikat) PostgreSQL
MySQL Pembacaan yang Dapat Diulang MySQL

Lingkungan cloud dan hosting

Penyusun API Data berjalan di lingkungan apa pun dengan dukungan kontainer. Berikut ini adalah target penyebaran cloud umum:

Lingkungan Didukung
Microsoft Azure ✅ Ya
Amazon Web Services (AWS) ✅ Ya
Google Cloud Platform (GCP) ✅ Ya
Penyedia cloud lainnya ✅ Ya
On-premises ✅ Ya

GraphQL

Feature MSSQL Kosmos PGSQL MySQL DWSQL¹
Pagination ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Throttling ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Pemfilteran ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Agregasi ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✅ Ya
Penyortiran ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Pilihan ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Jenis kueri ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Jenis mutasi ✅ Ya ⚠️ Parsial ✅ Ya ✅ Ya ✅ Ya
Multi-Mutation ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
GroupBy Tingkat Lanjut ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✅ Ya
Memiliki Tingkat Lanjut ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✅ Ya
Pembuatan Skema ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Atribut Skema (@model) ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Atribut Skema (@authorize) ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Skema yang Disediakan Pengguna ✖️ Tidak ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak
Subscription ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Nitro ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Header Cache ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Cache Tingkat 1: Memori ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Cache Tingkat 2: Redis ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya

Navigasi Hubungan GraphQL

Feature MSSQL Kosmos PGSQL MySQL DWSQL¹
Satu-To-Many / Kueri ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Satu-To-Many / Mutasi ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✅ Ya
Banyak-To-Many / Kueri ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Banyak-To-Many / Mutasi ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✅ Ya
Hubungan Lintas Sumber ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Gabungan Lintas Sumber ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak

REST

Feature MSSQL Cosmos² PGSQL MySQL DWSQL¹
PUT ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
POST ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
PATCH ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
DELETE ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
GET ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Pagination ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Seperti OData $Select ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Seperti OData $Filter ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Seperti OData $Count ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Seperti OData $OrderBy ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Seperti OData $First ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
$After (Halaman kursor) ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Dokumen OpenAPI ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Swagger UI ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
OpenAPI yang sadar izin ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Jalur REST Tingkat Lanjut ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
PUT dan PATCH Tanpa Kunci ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Header Cache ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Cache Tingkat 1: Memori ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Cache Tingkat 2: Redis ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Payload siap POCO ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
OpenAPIReference ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak

Objek Database yang Didukung

Feature MSSQL Kosmos PGSQL MySQL DWSQL¹
Tables ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Views ✅ Ya ✖️ Tidak ✅ Ya ✖️ Tidak ✅ Ya
Prosedur Tersimpan ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✅ Ya
Parameter Proc ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✅ Ya
Functions ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Collections ✖️ Tidak ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak
Pemetaan Bidang ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya

Hak Akses Entitas

Feature MSSQL Kosmos PGSQL MySQL DWSQL¹
Create ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Read ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Update ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Delete ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Execute ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✅ Ya
Sertakan Bidang ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Mengecualikan Bidang ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya

Kebijakan Database

Feature MSSQL Kosmos PGSQL MySQL DWSQL¹
Create ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✅ Ya
Read ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Update ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Delete ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
Execute ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
KebijakanSingle-Table ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✅ Ya
Kebijakan Multi-Tabel ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Kebijakan Permintaan ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak

Fitur Autentikasi

Feature MSSQL Kosmos PGSQL MySQL DWSQL¹
UAMI (ID Entra)⁴ ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
SAMI (ID Entra)⁴ ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Azure EasyAuth ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
On-Behalf-Of (OBO) ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Penyedia Tidak Diaauthenticated ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Warisan Peran ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Keamanan kunci API ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak

Fitur Lainnya

Feature MSSQL Kosmos PGSQL MySQL DWSQL¹
Dukungan JSON Asli ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Dukungan XML Asli ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Dukungan Vektor Asli ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Konfigurasi Otomatis ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Kompresi Respons HTTP ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Wawasan Aplikasi ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Log Analytics ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Pengelogan File ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Konteks Sesi ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Beberapa Sumber Data ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Gabungan Lintas Sumber ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
OpenTelemetry ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Titik Akhir Kesehatan ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Tingkat Log Kustom ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
.NET Aspire ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
MCP³ ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya

MCP Server

Nota

Fitur MCP Server memerlukan pembuat API Data versi 1.7 atau yang lebih baru.

Feature MSSQL Kosmos PGSQL MySQL DWSQL¹
Alat DML: CREATE ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Alat DML: BACA ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Alat DML: PERBARUI ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Alat DML: DELETE ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Alat DML: EXECUTE ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Alat DML: DESCRIBE ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Prosedur Tersimpan sebagai Alat ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✅ Ya
Alat MCP Kustom ✅ Ya ✖️ Tidak ✖️ Tidak ✖️ Tidak ✅ Ya
Instruksi Server ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Metadata objek ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Metadata bidang ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Metadata parameter ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
BACA: Penomoran halaman ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
MEMBACA: $Select ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
MEMBACA: $Filter ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
MEMBACA: $Count ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
MEMBACA: $OrderBy ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
MEMBACA: $First ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya
MEMBACA: $After ✅ Ya ✖️ Tidak ✅ Ya ✅ Ya ✅ Ya

Platform Orkestrasi Kontainer

Penyusun API Data berjalan pada runtime kontainer atau platform orkestrasi apa pun. Platform umum meliputi:

Platform Didukung
Azure Container Apps (ACA) ✅ Ya
Azure Container Instances (ACI) ✅ Ya
Azure Kubernetes Service (AKS) ✅ Ya
AWS Elastic Container Service (ECS) ✅ Ya
AWS Elastic Kubernetes Service (EKS) ✅ Ya
Google Kubernetes Engine (GKE) ✅ Ya
Kubernetes (distribusi apa pun) ✅ Ya
Docker ✅ Ya
Runtime kontainer lainnya ✅ Ya

Layanan penyebaran Azure

Feature MSSQL Kosmos PGSQL MySQL DWSQL¹
Azure Container Apps ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Azure Container Instances ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Azure Kubernetes Services ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Aplikasi Web Azure untuk Kontainer ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Azure Red Hat OpenShift ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Azure Spring Apps ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Azure Service Fabric ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Azure Virtual Machine ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya

Jenis data yang tidak didukung

Penyusun API Data tidak mendukung beberapa jenis data untuk setiap platform database. Keterbatasan ini biasanya disebabkan oleh kendala serialisasi atau kurangnya dukungan asli dalam driver database yang mendasar.

Microsoft SQL

Jenis data Description
geography Data geospasial yang mewakili permukaan Bumi.
geometry Data spasial planar menggunakan koordinat Kartesius.
hierarchyid Manajemen data hierarkis.
json Data berformat JSON.
rowversion Penerapan versi baris untuk kontrol konkurensi.
sql_variant Nilai berbagai jenis data yang didukung SQL Server.
vector Data vektor.
xml Data berformat XML.

PostgreSQL

Jenis data Description
bytea Penyimpanan string biner.
date Tanggal kalender (tahun, bulan, hari).
smalldatetime Penyimpanan tanggal dan waktu yang kurang tepat.
datetime2 Bukan asli; biasanya ditangani oleh timestamp.
timestamptz Tanggal dan waktu dengan zona waktu.
time Waktu hari tanpa tanggal.
localtime Waktu saat ini berdasarkan jam sistem.

MySQL

Jenis data Description
UUID Pengidentifikasi Unik Universal.
DATE Tanggal kalender.
SMALLDATETIME Penyimpanan tanggal dan waktu yang kurang tepat.
DATETIME2 Bukan asli; biasanya ditangani oleh datetime.
DATETIMEOFFSET Tanggal dan waktu dengan zona waktu.
TIME Waktu hari tanpa tanggal.
LOCALTIME Waktu saat ini berdasarkan jam sistem.

Azure Cosmos DB for NoSQL

Azure Cosmos DB for NoSQL bersifat skema-agnostik, sehingga pembatasan jenis data tidak berlaku dengan cara yang sama seperti database relasional.

Catatan kaki

¹ DWSQL hanya mencerminkan dukungan untuk kumpulan SQL Khusus. Kumpulan SQL tanpa server tidak didukung.

² Cosmos didukung di DAB melalui GraphQL. DAB tidak menghasilkan titik akhir REST untuk Cosmos karena API untuk NoSQL menyediakan REST API asli. Untuk informasi selengkapnya, lihat Referensi Azure Cosmos DB: REST API.

³ MCP (Protokol Konteks Model) adalah kemampuan tingkat titik akhir, bukan khusus database.

Dukungan identitas terkelola ⁴ menggunakan Azure DefaultAzureCredential, yang mendukung identitas terkelola System-Assigned (SAMI) dan User-Assigned (UAMI). UAMI memerlukan pengaturan AZURE_CLIENT_ID variabel lingkungan.

⚠️ Sebagian untuk mutasi Cosmos DB berarti operasi pembuatan, pembaruan, dan penghapusan dasar didukung, tetapi tidak semua jenis mutasi (seperti multi-mutasi) tersedia.