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

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

資料庫版本

Database	Abbreviation	最小值。 版本
SQL Server	SQL 家族	2016 年版本
Azure SQL	SQL 家族	N/A （PaaS）
Microsoft Fabric SQL	SQL 家族	N/A （PaaS）
Azure Cosmos DB for NoSQL	Cosmos DB	N/A （PaaS）
PostgreSQL	PGSQL	第 11 版
MySQL	MySQL	版本8
Azure Synapse Analytics （Dedicated SQL pool）	SQLDW¹	N/A （PaaS）

雲端與主機環境

這個表格的關鍵在於 Data API 建構器能在任何有容器支援的環境中執行。

環境	支持
Microsoft Azure	✅ 是
Amazon Web Services （AWS）	✅ 是
Google 雲端平台（GCP）	✅ 是
Oracle Cloud Infrastructure （OCI）	✅ 是
IBM 雲端	✅ 是
阿里雲	✅ 是
內部部署	✅ 是

GraphQL

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

GraphQL 關聯性導覽

Feature	SQL 家族	Cosmos DB	PGSQL	MySQL	SQLDW¹
一 -To-Many / 查詢	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
一 -To-Many / 突變	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
多 -To-Many / 查詢	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
多To-Many / 突變	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
跨來源關係	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
跨源接合	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不

REST

Feature	SQL 家族	宇宙DB²	PGSQL	MySQL	SQLDW¹
PUT	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
POST	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
PATCH	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
DELETE	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
GET	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
重新編頁	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
類似 OData $Select	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
類似 OData $Filter	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
類似 OData $Count	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
類似 OData $OrderBy	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
類似 OData $First	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
$After （游標翻頁）	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
OpenAPI 文件	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
Swagger 使用者介面	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
快取標頭	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
第一級快取：記憶體	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
第二級快取：Redis	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
POCO準備有效載荷	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
OpenAPIReference	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不

支援的資料庫物件

Feature	SQL 家族	Cosmos DB	PGSQL	MySQL	SQLDW¹
Tables	✅ 是	✖️ 不	✅ 是	✅ 是	✅ 是
Views	✅ 是	✖️ 不	✅ 是	✖️ 不	✅ 是
預存程式	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
程序參數	✅ 是	✖️ 不	✖️ 不	✖️ 不	✅ 是
Functions	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
Collections	✖️ 不	✅ 是	✖️ 不	✖️ 不	✖️ 不
場域映射	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是

實體權限

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

資料庫政策

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

認證功能

Feature	SQL 家族	Cosmos DB	PGSQL	MySQL	SQLDW¹
UAMI （Entra ID）⁴	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
SAMI（Entra ID）⁴	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
Azure EasyAuth	✅ 是	✅ 是	✅ 是	✅ 是	✅ 是
通過式安全	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不
API 金鑰安全性	✖️ 不	✖️ 不	✖️ 不	✖️ 不	✖️ 不

其他功能

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

MCP 伺服器

備註

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

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

Azure 支援 （容器）

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

不支援的資料類型

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

SQL Server 與 Azure 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

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

² Cosmos DB 透過 GraphQL 在 DAB 中支援。 DAB 不會為 Cosmos DB 產生 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 部分突變意味著支援基本的建立、更新和刪除操作，但並非所有突變類型（如多重突變）皆可用。