다음을 통해 공유

Data Factory 커넥터 인증

  • 아티클

Important

커넥터 인증 프로그램은 현재 변경되고 있으며 새 커넥터 인증에 대한 등록은 현재 보류 중입니다. 2025년 1분기에 이 등록 프로세스를 다시 활성화할 계획입니다. 업데이트하려는 인증된 커넥터가 있는 경우 새 버전을 제출하는 방법에 대한 지침을 Microsoft 팀에 dataconnectors@microsoft.com 문의하세요.

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

Data Factory 커넥터를 인증하면 다음과 같은 환경에서 커넥터를 공개적으로, 기본 제공, Microsoft Fabric Data Factory 및 Microsoft Power BI에서 사용할 수 있습니다.

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI Dataflow Gen1
  • Microsoft Power BI Datamart
  • Microsoft Power BI 의미 체계 모델(Power BI 서비스)
  • Microsoft Power BI Desktop
  • Microsoft Fabric 및 Microsoft Power BI용 온-프레미스 데이터 게이트웨이

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

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

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

  • Microsoft에서 인증

  • Microsoft에서 배포

Microsoft는 파트너와 협력하여 유지 관리에 대한 지원이 있는지 확인하지만 커넥터 자체의 고객 문제는 파트너 개발자에게 전달됩니다.

참고 항목

현재 파워 쿼리 SDK를 활용하여 Data Factory 커넥터 인증 프로그램을 통해 인증할 수 있는 커넥터를 만들 수 있습니다. 파워 쿼리 SDK 개요로 이동하여 이 도구에 대해 자세히 알아보세요.

인증 개요

필수 조건

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

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

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

  • 개발자는 현재 및 향후 사용량에 대한 예상을 제공해야 합니다.

  • 커넥터는 사용자 요구 또는 비즈니스 시나리오를 충족하기 위해 고객이 직접 사용할 수 있어야 합니다. 완성된 커넥터를 최종 사용자 및 조직에 직접 배포하여 미리 보기 프로그램을 사용하여 이 조건을 충족할 수 있습니다. 커넥터 개발자는 자체 배포 메커니즘을 사용하고 자체 커넥터의 내부 테스트를 실행하여 제어된 그룹에서 해당 커넥터를 반복하는 것이 좋습니다. 각 사용자 또는 조직은 커넥터에 대한 비즈니스 요구 사항이 있고 커넥터가 비즈니스 요구 사항을 충족하기 위해 성공적으로 작동하고 있다는 피드백과 유효성 검사를 제공할 수 있어야 합니다.

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

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

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

인증 요구 사항

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

기능 및 스타일

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

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

    • 섹션 문서 형식을 사용합니다.
    • 섹션 문서 위에 버전 머리글/장식을 포함합니다.
    • 함수 설명서 메타데이터를 제공합니다.
    • TestConnection 처리기가 있습니다.
    • 명명 규칙(예: DataSourceKind.FunctionName)을 따릅니다. "Fabric", "Power BI", "Connector" 또는 "API"와 같은 단어는 포함하지 않아야 합니다.
    • 관계형 데이터 원본에 대해 열이 있는 테이블로 구성된 테이블 형식으로 데이터를 반환합니다. 큐브, 차원 및 측정값을 기반으로 하는 다차원 형식은 지원되지 않습니다.
    • 가져오기 및 DirectQuery 모드에서 동일하게 동작하여 동일한 결과를 반환합니다.
    • 초기 릴리스에서 베타 플래그를 True로 설정합니다.

  • 도메인에 FunctionName 적합해야 합니다(예: "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 동적이면 안 됩니다(즉, 웹 호출에서 검색됨).

인증 후

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

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