Bagikan melalui


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 Keluarga SQL Versi 2016
Azure SQL Keluarga SQL N/A (PaaS)
Microsoft Fabric SQL Keluarga SQL N/A (PaaS)
Azure Cosmos DB for NoSQL Cosmos DB N/A (PaaS)
PostgreSQL PGSQL Versi 11
MySQL MySQL Versi 8
Azure Synapse Analytics (Kumpulan SQL Khusus) SQLDW¹ N/A (PaaS)

Lingkungan cloud dan hosting

Kunci untuk tabel ini adalah bahwa penyusun API Data dapat berjalan di lingkungan apa pun dengan dukungan kontainer.

Lingkungan Didukung
Microsoft Azure ✅ Ya
Amazon Web Services (AWS) ✅ Ya
Google Cloud Platform (GCP) ✅ Ya
Oracle Cloud Infrastructure (OCI) ✅ Ya
IBM Cloud ✅ Ya
Alibaba Cloud ✅ Ya
On-premises ✅ Ya

GraphQL

Feature Keluarga SQL Cosmos DB PGSQL MySQL SQLDW¹
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 Keluarga SQL Cosmos DB PGSQL MySQL SQLDW¹
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 Keluarga SQL Cosmos DB² PGSQL MySQL SQLDW¹
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
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 Keluarga SQL Cosmos DB PGSQL MySQL SQLDW¹
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 Keluarga SQL Cosmos DB PGSQL MySQL SQLDW¹
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 Keluarga SQL Cosmos DB PGSQL MySQL SQLDW¹
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 Keluarga SQL Cosmos DB PGSQL MySQL SQLDW¹
UAMI (ID Entra)⁴ ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
SAMI (ID Entra)⁴ ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Azure EasyAuth ✅ Ya ✅ Ya ✅ Ya ✅ Ya ✅ Ya
Keamanan pass-through ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Keamanan kunci API ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak

Fitur Lainnya

Feature Keluarga SQL Cosmos DB PGSQL MySQL SQLDW¹
Dukungan JSON Asli ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Dukungan XML Asli ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
Dukungan Vektor Asli ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak ✖️ Tidak
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 Keluarga SQL Cosmos DB PGSQL MySQL SQLDW¹
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
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

Dukungan Azure (kontainer)

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

SQL Server dan Azure 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 (saat ini dalam pratinjau).
rowversion Penerapan versi baris untuk kontrol konkurensi.
sql_variant Nilai berbagai jenis data yang didukung SQL Server.
vector Data vektor (saat ini dalam pratinjau).
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

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

² Cosmos DB didukung di DAB melalui GraphQL. DAB tidak menghasilkan titik akhir REST untuk Cosmos DB 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.