GraphQL용 Microsoft Fabric API의 제한 사항
이 문서에서는 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초보다 긴 데이터 원본 쿼리를 생성하는 요청을 실행하면 요청이 실패하고 오류가 발생할 수 있습니다.
알려진 문제
GraphQL용 API의 알려진 문제에 대해 알아보려면 Microsoft Fabric 알려진 문제를 방문하세요.