파워 쿼리 커넥트or 인증

참고 항목

이 문서에서는 인증을 위해 파워 쿼리 사용자 지정 커넥터를 제출하기 위한 요구 사항 및 프로세스를 설명합니다. 인증 프로세스를 시작하기 전에 전체 문서를 자세히 읽어보세요.

소개

파워 쿼리 SDK를 사용하면 모든 사용자가 파워 쿼리에서 데이터 원본에 연결하는 사용자 지정 파워 쿼리 커넥터를 만들 수 있습니다. 현재 사용자 지정 커넥터는 Power BI 의미 체계 모델(Power BI Desktop 및 Power BI 서비스)에서만 지원되며 온-프레미스 데이터 게이트웨이를 사용하여 Power BI 서비스 새로 고쳐야 합니다. 사용자 지정 커넥터는 개발자가 개별적으로 배포해야 합니다.

데이터 원본에 대한 사용자 지정 커넥터를 개발하는 데이터 원본 소유자는 사용자 지정 커넥터를 파워 쿼리 사용자에게 보다 광범위하게 배포하려고 할 수 있습니다. 최종 사용자가 사용자 지정 커넥터를 만들고, 사용하고, 유효성을 검사하면 데이터 원본 소유자가 Microsoft 인증을 위해 제출할 수 있습니다.

파워 쿼리 사용자 지정 커넥터를 인증하면 Power BI 의미 체계 모델(Power BI Desktop 및 Power BI 서비스), Power BI 데이터 흐름 및 Power BI 데이터 마트 내에서 커넥터를 기본적으로 공개적으로 사용할 수 있습니다. 인증된 커넥터는 PowerBI.com 모든 버전의 Power BI Premium에서 지원됩니다.

인증된 커넥터는 다음과 같습니다.

• 파트너 개발자가 유지 관리

• 파트너 개발자가 지원합니다.

• Microsoft에서 인증

• Microsoft에서 배포

Microsoft는 파트너와 협력하여 기본 테넌트에서 지원을 받고 있는지 확인하지만 커넥터 자체의 고객 문제는 파트너 개발자에게 전달됩니다.

인증된 커넥터 및 사용자 지정 커넥터 차이점

인증된 커넥터는 Power BI Desktop에서 기본 제공으로 번들로 제공되며 Power BI 서비스, Power BI 데이터 흐름 및 Power BI 데이터 마트에 배포됩니다. 사용자 지정 커넥터는 Power BI 의미 체계 모델에서만 지원되며 Power BI Desktop에서 확장 로드에 설명된 대로 Power BI Desktop에서 로드해야 합니다. 인증된 커넥터와 사용자 지정 커넥터는 모두 테스트커넥트ion을 구현하여 온-프레미스 데이터 게이트웨이를 사용하여 Power BI Desktop 또는 Power BI Service를 통해 새로 고칠 수 있습니다. 사용자 지정 커넥터에는 온-프레미스 데이터 게이트웨이가 필요합니다.

구현이 있는 Power BI Desktop TestConnection 의 인증된 커넥터는 온-프레미스 데이터 게이트웨이 없이도 클라우드(Power BI 서비스)를 통한 엔드투엔드 새로 고침을 지원합니다. Power BI 서비스 환경은 기본적으로 온-프레미스 게이트웨이와 유사하게 실행되는 "클라우드 게이트웨이"를 호스트합니다. 인증 후에는 모든 Power BI 고객이 사용할 수 있도록 커넥터를 이 환경에 배포합니다.

추가 구성 요소(예: ODBC 드라이버)가 있는 사용자 지정 커넥터와 인증된 커넥터는 모두 최종 사용자 컴퓨터에 추가 구성 요소를 설치해야 하며 추가 구성 요소가 Power BI 클라우드에 배포되지 않는 한 온-프레미스 데이터 게이트웨이가 필요합니다. 현재는 Power BI 클라우드에 새 추가 구성 요소를 인증하고 배포하지 않으므로 추가 구성 요소에 대한 종속성이 있는 커넥터 인증은 온-프레미스 데이터 게이트웨이 요구 사항을 제거하지 않습니다.

사용자 지정 커넥터 배포

사용자 지정 커넥터는 인증 전에 최종 사용자에게 배포할 수 있고 배포되어야 합니다.

M은 처리 인증에서 볼 수 있듯이 저장된 자격 증명과 상호 작용할 수 있는 용량을 갖는 다용도 언어이므로 신뢰할 수 있는 커넥터만 실행할 수 있는 방법을 사용자에게 제공해야 합니다.

개발자의 관점에서 개발자는 사용자 지정 커넥터에 자체 서명 하고 사용자에게 정보(지문)를 제공하여 안전하게 로드해야 합니다.

사용자의 관점에서 사용자는 개발자의 지문을 사용하여 사용할 사용자 지정 커넥터를 안전하게 신뢰하고 로드해야 합니다. 또는 사용자가 Microsoft 또는 다른 개발자가 인증하지 않은 코드 로드를 허용하도록 보안 설정을 낮출 수 있지만 이 옵션은 권장되지 않습니다.

인증 개요

필수 조건

고객에게 최상의 환경을 보장하기 위해 인증을 위한 필수 구성 요소 집합을 충족하는 커넥터만 고려합니다.

• 커넥터는 퍼블릭 제품용이어야 합니다.

• 커넥터는 초기 릴리스 버전에 대한 코드 완성으로 간주되어야 합니다. 이 프로그램을 사용하면 자주 반복 및 업데이트할 수 있습니다. Microsoft는 기술 지원 또는 사용자 지정 커넥터 개발 컨설팅을 제공하지 않습니다. SDK 설명서 및 샘플 리포지토리와 같은 공용 리소스를 활용하는 것이 좋습니다. 추가 지원이 필요한 경우 Microsoft 프로그램 또는 파트너 관계와 별도로 직접 참여할 수 있는 알려진 타사 업계 사용자 지정 커넥터 개발 컨설턴트 목록을 공유할 수 있습니다. Microsoft는 이러한 컨설턴트와 제휴하지 않으며 사용자의 서비스 사용에 대해 책임을 지지 않습니다. Microsoft는 사용자의 편의를 위해 보증, 권장 사항 또는 보장 없이 목록을 제공합니다. 자세한 내용은 Microsoft 인증 담당자에게 문의하세요.

• 개발자는 예상 사용량을 제공해야 합니다. 매우 부티크 제품에 대한 커넥터 개발자는 커넥터 자체 서명 기능을 사용하여 고객에게 직접 제공하는 것이 좋습니다.

• 커넥터는 사용자 요구 또는 비즈니스 시나리오를 충족하기 위해 고객이 직접 사용할 수 있어야 합니다. 이 조건은 자체 서명을 통해 완성된 커넥터를 최종 사용자 및 조직에 직접 배포하여 프라이빗 미리 보기 프로그램을 사용하여 충족할 수 있습니다. 각 사용자 또는 조직은 커넥터에 대한 비즈니스 요구 사항이 있고 커넥터가 비즈니스 요구 사항을 충족하기 위해 성공적으로 작동하고 있다는 피드백과 유효성 검사를 제공할 수 있어야 합니다.

• 커넥터는 고객의 예상 사용 수준에서 성공적으로 작동해야 합니다.

• Power BI Desktop에서 커넥터를 공개적으로 사용할 수 있도록 요구 사항을 나타내기 위해 고객이 주도하는 Power BI Ideas 포럼 에 스레드가 있어야 합니다. 참여의 설정된 임계값은 없습니다. 그러나 참여도가 높을수록 커넥터에 대한 입증된 수요가 더 강합니다.

이러한 필수 구성 요소는 인증을 받는 커넥터가 중요한 고객 및 비즈니스 요구 사항을 사용하고 인증 후 지원하도록 하기 위해 존재합니다.

프로세스 및 타임라인

인증된 커넥터는 매월 Power BI Desktop 릴리스와 함께 릴리스되므로 각 릴리스의 최종 기한은 각 Power BI Desktop 릴리스 날짜에서 다시 작동합니다. 등록에서 릴리스까지 인증 프로세스의 예상 기간은 커넥터 제출의 품질 및 복잡성에 따라 달라집니다. Microsoft는 커넥터 검토 및 승인과 관련하여 특정 타임라인 보장을 제공하지 않습니다. 각 커넥터 검토의 하드 기한은 다음 단계에 설명되어 있지만 Microsoft는 이러한 타임라인 준수를 보장하지 않습니다.

• 등록: 사용자 지정 커넥터를 인증하려는 의도 알림입니다. 이 등록은 대상 Power BI 데스크톱 릴리스 2개월 전인 월 15일까지 발생해야 합니다.

  • 예를 들어 4월 Power BI Desktop 릴리스의 최종 기한은 2월 15일입니다.

• 제출: Microsoft 검토를 위한 커넥터 파일 제출 이 제출은 대상 Power BI 데스크톱 릴리스 이전의 월 1일까지 수행해야 합니다.

  • 예를 들어 4월 Power BI Desktop 릴리스의 최종 기한은 3월 1일입니다.

• 기술 검토: 커넥터 파일의 완료, Microsoft 검토 및 인증 통과. 이 검토는 대상 Power BI Desktop 릴리스 이전 달 15일까지 수행해야 합니다.

  • 예를 들어 4월 Power BI Desktop 릴리스의 최종 기한은 3월 15일입니다.

기술 검토의 복잡성과 잠재적인 지연, 재설치 및 테스트 문제로 인해 초기 릴리스 및 인증을 위해 긴 리드 타임으로 조기에 제출하는 것이 좋습니다. 최소한의 오버헤드로 몇 명의 고객에게 커넥터를 제공하는 것이 중요하다고 생각되는 경우 자체 서명하고 이러한 방식으로 제공하는 것이 좋습니다.

인증 요구 사항

인증에 대한 특정 요구 사항 집합이 있습니다. 모든 개발자가 이러한 요구 사항을 충족할 수 있는 것은 아니라는 것을 알고 있으며, 개발자의 요구를 짧은 순서로 처리할 수 있는 기능 집합을 도입하려고 합니다.

제출 파일(아티팩트)

제출하는 커넥터 파일에 다음이 모두 포함되어 있는지 확인합니다.

• 커넥트or(.mez) 파일

  • .mez 파일은 스타일 표준을 따라야 하며 제품 또는 서비스 이름과 비슷하게 이름을 지정해야 합니다. "Power BI", "커넥트or" 또는 "API"와 같은 단어는 포함하지 않아야 합니다.
  • .mez 파일의 이름을 지정합니다. ProductName.mez

• 테스트를 위한 Power BI Desktop(.pbix) 파일

  • 커넥터를 테스트하려면 샘플 Power BI 보고서(.pbix)가 필요합니다.
  • 보고서에는 탐색 테이블의 각 항목을 테스트하는 쿼리가 하나 이상 포함되어야 합니다.
  • 설정된 스키마(예: 데이터베이스)가 없는 경우 보고서에는 커넥터가 처리할 수 있는 테이블의 각 "형식"에 대한 쿼리가 포함되어야 합니다.

• 데이터 원본에 대한 계정 테스트

  • 테스트 계정을 사용하여 커넥터를 테스트하고 문제를 해결합니다.
  • 영구 테스트 계정을 제공하므로 동일한 계정을 사용하여 향후 업데이트를 인증할 수 있습니다.

• 테스트 지침

  • 커넥터를 사용하고 해당 기능을 테스트하는 방법에 대한 설명서를 제공합니다.

• 외부 종속성에 대한 링크(예: ODBC 드라이버)

기능 및 스타일

커넥터는 다른 인증된 커넥터와 일치하는 유용성 표준을 충족하려면 기능 및 스타일 규칙 집합을 따라야 합니다.

• 커넥터는 다음을 수행해야 합니다.

  • 섹션 문서 형식을 사용합니다.
  • 섹션 문서 위에 버전 머리글/장식을 포함합니다.
  • 함수 설명서 메타데이터를 제공합니다.
  • Test커넥트ion 처리기가 있습니다.
  • 명명 규칙(예: DataSourceKind.FunctionName)을 따릅니다. "Power BI", "커넥트or" 또는 "API"와 같은 단어는 포함하지 않아야 합니다.
  • 초기 릴리스에서 베타 플래그를 True로 설정합니다.

• FunctionName do기본(예: "Contents", "Tables", "Document", "Databases" 등)에 적합해야 합니다.

• 커넥터는 다음을 수행해야 합니다.

  • 아이콘이 있습니다.
  • 탐색 테이블을 제공합니다.
  • 파일에 문자열을 resources.resx 배치합니다. URL 및 값은 커넥터 코드에서 하드 코딩되어야 하며 파일에 배치 resources.resx 되지 않아야 합니다.

보안

커넥터에서 처리해야 하는 특정 보안 고려 사항이 있습니다.

• 사용되는 경우 Extension.CurrentCredentials() :

  • 사용이 필요한가요? 그렇다면 자격 증명을 어디로 보내나요?
  • HTTPS를 통해 요청이 보장되나요?
    • HTTPS 적용 도우미 함수를 사용할 수 있습니다.
  • GET을 통해 Web.Contents() 자격 증명을 보내는 경우:
    • POST로 전환할 수 있나요?
    • GET이 필요한 경우 커넥터는 옵션 레코드의 CredentialQueryString 레코드를 Web.Contents() 사용하여 중요한 자격 증명을 전달해야 합니다.

• Diagnostics.* 함수가 사용되는 경우:

  • 추적 중인 내용의 유효성을 검사합니다. 데이터에 는 PII 또는 많은 양의 불필요한 데이터가 포함되어서는 안 됩니다.
  • 개발에서 중요한 추적을 구현한 경우 추적을 켜야 하는지 여부를 결정하는 변수 또는 기능 플래그를 구현해야 합니다. 인증을 위해 제출하기 전에 이 추적을 해제해야 합니다.

• 사용되는 경우 Expression.Evaluate() :

  • 식의 원본 위치와 식의 유효성을 검사합니다(즉, 호출을 동적으로 생성할 Extension.CurrentCredentials() 수 있습니다).
  • Expression 사용자가 제공되거나 사용자 입력을 받아서는 안 됩니다.
  • 동적 Expression 이 아니어야 합니다(즉, 웹 호출에서 검색됨).

인증 등록

사용자 지정 커넥터의 인증을 추구하는 데 관심이 있는 경우 시나리오 및 커넥터가 이 문서에 설명된 필수 구성 요소 및 요구 사항을 충족하는지 확인합니다. 이렇게 하지 않으면 인증을 진행하기 전에 문제가나 불일치를 해결해야 하기 때문에 인증이 지연됩니다.

커넥터가 코드가 완료되고 Power BI Desktop의 작성과 Power BI 서비스의 새로 고침 및 사용 모두에서 테스트되었는지 확인합니다. 온-프레미스 데이터 게이트웨이를 사용하여 Power BI 서비스에서 전체 엔드투엔드 새로 고침을 테스트했는지 확인합니다.

시작하려면 등록 양식을 작성하면 Microsoft 연락처가 연락하여 프로세스를 시작합니다.

인증 후

Power BI Desktop 및 Power BI 서비스 통해 커넥터를 인증하고 릴리스한 후에는 프로덕션 배포된 공개적으로 사용 가능한 인증된 커넥터를 올바르게 사용할 수 있도록 하기 위해 수행해야 하는 몇 가지 작업이 있습니다.

• 사용자와 최종 사용자는 Power BI Desktop 및 온-프레미스 데이터 게이트웨이에 포함된 인증된 커넥터 버전을 사용하고 인증 전에 사용된 기존 .mez 또는 .pqx 파일(사용자 지정 커넥터)을 제거해야 합니다. 이렇게 하지 않으면 새로 인증된 커넥터 대신 실수로 파워 쿼리에서 테스트 사용자 지정 커넥터를 사용할 수 있습니다.
• 사용자 지정 커넥터는 새 버전의 커넥터를 테스트하는 데만 사용해야 합니다.
• 최종 사용자 및 고객과 함께 작업할 때 테스트가 완료되고 새 인증된 커넥터 버전을 사용할 수 있게 되면 인증 전에 테스트에 사용되는 사용자 지정 커넥터 버전을 제거해야 한다는 것을 이해해야 합니다.

템플릿 앱(권장)

데이터 원본에 대한 커넥터를 개발한 후에는 템플릿 앱을 만들어 고객이 빠르게 시작하고 실행할 수 있도록 돕는 것이 좋습니다. 템플릿 앱은 고객이 기본 제공 보고서를 사용하거나 필요에 따라 사용자 지정할 수 있도록 데이터에 연결된 미리 빌드된 보고서를 제공합니다.

참고 항목

템플릿 앱은 게이트웨이가 필요한 커넥터를 지원하지 않습니다.