파워 쿼리 SDK 개요

아티클
05/22/2024

이 문서의 목적은 Visual Studio Code용 파워 쿼리 SDK 내에서 찾은 전반적인 기능 및 개발 환경에 대한 개요를 제공하는 것입니다.

새 프로젝트 만들기

팁

확장 프로젝트를 만들기 전에 확장 프로젝트를 저장할 새 폴더를 만드는 것이 좋습니다. 새 프로젝트를 만드는 동안 폴더가 선택되지 않은 경우 파워 쿼리 SDK는 확장 프로젝트를 만들기 전에 새 폴더를 찾거나 만드는 데 도움이 됩니다.

Visual Studio Code에서 Visual Studio Code의 기본 탐색기 창에는 파워 쿼리 SDK라는 이름의 섹션이 있습니다. 이 섹션에는 확장 프로젝트 만들기를 읽는 단추가 하나만 있습니다. 이 단추를 선택합니다.

Visual Studio Code에서 새 확장 프로젝트 단추를 만듭니다.

이 단추는 Visual Studio Code 인터페이스의 맨 위에 입력 필드를 엽니다. 새 확장 프로젝트의 이름을 입력한 다음 Enter 키를 선택합니다.

새 확장 프로젝트를 만들고 프로젝트의 이름을 지정합니다.

몇 초 후 Visual Studio Code 창에서 커넥터 논리가 포함된 확장 프로젝트에 대한 기본 *.pq 파일이 열립니다. 파워 쿼리 SDK는 작업 영역 설정을 완료하는 데 필요한 몇 가지 작업을 자동으로 실행합니다. Visual Studio Code의 출력 콘솔에서 이러한 작업을 확인할 수 있습니다.

헬로 월드 템플릿을 사용하여 만든 확장 프로젝트입니다.

파워 쿼리 SDK는 다음 파일 집합을 자동으로 만듭니다.

작업 영역 수준에서 작업할 특정 설정을 지정하는 settings.json 파일입니다.
확장을 .mez 파일로 빌드하고 새 bin\AnyCPU\Debug 폴더에 저장합니다.
.png 파일인 커넥터 아이콘 집합입니다.
확장에 사용되는 문자열의 기본 스토리지 역할을 하는 resources.resx 파일입니다.
확장 또는 커넥터의 기본 논리를 포함하는 .pq 파일입니다.
나중에 평가할 수 있는 테스트 쿼리를 만드는 방법으로 주요 용도로 사용되는 .query.pq 파일입니다.
확장 프로젝트에 대한 정보를 포함하는 .proj 파일입니다.

커넥터 파일 목록입니다.

Visual Studio Code에서 확장 프로젝트를 인식하면 파워 쿼리 SDK 섹션의 모양이 변경되고 이제 새 확장 프로젝트에 대해 실행할 수 있는 작업 목록이 표시됩니다.

파워 쿼리 SDK 섹션 내의 작업입니다.

자격 증명

Important

데이터 커넥터의 쿼리를 평가하려면 먼저 확장 프로젝트에 대한 자격 증명 집합을 만들어야 합니다.

파워 쿼리 SDK는 확장 프로젝트에서 자격 증명을 설정, 나열 및 삭제할 수 있도록 사용자 인터페이스를 통해 여러 작업을 제공합니다.

자격 증명 설정

파워 쿼리 SDK는 주로 여러 진입점을 통해 트리거될 수 있는 작업에 의해 구동됩니다. 자격 증명 설정은 두 가지 방법으로 수행할 수 있습니다(다른 자격 증명 작업은 동일한 방식으로 수행할 수 있습니다).

탐색기 창의 파워 쿼리 SDK 섹션에 있는 항목을 통해
터미널을 통해 작업 실행 옵션을 선택한 다음 자격 증명 설정 작업을 선택합니다.

이 작업을 실행하면 Visual Studio Code에서 자격 증명을 설정할 수 있도록 일련의 프롬프트를 안내합니다. 이러한 일련의 프롬프트는 예측 가능하며 항상 동일한 단계로 구성됩니다.

데이터 원본 종류를 선택합니다.
커넥터 파일을 선택합니다.
인증 방법 선택

기존 확장 프로젝트의 경우 사용 가능한 인증 방법은 익명입니다. 인증이 설정되면 자격 증명이 성공적으로 생성되었음을 확인하는 메시지가 창의 오른쪽 아래 모서리에 표시됩니다.

자격 증명이 성공적으로 생성되었습니다.

자격 증명 나열

자격 증명을 설정하는 것과 마찬가지로 자격 증명을 나열하는 작업에는 탐색기 창의 파워 쿼리 SDK 섹션과 터미널 메뉴의 두 진입점이 있습니다.

이 작업이 실행되면 출력 터미널 내에서 사용 가능한 자격 증명을 보여 줍니다.

출력 콘솔 내에 나열된 자격 증명입니다.

ALL 자격 증명 지우기

이전 두 작업과 마찬가지로 모든 자격 증명을 지우는 작업에는 탐색기 창의 파워 쿼리 SDK 섹션과 터미널 메뉴의 두 진입점이 있습니다.

이 작업은 쿼리를 평가하기 위해 새 자격 증명을 설정해야 하는 경우 현재 세션에서 모든 자격 증명을 지우는 방법으로 사용됩니다.

이 작업에 대한 정보 메시지는 출력 콘솔에도 표시됩니다.

ALL 자격 증명 지우기 작업에 대한 정보 메시지입니다.

쿼리 및 결과 패널 평가

테스트 쿼리를 평가하려면 먼저 자격 증명을 설정해야 합니다. 이전 섹션에서 만든 커넥터를 사용하여 테스트 쿼리 파일 역할을 하는 파일을 열 *.query.pq 수 있습니다.

프로젝트 이름이 MyConnector인 이 특정 커넥터의 경우 코드는 다음과 같습니다.

// Use this file to write queries to test your data connector
let
    result = MyConnector.Contents()
in
    result

쿼리를 평가하기 전에 다음과 같이 코드를 변경해 보겠습니다.

// Use this file to write queries to test your data connector
let
    result = MyConnector.Contents("Hello World")
in
    result

코드를 변경한 후 파일을 저장해야 합니다.

이 쿼리를 평가하려면 다음 세 가지 옵션이 있습니다.

사용 중인 파일을 마우스 오른쪽에 선택하고 현재 파워 쿼리 파일 평가 옵션을 선택합니다.

현재 파일을 마우스 오른쪽 단추로 클릭하여 평가합니다.

터미널 메뉴를 살펴보고 현재 파일 평가 작업을 선택합니다.

터미널 메뉴 환경에서 현재 파일 평가 작업을 선택합니다.

Visual Studio Code에서 네이티브 실행 및 디버그 옵션을 사용하고 하이퍼링크를 선택하여 launch.json 파일을 만든 다음 파일을 평가합니다.

실행 및 디버그 확장성을 통해 쿼리를 평가하는 launch.json 파일을 만듭니다.

쿼리를 평가한 후 결과는 창 아래쪽의 콘솔과 오른쪽의 결과 패널이라는 새 패널에 표시됩니다.

평가가 완료된 후 Visual Studio Code 창에서 콘솔 및 결과 패널의 출력을 표시합니다.

결과 패널에는 다음 세 개의 탭이 있습니다.

출력 탭: 평가된 쿼리의 데이터 미리 보기를 표시합니다. 데이터가 테이블인 경우 표로 표시됩니다.
요약: 평가를 실행한 활동의 요약과 해당 활동과 관련된 통계를 표시합니다.
DataSource: 평가에 사용되는 데이터 원본에 대한 일반 정보를 표시합니다.

다른 쿼리를 평가하려면 *.query.pq 파일을 수정하고 저장한 다음 세 가지 방법 중 한 가지 방법으로 평가 작업을 다시 실행하면 됩니다.

참고 항목

파워 쿼리 SDK는 평가에 대한 모든 종류의 캐싱 메커니즘을 관리하지 않습니다.

새 SDK에 레거시 확장 프로젝트 가져오기

이 섹션은 레거시 Visual Studio 기반 파워 쿼리 SDK를 사용하여 만든 확장 프로젝트가 있는 커넥터 개발자에게 도움이 됩니다.

따라서 TripPin 샘플, 특히 샘플 9-TestConnection에 대한 DataConnectors 리포지토리에서 사용할 수 있는 커넥터 프로젝트를 다운로드하는 것이 좋습니다.

레거시 확장 프로젝트를 새 SDK로 가져오려면 다음 단계를 수행합니다.

Visual Studio Code에서 파일>열기 폴더를 선택한 다음 확장 프로젝트가 있는 폴더로 이동합니다.
다음 두 가지 방법 중 하나를 사용하여 기존 폴더 및 해당 콘텐츠를 사용하여 작업 영역을 설정합니다.
- 파워 쿼리 SDK에는 폴더의 내용을 인식하는 메커니즘이 있으며 새 파워 쿼리 SDK 작업 영역으로의 변환을 사용하도록 설정하는 것이 좋습니다.
- 터미널 메뉴에서 설치 작업 영역 및 빌드 작업을 실행합니다. 이렇게 하면 작업 영역에 필요한 .mez 파일과 settings.json 파일이 효과적으로 생성됩니다.

두 개의 새 폴더와 파일이 추가되면 현재 작업 영역이 새 파워 쿼리 SDK 작업 영역으로 변환됩니다.

확장 프로젝트를 새 파워 쿼리 SDK로 업그레이드합니다.

작업 영역 설정

작업 영역 설정 태스크는 평가 및 일반 설정과 관련하여 작업 영역에 사용할 일부 변수를 지시하는 작업 영역에 대한 settings.json 파일을 효과적으로 만드는 것입니다.

확장 파일 빌드

빌드 작업을 사용하면 요청 시 확장 프로그램에 대한 .mez 파일을 만들 수 있습니다.

TestConnection 함수 실행

TestConnection은 Power BI와 같은 서비스를 통해 Microsoft 클라우드에서 커넥터를 새로 고칠 수 있도록 하는 함수입니다. 커넥터 데이터 원본 레코드 내에 구현된 레코드입니다. 테스트 연결에 사용할 수 있는 샘플에서 TestConnection 처리기의 구현에 대해 자세히 알아볼 수 있습니다.

TestConnection을 실행하는 작업을 사용하면 Microsoft Cloud에서 이 처리기를 수동으로 시도하지 않고도 파워 쿼리 SDK 내에서 처리기를 테스트할 수 있습니다.

이 작업을 실행하려면 먼저 커넥터에 대한 자격 증명을 설정한 다음 탐색기의 파워 쿼리 SDK 섹션 또는 터미널 메뉴 내의 작업 목록을 통해 작업을 실행합니다.

이 작업의 결과는 창 아래쪽의 출력 터미널에 표시됩니다.

파워 쿼리 SDK에서 TestConnection 실행 함수의 결과입니다.

피드백 및 버그

사용자 지정 커넥터를 개발하는 데 도움이 필요하거나 보고하려는 피드백, 제안 또는 버그가 있는 경우 GitHub의 공식 퍼블릭 리포지토리 방문하세요.

Power BI 커뮤니티 포럼을 사용하여 파워 쿼리, M 언어 및 사용자 지정 커넥터 개발에 대한 일반적인 질문을 게시할 수도 있습니다.

다음을 통해 공유