다음을 통해 공유

메타데이터 검사 실행

  • 아티클

다음 간단한 연습에서는 스캐너 API를 사용하여 조직의 Fabric 항목에서 메타데이터를 검색하는 방법을 보여줍니다. Fabric 관리자가 조직에서 메타데이터 검사를 설정했다고 가정합니다.

메타데이터 검사에서 반환하는 아티팩트 및 하위 아티팩트 메타데이터의 목록은 관리자 - WorkspaceInfo GetScanResult API 설명서를 참조하세요.

다음은 스캐너 API입니다. 퍼블릭 클라우드와 소버린 클라우드를 모두 지원합니다.

Important

검사를 위해 개발하는 앱은 표준 위임된 관리자 액세스 토큰 또는 서비스 주체를 사용하여 인증할 수 있습니다. 두 가지 인증 경로는 상호 배타적입니다. 서비스 주체에서 실행하는 경우 앱에 Power BI 관리자의 동의가 필요한 권한이 설정되어 이지 않아야 합니다. 자세한 내용은 읽기 전용 관리 API에 대한 서비스 주체 인증 사용을 참조하세요.

1단계: 전체 검사 수행

modifiedSince 매개 변수 없이 workspaces/modified를 호출하여 테넌트에서 작업 영역 ID의 전체 목록을 가져옵니다. 이 검사는 개인 작업 영역 및 공유 작업 영역을 비롯한 테넌트의 모든 작업 영역이 검색됩니다. 검사에서 개인 작업 영역을 제외하려면 workspaces/modified excludePersonalWorkspaces 매개 변수를 사용합니다.

목록을 100개의 작업 영역 청크로 나눕니다.

100개 각 작업 영역 청크에 대해 다음을 수행합니다.

workspaces/getInfo를 호출하여 이러한 100개 작업 영역에 대한 검사 호출을 트리거합니다. 다음 단계에서 사용할 수 있도록 응답에 scanId가 포함되어 수신됩니다. 위치 헤더에서 다음 단계를 호출할 URI(Uniform Resource Identifier)도 받게 됩니다.

참고 항목

16개를 초과하는 호출을 동시에 수행할 수 없습니다. 호출자는 다른 호출을 호출하기 전에 scanStatus API에서 검사 성공/실패 응답을 기다려야 합니다.

받아야 하는 일부 메타데이터가 반환되지 않는 경우 Fabric 관리자에게 문의하여 모든 관련 관리자 스위치를 사용하도록 설정했는지 확인합니다.

workspaces/getInfo를 호출하여 수신한 위치 헤더의 URI를 사용하고 반환된 상태가 "Succeeded"가 될 때까지 workspaces/scanStatus/{scan_id}를 폴링합니다. 이 상태는 검사 결과가 준비됨을 의미합니다. 30~60초의 폴링 간격을 사용하는 것이 좋습니다. 위치 헤더에서 다음 단계에서 호출할 URI도 수신됩니다. 상태가 "Succeeded"인 경우에만 사용합니다.

workspaces/scanStatus/{scan-id}를 호출하여 수신한 위치 헤더의 URI를 사용하고 workspaces/scanResult/{scan_id}를 사용하여 데이터를 읽습니다. 데이터에는 workspaces/getInfo 호출에서 전달된 매개 변수에 따라 작업 영역, 항목 정보 및 기타 메타데이터의 목록이 포함됩니다.

2단계: 증분 검사 수행

이제 자산의 모든 작업 영역과 메타데이터 및 계보가 있으므로 이전에 수행한 검사를 참조하는 증분 검사만 수행하는 것이 좋습니다.

다른 검사가 필요한 변경된 작업 영역을 가져오려면 modifiedSince 매개 변수를 마지막 검사의 시작 시간으로 설정한 상태로 workspaces/modified를 호출합니다. modifiedSince 매개 변수는 지난 30일 이내의 날짜에 대해 설정해야 합니다.

이 목록을 최대 100개의 작업 영역 청크로 나누고, 1단계에서 설명한 대로 세 개의 API 호출, workspaces/getInfo, workspaces/scanStatus/{scan_id} 및 workspaces/scanResult/{scan_id}를 사용하여 이러한 변경된 작업 영역에 대한 데이터를 가져옵니다.

고려 사항 및 제한 사항

  • 새로 고쳐지거나 다시 게시되지 않은 의미 체계 모델은 API 응답에서 하위 아티팩트 정보와 식 없이 반환됩니다. 예를 들어, 응답에 의미 체계 모델 이름과 계보는 포함되지만 의미 체계 모델의 테이블 및 열 이름은 포함되지 않습니다.
  • DirectQuery 테이블만 포함된 의미 체계 모델은 누군가가 의미 체계 모델을 기반으로 하여 보고서를 작성하거나 보는 등 어떤 종류의 작업이 수행된 경우에만 하위 아티팩트 메타데이터를 반환합니다.
  • 실시간 데이터 세트, 개체 수준 보안이 적용된 의미 체계 모델, AS-Azure 및 AS 온-프레미스에 대한 라이브 연결이 있는 의미 체계 모델, Excel 전체 충실도 데이터 세트는 하위 아티팩트 메타데이터가 지원되지 않습니다. 지원되지 않는 데이터 세트의 경우 응답은 데이터 세트로부터 하위 아티팩트 메타데이터를 가져오지 못한 이유를 반환합니다. 이유는 schemaRetrievalError 필드에서 찾을 수 있습니다. 예: schemaRetrievalError: 지원되지 않는 요청. 실시간 데이터 세트는 지원되지 않습니다.
  • API는 공유 작업 영역에 있는 1GB보다 큰 의미 체계 모델에 대해 하위 아티팩트 메타데이터를 반환하지 않습니다. Premium 작업 영역에는 의미 체계 모델에 대한 크기 제한이 없습니다.

라이선스

메타데이터 검사에는 특별한 라이선스가 필요하지 않습니다. 프리미엄이 아닌 작업 영역에 있는 항목의 메타데이터를 포함하여 테넌트의 모든 메타데이터에서 작동합니다.

관련 콘텐츠