파워 쿼리 SDK를 사용하여 커넥터 개발
파워 쿼리 SDK는 파워 쿼리 커넥터를 만드는 데 도움이 되도록 설계된 도구 집합입니다. 이러한 커넥터를 사용자 지정 커넥터 또는 파워 쿼리 확장이라고도 합니다.
사용자 지정 커넥터를 사용하면 새 데이터 원본을 만들거나 기존 원본을 사용자 지정하고 확장할 수 있습니다. 일반 사용 사례는 다음과 같습니다.
- REST API에 대한 비즈니스 분석가 친화적인 보기 만들기
- 기존 커넥터(예: OData 서비스 또는 ODBC 드라이버)를 사용하여 파워 쿼리에서 지원하는 원본에 대한 브랜딩을 제공합니다.
- SaaS 제품에 대한 OAuth v2 인증 흐름 구현
- 데이터 원본에 대해 제한되거나 필터링된 뷰를 노출하여 유용성을 향상시킵니다.
- ODBC 드라이버를 사용하여 데이터 원본에 DirectQuery를 사용하도록 설정합니다.
파워 쿼리 SDK 설치
Visual Studio Marketplace의 Visual Studio Code 섹션에서 Visual Studio Code 파워 쿼리 SDK를 설치합니다. 설치를 선택하여 SDK를 설치합니다.
커넥터 개발 프로세스
다음 섹션에서는 SDK를 사용하여 파워 쿼리 커넥터를 만드는 가장 일반적인 프로세스를 개략적으로 설명합니다.
새 확장 만들기
새 작업 영역(Visual Studio Code 파워 쿼리 SDK)을 만들 때 다음 핵심 파일로 시작합니다.
- 커넥터 정의 파일(<connectorName.pq>)
- 쿼리 파일(<connectorName.query.pq>)
- 문자열 리소스 파일(resources.resx)
- 아이콘을 만드는 데 사용되는 다양한 크기의 PNG 파일
커넥터 정의 파일은 빈 데이터 원본 설명으로 시작합니다. 데이터 액세스 처리에 대한 문서에서 파워 쿼리 SDK의 컨텍스트에서 데이터 원본에 대해 자세히 알아볼 수 있습니다.
테스트
파워 쿼리 SDK는 기본 쿼리 실행 기능을 제공하므로 다른 클라이언트 애플리케이션으로 전환하지 않고도 확장을 테스트할 수 있습니다. 다음과 같은 애플리케이션에서 커넥터를 추가로 테스트할 수 있습니다.
쿼리 테스트 파일
확장 파일 외에도 데이터 커넥터 프로젝트에는 쿼리 파일(name.query.pq)이 있을 수 있습니다. 이 파일을 사용하여 Visual Studio Code 내에서 테스트 쿼리를 실행할 수 있습니다. 쿼리 평가에는 확장 코드에서 공유 함수를 호출하거나 테스트할 수 있도록.pqx 파일을 등록할 필요 없이 확장 코드가 자동으로 포함됩니다.
쿼리 파일에는 단일 식(예: HelloWorld.Contents()파워 쿼리에서 생성하는 식) let 또는 섹션 문서가 포함될 수 있습니다.
빌드 및 배포
프로젝트를 빌드하면 .mez 파일 또는 확장명 파일이 생성됩니다. 파워 쿼리 확장명은 ZIP 파일에 번들로 제공되고 .mez 파일 확장명은 제공됩니다.
확장은 M 섹션 문서 내에서 정의됩니다. 섹션 문서는 파워 쿼리에서 생성된 쿼리 문서와 약간 다른 형식입니다. 파워 쿼리에서 가져오는 코드는 일반적으로 섹션 문서에 맞게 수정해야 하지만 변경 내용은 약간 다릅니다. 알아야 할 섹션 문서 차이점은 다음과 같습니다.
- 섹션 선언(예:
section HelloWorld;)으로 시작합니다. - 각 식은 세미콜론(예:
a = 1;또는b = let c = 1 + 2 in c;)으로 끝납니다. - 모든 함수와 변수는 공유로 표시되지 않는 한 섹션 문서에 로컬입니다. 공유 함수는 다른 쿼리/함수에 표시되며 확장에 대한 내보내기(즉, 파워 쿼리에서 호출 가능해짐)로 간주할 수 있습니다.
M 섹션 문서에 대한 자세한 내용은 M 언어 사양에서 확인할 수 있습니다.
파워 쿼리 커넥터 배포
커넥터를 배포할 수 있는 두 가지 경로가 있습니다.
- 자체 배포
- 커넥터 인증
자체 배포
해당 제품 환경에서 파워 쿼리 사용자 지정 커넥터를 적용할 수 있는 셀프 서비스 메커니즘
커넥터를 만들면 사용자에게 원하는 대로 이 파일을 보낼 수 있으며 Microsoft Power BI와 같은 해당 제품 환경에서 커넥터를 사용할 수 있습니다.
Microsoft Power BI
Microsoft Power BI Desktop 및 Microsoft Power BI Service for Semantic 모델에서 사용자 지정 커넥터를 사용하여 클라우드에서 새로 고침 및 연결을 수행할 수 있습니다.
파워 쿼리 커넥터는 다음 세 가지 환경으로 로드할 수 있습니다.
- 온-프레미스 데이터 게이트웨이: Microsoft Fabric 및 Microsoft Power BI 서비스 사용할 게이트웨이를 통해 커넥터를 로드할 수 있습니다.
- 파워 쿼리 온라인: Power BI Datamarts, Fabric Dataflow Gen2 등의 환경 내에서
- 파워 쿼리 데스크톱: Power BI Desktop과 같은 환경 내에서.
아래 문서를 사용하여 자체 배포에 사용자 지정 커넥터를 사용하는 방법에 대해 자세히 알아볼 수 있습니다.
커넥터 인증
Data Factory 커넥터 인증 프로그램을 사용하면 Microsoft에서 Microsoft Fabric 및 Microsoft Power BI 내에서 커넥터를 게시하고 배포하여 해당 제품 및 환경을 관리하는 인증을 위해 커넥터를 Microsoft에 제출할 수 있습니다.
- 파워 쿼리 데스크톱: Microsoft Power BI Desktop.
- 파워 쿼리 온라인: Microsoft Fabric Dataflow Gen2, Microsoft Fabric Warehouse, Microsoft Power BI Datamarts, Microsoft Power BI Dataflow Gen1 등
- 온-프레미스 데이터 게이트웨이: 인증된 새로 고침 또는 연결에 게이트웨이를 사용하는 Microsoft Fabric 및 Microsoft Power BI의 경우.
Data Factory 커넥터 인증 프로그램에 대해 자세히 알아봅니다.