첫 번째 커넥터 만들기: 헬로 월드
이 샘플에서는 Visual Studio Code에서 실행하고 Power BI Desktop에서 로드할 수 있는 간단한 데이터 원본 확장을 제공합니다.
헬로 월드 샘플
개요로 이 샘플은 다음을 보여줍니다.
- 옵션 텍스트 매개 변수를 사용하는 내보내기 함수(
HelloWorld.Contents)입니다. - 다음과 같은 데이터 원본 종류를 정의합니다.
- 암시적(익명) 인증을 사용한다고 선언합니다.
- 지역화를 허용하는 문자열 리소스를 사용합니다.
- 확장이 Power BI Desktop 데이터 가져오기 대화 상자에 표시되도록 UI 메타데이터를 선언합니다.
PowerQuery SDK 설치의 지침에 따라 "HelloWorld"라는 새 커넥터를 만들고, 다음 M 코드에 복사하여 커넥터 작업 영역의 HelloWorld.pq 파일에 붙여넣은 다음, 나머지 지침에 따라 Power BI에서 열 수 있습니다.
다음 커넥터 정의에서 찾을 수 있습니다.
- 문입니다
section. - 종류
HelloWorld및 게시HelloWorld.Publish를 사용하여 데이터 원본 정의로 설정하는 메타데이터가 있는 데이터 원본 함수입니다. Authentication암시적(익명)이 이 원본에 대한 유일한 인증 유형임을 선언하는 레코드입니다.- 이 연결이 베타에 있음을 선언하는 게시 레코드, resx 파일, 원본 이미지 및 원본 형식 이미지에서 로드할 텍스트입니다.
- 빌드 폴더의 특정 PNG와 아이콘 크기를 연결 하는 레코드입니다.
section HelloWorld;
[DataSource.Kind="HelloWorld", Publish="HelloWorld.Publish"]
shared HelloWorld.Contents = (optional message as text) =>
let
message = if (message <> null) then message else "Hello world"
in
message;
HelloWorld = [
Authentication = [
Implicit = []
],
Label = Extension.LoadString("DataSourceLabel")
];
HelloWorld.Publish = [
Beta = true,
ButtonText = { Extension.LoadString("FormulaTitle"), Extension.LoadString("FormulaHelp") },
SourceImage = HelloWorld.Icons,
SourceTypeImage = HelloWorld.Icons
];
HelloWorld.Icons = [
Icon16 = { Extension.Contents("HelloWorld16.png"), Extension.Contents("HelloWorld20.png"), Extension.Contents("HelloWorld24.png"), Extension.Contents("HelloWorld32.png") },
Icon32 = { Extension.Contents("HelloWorld32.png"), Extension.Contents("HelloWorld40.png"), Extension.Contents("HelloWorld48.png"), Extension.Contents("HelloWorld64.png") }
];
파일을 빌드하고 올바른 디렉터리에 복사한 후 PowerQuery SDK 설치 자습서의 지침에 따라 Power BI를 엽니다. "hello"를 검색하여 데이터 가져오기 대화 상자에서 커넥터를 찾을 수 있습니다.
이 단계에서는 인증 대화 상자를 표시합니다. 인증 옵션이 없고 함수는 매개 변수를 사용하지 않으므로 이러한 대화 상자에는 더 이상 단계가 없습니다.
커넥트 누르면 쿼리에서 true로 설정되므로 대화 상자에서 "미리 보기 커넥터"Beta라는 것을 알 수 있습니다. 인증이 없으므로 인증 화면에는 필드가 없는 익명 인증 탭이 표시됩니다. 커넥트 다시 눌러 마칩니다.
마지막으로 쿼리 편집기가 "Hello world" 텍스트를 반환하는 함수인 예상한 내용을 표시합니다.
완전히 구현된 샘플은 데이터 커넥트ors 샘플 리포지토리의 헬로 월드 샘플을 참조하세요.