檢視功能在資料 API 建構器(DAB)中支援作為資料表的替代方案。 檢視可以透過 REST 端點以最少設定方式公開。
Configuration
為了展示一個觀點:
- 將
source.type設定為"view" - 設定
source.object為完全限定的視圖名稱 - 要唯一識別一列,定義
key-fields - 使用
"read"動作授予權限(若視圖可更新,則可選擇"create","update","delete")
CLI 範例
dab add BookDetail \
--source dbo.vw_books_details \
--source.type "view" \
--fields.name "id" \
--fields.primary-key "true" \
--permissions "anonymous:read"
設定範例
"BookDetail": {
"source": {
"type": "view",
"object": "dbo.vw_books_details",
"key-fields": [ "id" ]
},
"permissions": [
{
"role": "anonymous",
"actions": [ "read" ]
}
]
}
REST 行為
- 支援所有 REST 動詞:
GET,POST,PUTPATCHDELETE - 預設行為與資料表支援實體相同
- 操作只有在視圖可更新且設定適當權限時才會成功
範例要求
GET /api/BookDetail/id/42
返回 vw_books_details 中符合 id = 42 的行。
許可
- 使用
read動作來顯示只讀視圖 - 請使用
create、update,且delete僅當視圖可更新時
局限性
-
key-fields是必須的項目 - 觀點不支持關係
- 如果視圖如同表格一樣運作,則支援分頁、篩選和排序