GraphQL용 API

 

GraphQL용 API

 

웨어하우스 등 Microsoft Fabric의 데이터 원본은 분석을 위한 환경이지만 간혹 응용프로그램에서 데이터를 표시하거나 변경할 수 있도록 해야 할 경우가 있습니다. Fabric SQL 데이터베이스, 웨어하우스 등 Microsoft Fabric의 데이터 원본을 응용프로그램에서 액세스하려면, API 서버를 구축 및 개발과 보안 구성을 통해 데이터를 표시하거나 변경할 수 있지만 시간이 걸리고 복잡한 작업이 됩니다.

GraphQL용 API를 통해 애플리케이션을 빠르고 쉽게 Microsoft Fabric의 데이터 원본에 연결할 수 있습니다. GraphQL용 API는 간단한 쿼리 언어와 결과 집합을 통해 애플리케이션이 데이터 원본에 액세스하게 해줍니다. 별도 서버를 구축하지 않고도 쉽게 데이터를 확인할 수 있도록 데이터 액세스 계층을 제공합니다.

 

Fabric 용량에서는 GraphQL용 API 항목을 생성할 수 있으며, SQL 데이터베이스에서는 상단 메뉴로 GraphQL용 API를 생성할 수 있도록 제공하고 있습니다.

GraphQL용 API에서 지원하는 데이터 원본은 Fabric SQL 데이터베이스, 레이크하우스의 SQL 분석 엔드포인트, 미러링 데이터베이스의 SQL 분석 엔드포인트 등이 있습니다.

 

이번 글에서는 간략히 GraphQL용 API를 생성하여 테스트 환경에서 데이터를 쿼리해보겠습니다.

Fabric 용량의 작업 영역에서 새 항목을 클릭하여, GraphQL용 API를 선택하고 이름을 입력합니다. 데이터 원본을 연결할 수 있습니다.

 

데이터 원본에 연결하기 위한 자격증명으로 SSO 인증과 저장된 자격증명을 선택할 수 있습니다. 여기에서는 SSO 인증을 선택합니다.

 

OneLake 카탈로그에서 데이터 원본을 선택하고 테이블을 선택할 수 있습니다.

테이블을 선택하면 GraphQL용 API 편집기를 확인할 수 있습니다. 편집기의 탐색기에서는 테이블, 쿼리(Queries), 변형(Mutations)를 확인할 수 있습니다. 변형(Mutations)을 통해 애플리케이션에서 데이터를 변경할 수 있습니다. 쿼리에서 직접 구문을 생성하고 결과를 확인할 수 있습니다.

 

여기에서는 간략히 테이블의 데이터를 조회하는 쿼리를 작성하여 결과를 확인해보겠습니다. GraphQL용 API의 세부 쿼리 구문은 여기에서 확인할 수 있습니다.

 

코드 생성(Generate Code)를 클릭하면 개발환경의 Python 코드를 확인할 수 있습니다.

 

GraphQL용 Fabric API에 애플리케이션 연결하려면 클라이언트 ID, 테넌트 ID 및 Fabric의 GraphQL 엔드포인트 주소라는 세 가지 중요한 정보가 필요하며, 인증에 Microsoft Entra를 사용해야 합니다. 애플리케이션을 등록하고 적절하게 구성하는 작업을 수행해야 합니다.

개발환경에서 Python 코드를 실행해보면 데이터를 확인할 수 있습니다.

 

 

애플리케이션을 SQL 데이터베이스 등 Microsoft Fabric의 데이터 원본에 쉽게 연결할 때 사용이 가능한 GraphQL용 API를 간략히 확인해보았습니다.