다음을 통해 공유


데이터 API 작성기를 위한 기능 가용성

이러한 표에는 DAB(Data API Builder)에서 사용할 수 있는 기능이 나열되어 있습니다.

데이터베이스 버전

Database Abbreviation 분. 버전
SQL Server SQL 제품군 버전 2016
Azure SQL SQL 제품군 N/A(PaaS)
Microsoft Fabric SQL SQL 제품군 N/A(PaaS)
NoSQL용 Azure Cosmos DB Cosmos DB N/A(PaaS)
PostgreSQL PGSQL 버전 11
MySQL MySQL 버전 8
Azure Synapse Analytics(전용 SQL 풀) SQLDW 을(를) N/A(PaaS)

클라우드 및 호스팅 환경

이 테이블의 핵심은 데이터 API 작성기에서 컨테이너 지원을 사용하여 모든 환경에서 실행할 수 있다는 것입니다.

환경 지원됨
Microsoft Azure ✅ 예
Amazon Web Services(AWS) ✅ 예
Google Cloud Platform(GCP) ✅ 예
OCI(Oracle 클라우드 인프라) ✅ 예
IBM Cloud ✅ 예
Alibaba Cloud ✅ 예
On-premises ✅ 예

GraphQL

Feature SQL 제품군 Cosmos DB PGSQL MySQL SQLDW 을(를)
페이지 매김 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Throttling ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
필터링 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
집계 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
정렬 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
선택 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
쿼리 유형 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
변형 유형 ✅ 예 ⚠️ 부분 ✅ 예 ✅ 예 ✅ 예
Multi-Mutation ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
Advanced GroupBy ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
고급 필요 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
스키마 생성 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
스키마 특성(@model) ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
스키마 특성(@authorize) ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
사용자가 제공한 스키마 ✖️ 아니요 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
Subscription ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
니트로 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
캐시 헤더 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
수준 1 캐시: 메모리 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
수준 2 캐시: Redis ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예

GraphQL 관계 탐색

Feature SQL 제품군 Cosmos DB PGSQL MySQL SQLDW 을(를)
one-To-Many/Query ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
1To-Many / 돌연변이 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
다-To-Many/ 쿼리 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
다-To-Many / 돌연변이 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
원본 간 관계 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
원본 간 조인 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요

REST

Feature SQL 제품군 Cosmos DB² PGSQL MySQL SQLDW 을(를)
PUT ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
POST ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
PATCH ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
DELETE ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
GET ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
페이지 매김 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
OData와 유사 $Select ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
OData와 유사 $Filter ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
OData와 유사 $Count ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
OData와 유사 $OrderBy ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
OData와 유사 $First ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
$After (커서 페이징) ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
OpenAPI 문서 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
Swagger UI ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
캐시 헤더 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
수준 1 캐시: 메모리 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
수준 2 캐시: Redis ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
POCO 준비 페이로드 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
OpenAPIReference ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요

지원되는 데이터베이스 개체

Feature SQL 제품군 Cosmos DB PGSQL MySQL SQLDW 을(를)
Tables ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
Views ✅ 예 ✖️ 아니요 ✅ 예 ✖️ 아니요 ✅ 예
저장 프로시저 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
Proc 매개 변수 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
Functions ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
Collections ✖️ 아니요 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
필드 매핑 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예

엔터티 권한

Feature SQL 제품군 Cosmos DB PGSQL MySQL SQLDW 을(를)
Create ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
REad ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Update ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Delete ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Execute ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
필드 포함 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
필드 제외 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예

데이터베이스 정책

Feature SQL 제품군 Cosmos DB PGSQL MySQL SQLDW 을(를)
Create ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
REad ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
Update ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
Delete ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
Execute ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
Single-Table 정책 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
다중 테이블 정책 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
요청 정책 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요

인증 기능

Feature SQL 제품군 Cosmos DB PGSQL MySQL SQLDW 을(를)
UAMI(엔트라 ID) ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
SAMI(엔타 ID) ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure EasyAuth ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
통과 보안 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
API 키 보안 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요

기타 기능

Feature SQL 제품군 Cosmos DB PGSQL MySQL SQLDW 을(를)
네이티브 JSON 지원 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
네이티브 XML 지원 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
네이티브 벡터 지원 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
Application Insights ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Log Analytics ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
파일 로깅 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
세션 컨텍스트 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
여러 데이터 원본 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
원본 간 조인 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
OpenTelemetry ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
상태 엔드포인트 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
사용자 지정 로그 수준 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
.NET 갈망 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
MCP 은 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예

MCP 서버

비고

MCP 서버 기능을 사용하려면 Data API Builder 버전 1.7 이상이 필요합니다.

Feature SQL 제품군 Cosmos DB PGSQL MySQL SQLDW 을(를)
DML 도구: CREATE ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
DML 도구: 읽기 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
DML 도구: UPDATE ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
DML 도구: DELETE ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
DML 도구: EXECUTE ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
DML 도구: DESCRIBE ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
저장 프로시저를 도구로 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
서버 지침 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
개체 메타데이터 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
필드 메타데이터 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
매개 변수 메타데이터 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
읽기: 페이지 매김 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
읽기: $Select ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
읽기: $Filter ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
읽기: $Count ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
읽기: $OrderBy ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
읽기: $First ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
읽기: $After ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예

Azure 지원(컨테이너)

Feature SQL 제품군 Cosmos DB PGSQL MySQL SQLDW 을(를)
Azure Container Apps (Azure 컨테이너 애플리케이션) ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure 컨테이너 인스턴스 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure Kubernetes Services ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure 컨테이너용 웹 앱 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure Red Hat OpenShift ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure Spring Apps ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure 서비스 패브릭 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure Virtual Machine ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예

지원되지 않는 데이터 형식

데이터 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 시스템 클록을 기준으로 하는 현재 시간입니다.

NoSQL용 Azure Cosmos DB

NoSQL용 Azure Cosmos DB는 스키마에 구애받지 않으므로 데이터 형식 제한은 관계형 데이터베이스와 동일한 방식으로 적용되지 않습니다.

각주

1 SQLDW는 전용 SQL 풀에 대한 지원만 반영합니다. 서버리스 SQL 풀은 지원되지 않습니다.

² Cosmos DB는 GraphQL을 통해 DAB에서 지원됩니다. NoSQL용 API는 네이티브 REST API를 제공하므로 DAB는 Cosmos DB에 대한 REST 엔드포인트를 생성하지 않습니다. 자세한 내용은 Azure Cosmos DB: REST API 참조를 참조하세요.

MCP(모델 컨텍스트 프로토콜)는 데이터베이스별 기능이 아닌 엔드포인트 수준 기능입니다.

관리 ID 지원은 SAMI(System-Assigned) 및 UAMI(User-Assigned) 관리 ID를 모두 지원하는 Azure DefaultAzureCredential를 사용합니다. UAMI를 사용하려면 환경 변수를 AZURE_CLIENT_ID 설정해야 합니다.

⚠️ Cosmos DB 돌연변이에 대한 부분 적인 것은 기본 만들기, 업데이트 및 삭제 작업이 지원된다는 것을 의미하지만 모든 돌연변이 유형(예: 다중 돌연변이)을 사용할 수 있는 것은 아닙니다.