파워 쿼리 SDK 테스트 프레임워크 참조
이 다중 파트 참조는 파워 쿼리 커넥터 개발자를 위한 표준 테스트 제품군의 설정 및 실행에 대해 설명합니다. 참조는 사용자 환경이 확장 커넥터 테스트를 위해 설정되었는지 확인하기 위해 순차적으로 수행되어야 합니다.
이 참조는 파워 쿼리 SDK 테스트 프레임워크, 표준화된 테스트 제품군 및 수정된 버전의 NewYork City Taxi &Limousine Commission(TLC) 녹색 여정 레코드 데이터를 사용합니다. 후속 섹션에서는 확장 커넥터의 유효성을 검사하기 위해 환경을 설정하는 단계를 안내합니다.
테스트 프레임워크를 사용하면 파워 쿼리 SDK 개발자가 표준 테스트 및 테스트 도구에 액세스하여 확장 커넥터의 DQ(DirectQuery) 기능을 확인할 수 있습니다. 이 새로운 기능을 통해 개발자는 커넥터를 확인하는 표준 방법과 사용자 지정 테스트를 추가하기 위한 플랫폼을 사용할 수 있습니다. 이를 파워 쿼리 SDK에서 제공하는 테스트 워크플로의 생산성을 향상시키는 첫 번째 단계로 구상합니다.
파워 쿼리 SDK 테스트 프레임워크란?
파워 쿼리 SDK 테스트 프레임워크는 새 확장 커넥터와 기존 확장 커넥터의 테스트를 표준화하기 위해 미리 빌드된 테스트를 포함하는 즉시 사용 가능한 테스트 도구입니다. 기능, 규정 준수 및 회귀 테스트를 대규모로 수행할 수 있습니다. 확장 커넥터의 요구를 충족하기 위해 포괄적인 테스트 프레임워크의 필요성을 해결하는 데 도움이 됩니다.
개발자를 위한 워크플로
다음 목록은 테스트 프레임워크를 사용한 일반적인 파워 쿼리 SDK 개발자 워크플로입니다.
- 파워 쿼리 SDK Visual Studio Code 확장 설치: 커넥터 개발자는 확장 커넥터를 개발하기 위해 PowerQuery SDK Visual Studio Code 확장을 설치해야 합니다. Visual Studio Code 확장은 테스트 하네스 PQTest.exe 포함하는 Microsoft.PowerQuery.SdkTools NuGet 패키지를 래핑합니다. PQTest 테스트 도구에는 테스트 프레임워크에 있는 테스트를 실행하는 새 비교 명령이 포함되어 있습니다.
- Data커넥트ors GitHub 리포지토리 복제: 데이터커넥트ors GitHub 리포지토리를 복제하여 테스트 프레임워크에 포함된 테스트 데이터 및 테스트에 액세스합니다. 이러한 테스트에 대한 자세한 내용은 PowerQuery SDK 테스트 프레임워크 파트 3 - 테스트 제품군으로 이동하세요.
- 데이터 원본에 테스트 데이터 로드: 커넥터 개발자는 두 개의 CSV 파일로 구성된 테스트 데이터를 데이터 원본에 테이블로 로드하여 스키마가 제공된 SQL 스키마 파일과 일치하도록 해야 합니다. 자세한 내용은 파워 쿼리 SDK 테스트 프레임워크 파트 2 - 테스트 데이터로 이동합니다.
- 테스트 구성 및 실행: 커넥터 개발자는 PQTest 비교 명령을 사용하여 테스트를 실행하는 제공된 RunPQSDKTestSuites PowerShell 유틸리티를 사용하여 테스트를 실행해야 합니다. 자세한 내용은 Power Query SDK 테스트 프레임워크 5부 - 확장 커넥터 테스트로 이동합니다.
- 보고 CI/CD: 기본 테스트 보고서는 콘솔에서 생성되며 요약, 상세, TRX 및 JSON 형식으로 보고서를 생성하는 옵션도 있습니다. TRX(Visual Studio 테스트 결과 파일) 형식은 파이프라인의 일부로 실행되면 결과를 보는 데 유용합니다. 자세한 내용은 파워 쿼리 SDK 테스트 프레임워크 7부 - 파이프라인 가이드로 이동하세요.
테스트 프레임워크의 목표
파워 쿼리 SDK 테스트 프레임워크의 장기 목표는 Visual Studio Code SDK와 통합된 강력한 테스트 솔루션을 제공하여 확장 커넥터를 테스트하는 것입니다. 커넥터 개발을 위한 개발자 환경을 크게 향상시켜야 합니다. 또한 표준화를 오히려 조각화된 테스트 사례로 가져와서 결국 품질 표시줄을 늘리고 커넥터의 지속적인 노력을 줄여야 합니다. 또한 커넥터 인증 프로세스에 연결하고 파트너의 환경을 향상시키기 위한 테스트 프레임워크를 구상하고 있습니다.
테스트 프레임워크 초기 릴리스의 목표는 다음을 제공하는 것입니다.
- 사용자가 확장 커넥터를 쉽게 테스트할 수 있도록 명령줄 유틸리티를 사용하기 쉽습니다. 테스트 프레임워크는 테스트를 실행하는 직관적인 옵션과 함께 PQTest 비교 명령을 도입합니다. 또한 일괄 테스트에도 도움이 되는 RunPQSDKTestSuites PowerShell 유틸리티를 제공합니다. 테스트를 구성하고 실행하기 위한 쉽고 자동 구성이 제공됩니다.
- 커넥터를 확인하기 위해 실행할 표준 테스트의 준비 완료 초기 집합: 테스트 프레임워크는 테스트 테이블의 스키마, 행 수 및 데이터의 유효성을 검사하는 정신 테스트 모음을 제공합니다. 또한 데이터 형식, 수학, 날짜, 시간, 텍스트 함수, 연산자 및 조인을 확인하는 표준 테스트 도구 모음을 제공합니다.
- 테스트를 확장하기 위해 테스트를 수동으로 추가하는 간편한 방법: 테스트 프레임워크의 테스트는 필요한 구성을 최소화하여 테스트 만들기 프로세스를 간소화하는 새 PQ/PQOut 테스트 형식을 사용합니다. 커넥트 개발자는 테스트를 위해 M 쿼리를 만드는 데 집중할 수 있습니다. 각 테스트는 모듈식이며 기본 테넌스를 간소화하기 위해 개별 파일로 구분됩니다. 예상 출력은 첫 번째 실행에서도 생성됩니다.
- 쿼리 폴딩 테스트를 테스트하는 기능: 테스트 프레임워크는 커넥터에 대한 진단 생성할 수도 있습니다. 현재 진단 기능은 ODBC 기반 커넥터에 대한 쿼리 폴딩 중에 SQL 쿼리 생성으로 제한됩니다. 이 기능은 향후 다른 진단 확장될 예정입니다.
참조 가이드 개요
이 가이드에서는 다음을 수행합니다.
- 파워 쿼리 SDK 테스트 프레임워크를 이해합니다.
- 테스트 프레임워크를 설치하여 개발 환경을 설정하는 방법을 알아봅니다.
- 테스트 도구 모음에서 사용되는 데이터 세트를 가져와 확장 커넥터를 기반으로 데이터 원본에 업로드합니다.
- 테스트 프레임워크 내에서 파일 형식 및 해당 기능인 테스트 형식 사양을 이해합니다.
- 확장 커넥터의 유효성을 검사하기 위한 테스트가 포함된 테스트 제품군을 가져오고 실행합니다.
- 다양한 구성으로 개별 테스트를 실행합니다.
- 고유한 테스트를 추가하여 커넥터 관련 기능을 확인합니다.
- 테스트에 대한 파이프라인을 설정하여 테스트 실행을 자동화합니다.
부분
| 요소 | section | 세부 정보 |
|---|---|---|
| 1 | 설치 | 환경을 설정합니다. |
| 2 | 데이터 준비 | 테스트 데이터 준비 |
| 3 | 테스트 도구 모음 | 테스트 도구 모음을 가져오고 이해합니다. |
| 4 | 테스트 형식 사양 | 테스트 프레임워크에서 사용되는 다양한 파일 형식 이해 |
| 5 | 커넥트or 테스트 | 확장 커넥터 테스트 |
| 6 | 테스트 추가 | 고유한 테스트를 추가하고 테스트 프레임워크의 다양한 옵션 및 구성을 이해합니다. |
| 7 | 파이프라인 설정 가이드 | 파이프라인에서 테스트 실행 |