GraphQL용 Fabric API 질문과 대답

GraphQL은 API용 오픈 소스 쿼리 언어이자 기존 데이터로 해당 쿼리를 수행하기 위한 런타임입니다. GraphQL은 강력한 형식의 시스템으로 API의 데이터에 대해 완전하고 이해하기 쉬운 설명을 제공하고, 클라이언트에 필요한 것을 정확하게 요청할 수 있는 기능을 제공하고, 시간이 지남에 따라 API를 더욱 쉽게 향상시키고, 강력한 개발자 도구를 지원합니다.

GraphQL용 Microsoft Fabric API는 Microsoft Fabric 데이터 웨어하우스, Microsoft Fabric Lakehouses, Microsoft Fabric 미러된 데이터베이스, Microsoft Fabric SQL Database 및 Azure SQL Database와 같은 데이터 원본의 데이터에 액세스하기 위해 몇 초 만에 GraphQL API를 만들 수 있는 관리 서비스입니다. 지원되는 이러한 데이터 원본에서 데이터를 쿼리하고 변경하기 위한 Unified API 레이어를 제공합니다. GraphQL용 Fabric API는 현재 프리뷰로 제공됩니다.

현재 GraphQL 쿼리(읽기) 및 변형(쓰기)만 지원됩니다. SQL 분석 엔드포인트를 통해 노출되는 데이터 원본은 읽기 전용이므로 쿼리만 지원합니다. 데이터 웨어하우스의 경우 변형이 자동으로 생성되도록 하려면 기본 키를 정의해야 합니다.

확인자는 API의 필드를 확인하고 데이터 원본에 있는 데이터로 작업을 수행하는 비즈니스 논리를 제공하는 GraphQL 구성 요소입니다. Fabric은 새 데이터 원본을 연결하거나 기존 데이터 원본에서 노출할 새 개체를 선택할 때마다 확인자를 자동으로 생성합니다. 현재는 해결 프로그램을 사용자 지정할 수 없습니다. GraphQL용 API에서 사용자 지정된 비즈니스 논리의 경우 데이터 원본에 저장 프로시저를 만들고 GraphQL API에 노출할 수 있습니다.

GraphQL용 API를 사용하려면 애플리케이션에서 인증에 Microsoft Entra를 사용해야 합니다. 패브릭에 대해 API 호출을 실행하려면 클라이언트 애플리케이션을 적절하게 등록하고 구성해야 합니다. Microsoft Entra에 등록된 앱에는 Power BI 서비스 Item.Execute.All 권한이 필요합니다. 자세한 내용은 Azure에서 Microsoft Entra 앱 만들기를 참조하세요. Microsoft Entra 외에도 API가 SSO(Single Sign-On)를 사용하도록 구성된 경우 GraphQL API를 호출하는 앱의 인증된 사용자 또는 서비스 주체는 GraphQL API와 데이터 원본 모두에 대한 액세스 권한이 필요합니다. 보다 구체적으로 GraphQL API에서 쿼리 및 변경 권한을 실행하고 그에 따라 선택한 데이터 원본에 필요한 읽기 또는 쓰기 액세스 권한을 실행합니다. 또 다른 옵션은 API 및 데이터 원본 항목이 둘 다 있는 기여자 역할을 가진 작업 영역 멤버로 사용자 또는 서비스 주체를 두는 것입니다. 그러면 한 곳에서 두 항목 모두에 필요한 액세스 권한이 제공됩니다. 자세한 내용은 사용자에게 작업 영역에 대한 액세스 권한 부여를 참조하세요. 또는 API가 저장된 자격 증명을 사용하도록 구성된 경우 인증된 사용자 또는 서비스 주체가 API에 액세스할 수 있어야 합니다(API에 직접 액세스 권한을 추가할 때 쿼리 및 변형 실행 옵션 선택). Connect 애플리케이션에서 사용자 보안 주체와 서비스 주체 모두에 대한 샘플 코드가 포함된 엔드 투 엔드 예제를 찾을 수 있습니다.

GraphQL용 Fabric API와 관련된 문제에 대한 Microsoft 지원 도움을 받으려면 Fabric 지원 사이트를 방문하여 데이터 엔지니어 옵션을 선택합니다.

GraphQL용 API는 현재 미국 서부 3 지역에서 지원되지 않습니다.

관련 콘텐츠

GraphQL용 Microsoft Fabric API란 무엇인가요?