數據 API 產生器的功能可用性

這些資料表列出數據 API 產生器 （DAB） 中可用的功能。

資料庫版本

Database	Abbreviation	最小值。 版本
SQL Server	MSSQL	2016 年版本
Azure SQL Database	MSSQL	N/A （PaaS）
Azure SQL 受控執行個體	MSSQL	N/A （PaaS）
Azure VM 上的 SQL Server	MSSQL	2016 年版本
已啟用 Arc 功能的 SQL Server	MSSQL	2016 年版本
Fabric 中的 SQL 資料庫	MSSQL	N/A （PaaS）
Azure Cosmos DB for NoSQL	宇宙生物統計局	N/A （PaaS）
PostgreSQL	PGSQL	第 11 版
Azure Database for PostgreSQL Flexible Server（Azure 資料庫的 PostgreSQL 彈性伺服器）	PGSQL	第 11 版
MySQL	MySQL	版本8
Azure MySQL 彈性伺服器資料庫	MySQL	版本 5.7
Azure Synapse Analytics （Dedicated SQL pool）	DWSQL¹	N/A （PaaS）

預設的交易隔離層級

資料 API 建構器使用以下預設的交易隔離層級。

資料庫類型	隔離等級	詳細資訊
Microsoft SQL	讀取認可	Azure SQL
PostgreSQL	讀取認可	PostgreSQL
MySQL	可重複讀取	MySQL

雲端與主機環境

Data API 建構器可在任何支援容器的環境中運行。 以下是常見的雲端部署目標：

環境	支持
Microsoft Azure	✅ 是
Amazon Web Services （AWS）	✅ 是
Google 雲端平台（GCP）	✅ 是
任何其他雲端供應商	✅ 是
內部部署	✅ 是

GraphQL

Feature	MSSQL	Cosmos	PGSQL	MySQL	DWSQL¹
重新編頁	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
Throttling	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
篩選	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
匯總	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
分院	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
選取範圍	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
查詢型態	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
突變型	✅ 是	⚠️ 部分	✅ 是	✅ 是	✅ 是
Multi-Mutation	✅ 是	✖️ 不	✖️ 不	✖️ 不	✖️ 不
進階小組	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
進階擁有	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
結構產生	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
結構屬性（@model）	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
結構屬性（@authorize）	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
使用者提供的架構	✖️ 不	✅ 是	✖️ 不	✖️ 不	✖️ 不
Subscription	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
氮氣	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
快取標頭	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
第一級快取：記憶體	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
第二級快取：Redis	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是

GraphQL 關聯性導覽

Feature	MSSQL	Cosmos	PGSQL	MySQL	DWSQL¹
一 -To-Many / 查詢	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
一 -To-Many / 突變	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
多 -To-Many / 查詢	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
多To-Many / 突變	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
跨來源關係	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
跨源接合	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不

REST

Feature	MSSQL	宇宙²	PGSQL	MySQL	DWSQL¹
PUT	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
POST	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
PATCH	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
DELETE	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
GET	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
重新編頁	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
類似 OData $Select	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
類似 OData $Filter	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
類似 OData $Count	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
類似 OData $OrderBy	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
類似 OData $First	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
$After （游標翻頁）	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
OpenAPI 文件	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
Swagger 使用者介面	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
權限感知型 OpenAPI	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
進階 REST 路徑	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
無鍵 PUT 與 PATCH	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
快取標頭	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
第一級快取：記憶體	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
第二級快取：Redis	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
POCO準備有效載荷	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
OpenAPIReference	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不

支援的資料庫物件

Feature	MSSQL	Cosmos	PGSQL	MySQL	DWSQL¹
Tables	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
Views	✅ 是	✖️ 不	✅ 是	✖️ 不	✅ 是
預存程式	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
程序參數	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
Functions	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
Collections	✖️ 不	✅ 是	✖️ 不	✖️ 不	✖️ 不
場域映射	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是

實體權限

Feature	MSSQL	Cosmos	PGSQL	MySQL	DWSQL¹
C雷亞特	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
READ	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
U日期	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
DElete	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
E超可愛	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
包含欄位	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
排除欄位	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是

資料庫政策

Feature	MSSQL	Cosmos	PGSQL	MySQL	DWSQL¹
C雷亞特	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
READ	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
U日期	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
DElete	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
E超可愛	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
Single-Table 政策	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
多表政策	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
請求政策	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不

認證功能

Feature	MSSQL	Cosmos	PGSQL	MySQL	DWSQL¹
UAMI （Entra ID）⁴	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
SAMI（Entra ID）⁴	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
Azure EasyAuth	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
開-Behalf-Of（OBO）	✅ 是	✖️ 不	✖️ 不	✖️ 不	✖️ 不
未認證提供者	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
角色繼承	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
API 金鑰安全性	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不

其他功能

Feature	MSSQL	Cosmos	PGSQL	MySQL	DWSQL¹
原生 JSON 支援	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
原生 XML 支援	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
原生向量支援	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
自動配置	✅ 是	✖️ 不	✖️ 不	✖️ 不	✖️ 不
HTTP 回應壓縮	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
應用程式深入解析	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
Log Analytics	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
檔案記錄	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
會話上下文	✅ 是	✖️ 不	✖️ 不	✖️ 不	✖️ 不
多個數據源	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
跨源連接	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
OpenTelemetry	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
健康端點	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
自訂日誌等級	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
.NET Aspire	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
MCP³	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是

MCP 伺服器

備註

MCP 伺服器功能需 Data API 建構器版本 1.7 或更新版本。

Feature	MSSQL	Cosmos	PGSQL	MySQL	DWSQL¹
DML 工具：創建	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
DML-tool：讀取	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
DML-tool：更新	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
DML 工具：刪除	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
DML-tool：執行	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
DML-tool：描述	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
儲存程序作為工具	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
自訂 MCP 工具	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
伺服器指令	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
物件元資料	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
欄位元資料	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
參數元資料	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
閱讀：頁碼	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
閱讀： $Select	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
閱讀： $Filter	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
閱讀： $Count	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
閱讀： $OrderBy	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
閱讀： $First	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
閱讀： $After	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是

容器協調平台

Data API 建構器可在任何容器執行時或編排平台上運行。 常見平台包括：

平台	支持
Azure 容器應用程式 (ACA)	✅ 是
Azure 容器執行個體 （ACI）	✅ 是
Azure Kubernetes Service （AKS）	✅ 是
AWS 彈性容器服務（ECS）	✅ 是
AWS Elastic Kubernetes 服務（EKS）	✅ 是
Google Kubernetes Engine （GKE）	✅ 是
Kubernetes（任何發行版）	✅ 是
Docker	✅ 是
任何其他容器執行時	✅ 是

Azure deployment services

Feature	MSSQL	Cosmos	PGSQL	MySQL	DWSQL¹
Azure 容器應用程式	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
Azure 容器執行個體	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
Azure Kubernetes Services	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
適用於容器的 Azure Web 應用程式	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
Azure Red Hat OpenShift	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
Azure Spring 應用程式	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
Azure Service Fabric	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
Azure 虛擬機	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是

不支援的資料類型

Data API 建構器不支援每個資料庫平台的某些資料型別。 這些限制通常是因為序列化限制或底層資料庫驅動程式缺乏原生支援。

Microsoft 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 for NoSQL

Azure Cosmos DB for NoSQL 是結構無關的，因此資料型別限制不像關聯式資料庫那樣適用。

Footnotes

¹ DWSQL 僅支援專用 SQL 池。 不支援無伺服器 SQL 池。

² Cosmos 在 DAB 中透過 GraphQL 支援。 DAB 不會為 Cosmos 產生 REST 端點，因為 NoSQL 的 API 提供了原生的 REST API。 欲了解更多資訊，請參閱 Azure Cosmos DB： REST API 參考。

³ MCP（模型情境協定）是一種端點層級能力，非資料庫專屬。

⁴ 受管身份支援使用 Azure，該 Azure DefaultAzureCredential同時支援 System-Assigned（SAMI）與 User-Assigned（UAMI）管理身份。 UAMI 需要設定 AZURE_CLIENT_ID 環境變數。

⚠️ Cosmos DB 部分突變意味著支援基本的建立、更新和刪除操作，但並非所有突變類型（如多重突變）皆可用。