REST API의 데이터베이스 뷰

뷰는 DAB(Data API Builder)의 테이블에 대한 대안으로 지원됩니다. 최소한의 구성으로 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 동사를 지원합니다. GETPOSTPUTPATCHDELETE
• 기본 동작은 테이블 기반 엔터티와 동일합니다.
• 보기가 업데이트 가능하고 적절한 사용 권한이 설정된 경우에만 작업이 성공합니다.

예제 요청

GET /api/BookDetail/id/42

vw_books_details의 행을 id = 42와 함께 반환합니다.

Permissions

• 읽기 전용 보기에서 read 작업을 사용하십시오.
• 뷰를 업데이트할 수 있는 경우에만 create, update, delete를 사용하십시오.

제한점

• key-fields 가 필요합니다.
• 뷰는 관계를 지원하지 않습니다.
• 뷰가 테이블처럼 동작하는 경우 페이지 매김, 필터링 및 정렬이 지원됩니다.

관련 콘텐츠

• GraphQL API의 데이터베이스 뷰
• 원본 구성