일반적으로 묻는 GraphQL용 Fabric API 질문에 대한 답변을 찾습니다.
GraphQL이란 무엇인가요?
GraphQL은 앱이 필요한 데이터를 정확하게 요청할 수 있도록 하는 API에 대한 쿼리 언어입니다. 강력한 형식 시스템을 사용하여 사용 가능한 데이터를 명확하게 설명하고, 정확한 요청을 허용하여 오버페치를 줄이고, 기존 코드를 중단하지 않고 API 업데이트를 더 쉽게 만들고, 광범위한 개발자 도구 집합을 사용할 수 있습니다. 애플리케이션이 서버 및 데이터베이스와 통신하는 보다 효율적인 방법입니다.
GraphQL용 Microsoft Fabric 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 작업은 무엇인가요?
현재 GraphQL 쿼리(읽기) 및 변형(쓰기)만 지원됩니다. SQL 분석 엔드포인트를 통해 노출되는 데이터 원본은 읽기 전용이므로 쿼리만 지원합니다. 데이터 웨어하우스의 경우 변경이 자동으로 생성되려면 기본 키를 정의해야 합니다.
GraphQL용 Fabric API에서 확인자를 보고 편집하려면 어떻게 해야 하나요?
확인자는 API의 필드를 확인하고 데이터 원본에 있는 데이터로 작업을 수행하는 비즈니스 논리를 제공하는 GraphQL 구성 요소입니다. Fabric은 새 데이터 원본을 연결하거나 기존 데이터 원본에서 노출할 새 개체를 선택할 때마다 확인자를 자동으로 생성합니다. 현재는 해결 프로그램을 사용자 지정할 수 없습니다. GraphQL용 API에서 사용자 지정된 비즈니스 논리의 경우 데이터 원본에 저장 프로시저를 만들고 GraphQL API에 노출할 수 있습니다.
API for GraphQL 클라이언트 애플리케이션은 쿼리 또는 변형을 수행하기 위해 데이터 원본에 대한 액세스 권한이 필요합니까?
GraphQL용 API를 사용하려면 애플리케이션에서 인증에 Microsoft Entra ID를 사용해야 합니다. 패브릭에 대해 API 호출을 실행하려면 클라이언트 애플리케이션을 적절하게 등록하고 구성해야 합니다. Microsoft Entra에 등록된 앱에는 Power BI 서비스에 대한 GraphQLApi.Execute.All 권한이 필요합니다. 자세한 내용은 Azure에서 Microsoft Entra 앱 만들기를 참조하세요. Microsoft Entra 외에도 API가 SSO(Single Sign-On)를 사용하도록 구성된 경우 GraphQL API를 호출하는 앱의 인증된 사용자 또는 서비스 주체는 GraphQL API와 데이터 원본 모두에 대한 액세스 권한이 필요합니다. 보다 구체적으로 GraphQL API에서 쿼리 및 변경 권한을 실행하고 그에 따라 선택한 데이터 원본에 필요한 읽기 또는 쓰기 액세스 권한을 실행합니다. 또 다른 옵션은 API 및 데이터 원본 항목이 모두 있는 기여자 역할을 가진 작업 영역 멤버로 사용자 또는 서비스 주체를 두는 것입니다. 그러면 한 곳에서 두 항목 모두에 필요한 액세스 권한이 부여됩니다. 자세한 내용은 사용자에게 작업 영역에 대한 액세스 권한 부여를 참조하세요. 또는 API가 저장된 자격 증명을 사용하도록 구성된 경우 인증된 사용자 또는 서비스 주체가 API에 액세스할 수 있어야 합니다(API에 직접 액세스 권한을 추가할 때 쿼리 및 변형 실행 옵션 선택). Connect 애플리케이션에서 사용자 보안 주체와 서비스 주체 모두에 대한 샘플 코드가 포함된 엔드 투 엔드 예제를 찾을 수 있습니다.
GraphQL용 API에 대한 지원 티켓을 열 어떻게 할까요? 있나요?
GraphQL용 Fabric API와 관련된 문제에 대한 Microsoft 지원 도움을 받으려면 Fabric 지원 사이트를 방문하여 데이터 엔지니어 옵션을 선택합니다.
API for GraphQL에서 아직 지원되지 않는 지역은 무엇입니까?
GraphQL용 API는 현재 미국 서부 3 지역에서 지원되지 않습니다.
GraphQL용 API는 Private Link를 지원하나요?
GraphQL용 API는 현재 Private Link를 지원하지 않습니다. 그러나 향후 이 기능을 지원할 계획이며 업데이트가 제공될 예정입니다.
패브릭 테넌트에 대해 Private Link를 사용하도록 설정했습니다. GraphQL 항목이 작동하지 않는 이유는 무엇인가요?
테넌트 설정 "공용 인터넷 액세스 차단"이 사용하도록 설정된 경우(즉, 공용 액세스가 비활성화됨) GraphQL용 API를 포함하여 지원되지 않는 아티팩트 또는 항목이 자동으로 비활성화됩니다. 즉, 이전에 만든 항목에 액세스할 수 없으며 새 항목도 만들 수 없습니다. 이러한 항목에 액세스하는 유일한 방법은 공용 액세스를 허용하는 것입니다.
처음 발급할 때 내 요청이 제대로 수행되지 않는 이유는 무엇인가요?
이 동작에는 두 가지 주요 이유가 있습니다. 첫째, 데이터 원본이 콜드인 경우 준비해야 하는 경우 첫 번째 요청이 더 오래 걸릴 수 있습니다. 데이터 원본이 콜드되지 않더라도 데이터 원본에 필요한 데이터가 메모리에 로드되지 않은 경우 GraphQL에서 쿼리를 처음 발급할 때 데이터 검색이 효율적이지 않을 수 있습니다. 두 번째 이유는 시스템에서 요청을 수락할 준비가 되도록 스키마 및 구성을 로드해야 하기 때문에 GraphQL 엔드포인트에 대한 API에 대한 첫 번째 요청이 더 오래 걸릴 수 있기 때문입니다. 이는 일회성 비용이며, 시스템이 이미 준비되고 요청을 처리할 준비가 되었기 때문에 후속 요청이 더 빠릅니다.
GraphQL용 API에 대한 피드백 또는 제안을 제공하려면 어떻게 해야 하나요?
여러분의 피드백과 제안을 환영합니다! 패브릭 아이디어 통해 피드백을 제공할 수 있습니다. 우리 팀은 이 플랫폼을 통해 제출된 피드백과 제안을 적극적으로 모니터링합니다. 또한 특정 쿼리 또는 문제에 대한 Microsoft Fabric 지원 통해 연락할 수 있습니다.