이 문서에서는 GraphQL용 Microsoft Fabric API의 현재 제한 사항에 대해 자세히 설명합니다.
제한
Microsoft Fabric의 GraphQL용 API에 대한 현재 일반 제품 제한 사항은 이 문서에 나와 있습니다. 새로운 기능을 사용하여 GraphQL용 API를 지속적으로 개선하고 있습니다. Microsoft Fabric의 미래에 대한 자세한 내용은 Fabric 로드맵참조하세요.
액세스에 SQL Analytics 엔드포인트를 활용하는 모든 데이터 원본은 이에 대한 읽기 작업만 지원합니다. 예를 들어, Lakehouses 또는 미러된 데이터베이스에는 돌연변이를 사용할 수 없습니다.
현재 기본 페이지 크기는 100입니다. 즉, 모든 요청이 회신에 최대 100개의 요소를 반환합니다. 결과 세트가 100개 이상인 경우 GraphQL 페이지네이션을 사용하여 결과를 순차적으로 탐색합니다.
최대 페이지 매김 크기는 100,000입니다. 즉, 요청이 반환하는 최대 요소 수가 고정되어 반복할 수 있습니다. 애플리케이션에 대해 100K 이상의 요소를 반환해야 하는 경우 여러 요청을 실행합니다. 이 패턴은 GraphQL에서 일반적이지 않다는 것을 이해합니다.
지원되는 최대 회신 크기는 64MB입니다. 즉, 회신 크기가 64MB보다 큰 API 요청은 오류를 반환합니다. 이 제한을 해결하려면 필터링된 여러 요청을 실행할 수 있습니다.
저장 프로시저에 대한 제한 사항(Azure SQL, 패브릭의 SQL Database 및 데이터 웨어하우스에 적용됨):
- 저장 프로시저에서 반환된 첫 번째 결과 집합만 GraphQL용 API에서 사용됩니다.
- sys.dm_exec_describe_first_result_set에 의해 설명된 첫 번째 결과 집합의 메타데이터를 가진 저장 프로시저만 지원됩니다.
- 구성 파일과 URL 쿼리 문자열 모두에서 저장 프로시저 매개 변수를 지정하면 URL 쿼리 문자열의 매개 변수가 우선적으로 적용됩니다.
- 저장 프로시저로 지원되는 엔터티는 테이블이나 뷰로 지원되는 엔터티에 자동으로 제공되는 모든 기능을 갖추고 있지는 않습니다.
- 저장 프로시저 지원 엔터티는 페이지 매김, 순서 지정 또는 필터링을 지원하지 않습니다. 또한 이러한 엔터티는 기본 키 값으로 지정된 항목 반환을 지원하지 않습니다.
요청 시간 제한은 현재 100초입니다. 즉, 완료하는 데 100초보다 긴 데이터 원본 쿼리를 생성하는 요청을 실행하면 요청이 실패하고 오류가 발생할 수 있습니다.
지원되는 최대 쿼리 깊이는 10입니다. 쿼리 깊이는 쿼리의 필드 중첩 수준이며, 잠재적 재귀 및 과도한 데이터 가져오기로 인해 너무 깊으면 성능에 영향을 미칠 수 있습니다.
알려진 문제
GraphQL용 API의 알려진 문제에 대해 알아보려면 Microsoft Fabric 알려진 문제를 방문하세요.