다음을 통해 공유

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

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

데이터베이스 버전

Database Abbreviation 분. 버전
SQL Server MSSQL 버전 2016
Azure SQL 데이터베이스 MSSQL N/A(PaaS)
Azure SQL Managed Instance(애저 SQL 매니지드 인스턴스) MSSQL N/A(PaaS)
Azure VM 위의 SQL Server MSSQL 버전 2016
Arc로 최적화된 SQL 서버 MSSQL 버전 2016
패브릭의 SQL 데이터베이스 MSSQL N/A(PaaS)
NoSQL용 Azure Cosmos DB COSMOSDB N/A(PaaS)
PostgreSQL PGSQL 버전 11
Azure Database for PostgreSQL 유연한 서버 PGSQL 버전 11
MySQL MySQL 버전 8
Azure Database for MySQL 유연한 서버 MySQL 버전 5.7
Azure Synapse Analytics(전용 SQL 풀) DWSQL N/A(PaaS)

기본 트랜잭션 격리 수준

데이터 API 작성기에서는 다음과 같은 기본 트랜잭션 격리 수준을 사용합니다.

데이터베이스 유형 격리 수준 추가 정보
Microsoft SQL 커밋된 읽기 Azure SQL
PostgreSQL 커밋된 읽기 PostgreSQL
MySQL 반복 가능한 읽기 MySQL

클라우드 및 호스팅 환경

데이터 API 작성기 컨테이너 지원을 사용 하는 모든 환경에서 실행 합니다. 다음은 일반적인 클라우드 배포 대상입니다.

환경 지원됨
Microsoft Azure ✅ 예
Amazon Web Services(AWS) ✅ 예
Google Cloud Platform(GCP) ✅ 예
다른 클라우드 공급자 ✅ 예
On-premises ✅ 예

GraphQL

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

GraphQL 관계 탐색

Feature MSSQL 코스모스 PGSQL MySQL DWSQL
one-To-Many/Query ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
1To-Many / 돌연변이 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
다-To-Many/ 쿼리 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
다-To-Many / 돌연변이 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
원본 간 관계 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
원본 간 조인 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요

REST

Feature MSSQL Cosmos² PGSQL MySQL DWSQL
PUT ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
POST ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
PATCH ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
DELETE ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
GET ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
페이지 매김 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
OData와 유사 $Select ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
OData와 유사 $Filter ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
OData와 유사 $Count ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
OData와 유사 $OrderBy ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
OData와 유사 $First ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
$After (커서 페이징) ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
OpenAPI 문서 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
Swagger UI ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
권한 인식 OpenAPI ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
고급 REST 경로 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
키 없는 PUT 및 PATCH ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
캐시 헤더 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
수준 1 캐시: 메모리 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
수준 2 캐시: Redis ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
POCO 준비 페이로드 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
OpenAPIReference ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요

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

Feature MSSQL 코스모스 PGSQL MySQL DWSQL
Tables ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
Views ✅ 예 ✖️ 아니요 ✅ 예 ✖️ 아니요 ✅ 예
저장 프로시저 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
Proc 매개 변수 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
Functions ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
Collections ✖️ 아니요 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
필드 매핑 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예

엔터티 권한

Feature MSSQL 코스모스 PGSQL MySQL DWSQL
Create ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
REad ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Update ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Delete ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Execute ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
필드 포함 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
필드 제외 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예

데이터베이스 정책

Feature MSSQL 코스모스 PGSQL MySQL DWSQL
Create ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
REad ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
Update ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
Delete ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
Execute ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
Single-Table 정책 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
다중 테이블 정책 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
요청 정책 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요

인증 기능

Feature MSSQL 코스모스 PGSQL MySQL DWSQL
UAMI(엔트라 ID) ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
SAMI(엔타 ID) ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure EasyAuth ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
On-Behalf-Of(OBO) ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
인증되지 않은 공급자 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
역할 상속 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
API 키 보안 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요

기타 기능

Feature MSSQL 코스모스 PGSQL MySQL DWSQL
네이티브 JSON 지원 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
네이티브 XML 지원 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
네이티브 벡터 지원 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
자동 구성 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
HTTP 응답 압축 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Application Insights ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Log Analytics ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
파일 로깅 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
세션 컨텍스트 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
여러 데이터 원본 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
원본 간 조인 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
OpenTelemetry ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
상태 엔드포인트 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
사용자 지정 로그 수준 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
.NET 갈망 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
MCP 은 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예

MCP 서버

비고

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

Feature MSSQL 코스모스 PGSQL MySQL DWSQL
DML 도구: CREATE ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
DML 도구: 읽기 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
DML 도구: UPDATE ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
DML 도구: DELETE ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
DML 도구: EXECUTE ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
DML 도구: DESCRIBE ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
저장 프로시저를 도구로 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
사용자 지정 MCP 도구 ✅ 예 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✅ 예
서버 지침 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
개체 메타데이터 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
필드 메타데이터 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
매개 변수 메타데이터 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
읽기: 페이지 매김 ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
읽기: $Select ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
읽기: $Filter ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
읽기: $Count ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요 ✖️ 아니요
읽기: $OrderBy ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
읽기: $First ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예
읽기: $After ✅ 예 ✖️ 아니요 ✅ 예 ✅ 예 ✅ 예

컨테이너 오케스트레이션 플랫폼

데이터 API 작성기에서는 컨테이너 런타임 또는 오케스트레이션 플랫폼에서 실행됩니다. 일반적인 플랫폼은 다음과 같습니다.

플랫폼 지원됨
ACA(Azure Container Apps) ✅ 예
ACI(Azure Container Instances) ✅ 예
AKS(Azure Kubernetes Service) ✅ 예
AWS ECS(Elastic Container Service) ✅ 예
AWS EKS(Elastic Kubernetes Service) ✅ 예
GKE(Google Kubernetes Engine) ✅ 예
Kubernetes(모든 배포) ✅ 예
Docker ✅ 예
다른 모든 컨테이너 런타임 ✅ 예

Azure 배포 서비스

Feature MSSQL 코스모스 PGSQL MySQL DWSQL
Azure Container Apps (Azure 컨테이너 애플리케이션) ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure 컨테이너 인스턴스 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure Kubernetes 서비스 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure 컨테이너용 웹 앱 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure Red Hat OpenShift ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure Spring Apps ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure 서비스 패브릭 ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예
Azure Virtual Machine ✅ 예 ✅ 예 ✅ 예 ✅ 예 ✅ 예

지원되지 않는 데이터 형식

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

NoSQL용 Azure Cosmos DB

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

각주

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

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

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

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

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

  • Last updated on