PowerBI 메타데이터 수집기

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 26분
  • PowerBI 메타데이터 수집기는 PowerBI 계정의 메타데이터에 대한 읽기 전용 액세스를 제공합니다.

    Power BI 는 관련 없는 데이터 원본을 일관되고 시각적으로 몰입감이 있는 대화형 인사이트로 변환하기 위해 함께 작동하는 소프트웨어 서비스, 앱 및 커넥터의 컬렉션입니다. 데이터 소스에는 Excel 스프레드시트, 클라우드 기반 데이터 웨어하우스 또는 온-프레미스 하이브리드 데이터 웨어하우스가 포함될 수 있습니다. Power BI를 사용하면 데이터 원본에 연결하고, 중요한 정보를 시각화 및 검색하고, 조직 전체에서 인사이트를 공유할 수 있습니다.

    Power BI 수집기는 Power BI 서비스 작업 영역에서 메타데이터를 수집합니다. 수집된 메타데이터를 사용하여 작업 영역에서 보고서와 대시보드를 검색하고 영향 분석을 수행하여 업스트림 데이터 원본의 변경 내용이 Power BI 보고서에 미치는 영향을 이해합니다.

    지원되는 버전

    수집기는 Power BI Cloud API v 1.0을 지원합니다.

    인증 지원됨

    Power BI는 다음 두 가지 인증 방법을 지원합니다.
    • 서비스 원칙
    • 사용자 및 암호
    수집기는 인증된 계정이 액세스할 수 있는 모든 Power BI 앱 및 작업 영역에 대한 메타데이터를 수집합니다.

    메타데이터 카탈로그됨

    Power BI 수집기는 다음 정보를 카탈로그화합니다.

    표 1. 수집된 메타데이터
    객체 수집된 정보
    작업 공간 제목, 설명
    제목, 설명
    Power BI 측정값 제목, 설명, 숨겨짐 여부, 표현식
    보고서 제목, 보고서 유형, 외부 URL, 포함된 URL, 이미지 미리 보기(페이지 매김된 보고서 유형에는 지원되지 않음), 생성한 날짜, 마지막으로 수정한 날짜, 작성자, 마지막으로 수정한 사람, 설명
    보고서 페이지 제목 참고: Power BI API의 제한으로 인해 서비스 주체 인증을 사용할 때 앱 내의 보고서 페이지를 카탈로그할 수 없습니다.
    대시보드 제목, 외부 URL, 포함 URL
    대시보드 타일 제목, 포함 URL
    데이터 소스 제목, 데이터 소스 유형, 연결 상세 정보(종류 및 경로)
    시맨틱 모델 제목, 외부 URL, 설명, 생성한 날짜, 작성자, 일정 새로 고침
    데이터 플로우 제목, 마지막으로 수정한 날짜, 설명, 작성자, 일정 새로 고침
    Power BI 테이블(시맨틱 모델 및 데이터 흐름) 제목, 숨겨짐, 입력된 데이터, 설명, 소스 표현식
    Power BI 계산된 테이블 제목, 숨겨짐, 입력된 데이터, 설명, 소스 표현식
    Power BI 열 제목, 설명, 데이터 유형, 열 유형, 숨겨짐 여부, 표현식
    표 형식 파일 파일 경로, 파일 이름
    파일 디렉터리 디렉터리 경로
    데이터베이스 직함, 유형, 식별자, 서버, 포트
    데이터베이스 스키마 직위
    데이터베이스 테이블 직위
    데이터베이스 열 직위
    테이블 제목, 설명
    제목, 유형
    계산 그룹 제목, 설명
    계산 항목 제목, 설명, 표현식

    객체 간 관계

    카탈로그 페이지에는 다음 데이터 자산 유형 간의 관계가 표시됩니다.

    표 2. 카탈로그된 객체 간의 관계
    데이터 자산 페이지 관계
    보고서, 대시보드, 작업 공간
    Power BI 열 Power BI 테이블
    데이터 소스 시맨틱 모델, 데이터 플로우, 테이블 형식 데이터 소스(데이터베이스, 테이블 형식 파일)
    타일 대시보드, 보고서, 시맨틱 모델
    대시보드 타일, 작업 공간
    대시보드 타일 연결된 시맨틱 모델
    시맨틱 모델 대시보드 타일, 보고서
    보고서 타일, 작업 공간, 보고서 페이지(페이지 매김된 보고서 유형에는 적용되지 않음), 시맨틱 모델(페이지 매김된 보고서 유형에는 적용되지 않음), 보고서
    주:
    Power BI에서 앱 보고서 및 관련 작업 영역 보고서는 고유한 보고서 ID가 있는 두 개의 개별 보고서입니다. 수집기는 그 사이의 관계를 카탈로그화합니다.
    보고서 페이지 보고서(페이지 매김된 보고서 유형에는 적용되지 않음)
    시맨틱 모델 타일, 작업 공간, 보고서, 테이블, 데이터 소스, 시맨틱 모델, 데이터 플로우
    작업 공간 보고서, 시맨틱 모델, 데이터 플로우, 대시보드, 앱
    데이터 플로우 작업 공간, 테이블, 데이터 소스, 데이터 플로우
    Power BI 테이블 시맨틱 모델, 데이터 흐름, Power BI 열, Power BI 측정
    Power BI 측정 Power BI 테이블
    테이블 형식 데이터 소스(데이터베이스, 테이블 형식 파일) 데이터 소스
    계산 그룹 Power BI 테이블
    계산 항목 계산 그룹

    PowerBI 계보

    Power BI 수집기에서 수집하는 계보 정보는 다음과 같습니다. 수집기는 Power BI 스캐너 API 를 사용하여 소스 테이블 및 열에 대한 계보를 설정합니다. 스캐너 API의 제한 사항을 숙지해야 합니다.

    표 3. 개체별 계보 가용성
    객체 사용 가능한 계보
    대시보드 타일 연결된 시맨틱 모델
    시맨틱 모델 연결된 데이터 플로우, 시맨틱 모델
    데이터 플로우 데이터 플로우
    Power BI 열 열이 데이터를 소싱하거나 값을 계산하는 연결된 열입니다.
    주:
    계보는 서버, 스키마, 테이블 또는 데이터베이스 이름 대신 매개 변수를 사용하는 Power BI 식에서 수집할 수 있습니다. 테이블 수준 및 열 수준 계보 및 카탈로그 관계는 Power BI API를 통해 테이블, 열, 보고서 간에 사용할 수 없습니다.
    Power BI 테이블 테이블이 데이터를 소싱하는 관련된 테이블 참고:
    주:
    수집기는 API에서 반환된 Power BI 식을 사용하여 소스 열/테이블에 대한 계보를 구문 분석합니다.
    Power BI 계산된 테이블 계산된 테이블이 값을 파생하는 Power BI 테이블 및 열입니다.
    Power BI 측정 측정값이 데이터를 소싱하는 연결된 열

    다음 표에는 지원되는 테이블 및 변환과 지원되지 않는 테이블 작업 및 변환이 나열되어 있습니다. 여기에는 계보 메타데이터 수집에 사용되는 소스 표현식, 계산된 열 및 측정값 표현식이 포함됩니다. 목록에 없는 작업은 수집되지 않습니다.

    표 4. 계보 메타데이터 수집에 지원되는 변환 및 표현식
    범주 범주
    지원되는 매개변수화된 표현식 수집기는 전체 소스, 서버 또는 호스트, 웨어하우스, 데이터베이스 이름, 스키마 이름, 테이블 이름 및 SQL 표현식 값 대신 매개변수를 사용하는 소스 표현식을 구문 분석합니다.
    지원되는 데이터 함수 Csv.Document, Excel.Workbook, File.Contents, Folder.Contents, Folder.Files, Json.Document, Odbc.DataSource, Odbc.InferOptions, Odbc.Query, Xml.Document, Web.Contents, Web.Headers, Web.BrowserContents, AmazonRedshift.Database, Sql.Database, Sql.Databases, Snowflake.Databases, PostgreSQL.Database, Databricks.Catalogs, Oracle.Database, Denodo.Contents, Databricks.Query, DatabricksMultiCloud.Catalogs, AnalysisServices.Database, GoogleBigQuery.Database
    지원되는 테이블 함수 Table.AddColumn, Table.AddIndexColumn, Table.RenameColumns, Table.NestedJoin, Table.ExpandTableColumn, Table.SplitColumn, Table.DuplicateColumn, Table.CombineColumns
    지원되지 않는 테이블 작업 Table.Pivot, Table.PromoteHeaders, Table.DemoteHeaders, Table.PrefixColumns, Table.TransformColumnNames, Table.Unpivot, Table.UnpivotOtherColumns, Table.AddFuzzyClusterColumn, Table.AddJoinColumn, Table.AggregateTableColumn, Table.Combine, Table.CombineColumnsToRecord, Table.ExpandRecordColumn, Table.Join, Table.Transpose
    지원되는 데이터 플로우 함수 PowerPlatform.Dataflows, PowerBI.Dataflows
    지원되는 값 함수 Value.NativeQuery
    지원되는 계산된 열 테이블 참조가 있거나 없는 열을 포함하는 계산된 열 표현식의 계보, 영숫자, 공백, 하이픈 및 밑줄이 있는 열 또는 테이블이 지원됩니다.
    지원되는 측정값 영숫자, 공백, 하이픈, 밑줄, 따옴표가 있는 열 또는 테이블을 포함하는 측정값 표현식의 계보가 지원됩니다.

    PowerBI 수집기 실행 준비

    수집기를 실행하기 전에 Azure 애플리케이션 등록, 인증 및 권한을 설정합니다.

    시작하기 전에

    필요한 역할: 관리자

    중요사항:
    Power BI 관리자 포털에서 설정을 사용하도록 설정하려면 Power BI 관리자가 필요합니다.

    이 태스크 정보

    수집기는 Azure 애플리케이션 등록을 사용하며 서비스 주체 또는 사용자 이름 및 암호의 두 가지 인증 방법을 지원합니다. 애플리케이션을 등록하고, 인증을 구성하고, 메타데이터 스캔을 사용하도록 설정하고, 테넌트 ID를 검색해야 합니다. 선택적으로 보고서 이미지 수집 및 계보 매핑을 구성합니다.

    프로시저

    1. Azure에 애플리케이션을 등록하고 클라이언트 자격 증명을 생성합니다.

      Power BI 애플리케이션 등록 문서를 참조하십시오.

    2. 선호하는 방법에 따라 인증을 구성합니다.
    3. 메타데이터 스캔을 사용하여 자세한 데이터 소스 정보에 액세스합니다.

      Power BI 메타데이터 스캔 구성 문서를 참조하십시오.

    4. Power BI 테넌트 ID를 가져옵니다.

      Power BI 테넌트 ID 가져오기 문서를 참조하십시오.

    5. 옵션: Power BI 보고서에서 미리 보기 이미지를 수집하도록 보고서 이미지 수집을 구성합니다.

      Power BI 보고서 이미지 수집 구성 문서를 참조하십시오.

    6. 옵션: ODBC 연결, 서버 별칭 또는 사용자 지정 SQL 문에 대한 계보 매핑을 구성합니다.

    Power BI 애플리케이션 등록

    Azure에 애플리케이션을 등록하고 Power BI 수집기 인증을 위한 클라이언트 자격 증명을 만듭니다.

    시작하기 전에

    필요한 역할: 관리자

    Azure Active Directory에 애플리케이션을 등록할 수 있는 권한이 있어야 합니다.

    이 태스크 정보

    Azure에서 애플리케이션을 등록하여 Power BI 수집기 인증에 필요한 클라이언트 ID 및 클라이언트 비밀을 가져옵니다.

    프로시저

    1. Azure에 새 애플리케이션을 등록합니다.
      1. Azure Portal로 이동합니다.
      2. Azure 서비스에서 앱 등록을 선택합니다.
      3. 새 등록을 선택합니다.
      4. 등록 정보를 입력합니다.
        • 애플리케이션 이름: DataDotWorldPowerBIApplication
        • 지원되는 계정 유형: 이 조직 디렉터리의 계정만 해당
      5. 등록을 선택하여 등록을 완료합니다.
    2. 클라이언트 비밀을 만듭니다.
      1. 애플리케이션 페이지에서 인증서 및 비밀을 선택합니다.
      2. 새 클라이언트 비밀을 선택합니다.
      3. 비밀에 대한 설명을 추가합니다.
      4. 원하는 만료 날짜를 선택합니다.
      5. 추가를 선택합니다.
      6. 비밀 값을 복사합니다.

        이 값을 안전하게 저장합니다. Power BI 수집기를 구성할 때 사용합니다.

    3. 클라이언트 ID를 가져옵니다.
      1. 애플리케이션 페이지의 왼쪽 사이드바에서 개요 탭을 선택합니다.
      2. Essentials 섹션에서 클라이언트 ID를 복사합니다.

        이 값을 저장합니다. Power BI 수집기를 구성할 때 사용합니다.

    Power BI 서비스 주체 인증 구성

    Power BI 메타데이터 수집을 사용하도록 서비스 주체 인증을 설정합니다.

    시작하기 전에

    필요한 역할: 관리자

    서비스 주체 설정을 사용하도록 설정하려면 Power BI 관리자여야 합니다.

    중요사항:
    서비스 주체에서 실행하는 경우 앱에 설정된 Power BI 관리자 동의 필수 권한이 없어야 합니다. 자세한 내용은 Microsoft 설명서를 참조하십시오.

    이 태스크 정보

    서비스 주체 인증을 사용하는 경우 수집기는 개인 작업 공간, 사용자 작업 공간 및 보고서 페이지를 제외한 모든 객체를 수집합니다. 테넌트의 모든 앱과 작업 영역을 수집하려면 테넌트의 모든 작업 영역과 앱 카탈로그를 사용하도록 설정합니다. 개인 및 사용자 작업 공간을 포함하려면 사용자의 내 작업 공간에서 카탈로그 콘텐츠를 활성화합니다.

    주:
    보고서 페이지를 수집하려면 서비스 주체에게 각 작업 공간에 대한 액세스 권한을 부여합니다. 관리자 API에는 보고서 페이지에 대한 엔드포인트가 없습니다.

    프로시저

    1. Power BI 관리자 계정을 사용하여 Power BI에 로그인합니다.
    2. 다음으로 이동 설정 > 관리자 포털.
    3. 서비스 주체 API 액세스를 활성화합니다.
      1. 개발자 설정에서 서비스 주체는 패브릭 API를 사용할 수 있습니다.
      2. 설정을 활성화합니다.
      3. 설정을 전체 조직에 적용할지 특정 보안 그룹에 적용할지 선택합니다.

        특정 보안 그룹을 사용하는 경우 그룹에 서비스 주체가 포함되어 있는지 확인합니다.

      4. 적용을 선택하여 변경 내용을 저장합니다.
    4. 옵션: 데이터 흐름 및 보고서 페이지 액세스를 위해 작업 공간에 서비스 주체를 추가합니다.

      데이터 흐름을 사용하려면 서비스 주체에게 작업 영역에 대한 기고자 이상의 액세스 권한이 있어야 합니다. 관리자 API가 보고서 페이지에 대한 엔드포인트를 제공하지 않으므로 보고서 페이지의 경우 서비스 주체에도 작업 공간 액세스 권한이 필요합니다.

      1. 작업 공간을 엽니다.
      2. 액세스 관리를 선택합니다.
      3. 서비스 주체 또는 서비스 주체가 속한 보안 그룹을 검색합니다.
      4. 적절한 접근 수준을 선택합니다.

        데이터 흐름을 사용하는 경우 최소한 기고자 액세스를 선택합니다. 그렇지 않으면 뷰어를 선택합니다.

      5. 추가를 선택합니다.

    Power BI 사용자 이름 및 암호 인증 구성

    Power BI 메타데이터 수집을 사용하도록 사용자 이름 및 암호 인증에 대한 API 권한을 설정합니다.

    시작하기 전에

    필요한 역할: 관리자

    Azure Active Directory에서 API 권한을 구성할 수 있는 권한이 있어야 합니다.

    주:
    테넌트 관리자만 관리자 동의를 부여할 수 있습니다.

    이 태스크 정보

    사용자 인증을 사용하는 경우 수집기는 개인 작업 공간, 사용자 작업 공간 및 보고서 페이지를 제외한 모든 객체를 수집합니다. 테넌트의 모든 앱과 작업 영역을 수집하려면 테넌트의 모든 작업 영역 및 앱 카탈로그를 사용하도록 설정합니다. 개인 및 사용자 작업 공간을 포함하려면 사용자의 내 작업 공간에서 카탈로그 콘텐츠를 활성화합니다.

    보고서 페이지를 수집하려면 사용자에게 각 작업 공간에 대한 액세스 권한을 부여합니다. 관리자 API에는 보고서 페이지에 대한 엔드포인트가 없습니다.

    주:
    테넌트의 모든 작업 영역 및 앱을 카탈로그하려면 사용자에게 메타데이터 검사를 위한 Microsoft 365 전역 관리자 또는 Power BI 서비스 관리자 권한이 있어야 합니다. 자세한 내용은 Power BI 설명서를 참조하세요.

    프로시저

    1. Azure Portal로 이동하여 애플리케이션 등록을 엽니다.
    2. API 권한을 선택합니다.
    3. Microsoft Graph 권한을 추가합니다.
      1. 권한 추가를 선택합니다.
      2. Microsoft Graph를 검색하여 선택합니다.
      3. 다음 권한을 추가합니다.
        • 애플리케이션 권한: Application.Read.All
        • 위임된 권한: User.Read(기본적으로 할당됨)
    4. Power BI 서비스 권한을 추가합니다.
      1. 권한 추가를 선택합니다.
      2. Power BI 서비스를 검색하여 선택합니다.
      3. 위임된 권한을 선택합니다.
      4. 다음 권한을 추가합니다.
        • 앱.읽기.모두
        • 대시보드.읽기.모두
        • Dataflow.Read.All
        • 데이터 세트.읽기.모두
        • 보고서.읽기.모두
        • 테넌트.읽기.모두
        • 작업 공간.읽기.모두
    5. 권한 추가 버튼 옆에 있는 관리자 동의 부여 버튼을 선택합니다.

      이 권한을 사용하면 모든 실행에 대한 권한을 요청하지 않고도 수집기를 실행할 수 있습니다.

    Power BI 메타데이터 스캔 구성

    메타데이터 스캔을 사용하여 테이블과 열을 포함한 자세한 데이터 소스 정보에 액세스합니다.

    시작하기 전에

    필요한 역할: 관리자

    메타데이터 검사 설정을 사용하도록 설정하려면 Power BI 관리자여야 합니다.

    이 태스크 정보

    메타데이터 검사 는 Power BI 읽기 전용 관리 API를 통해 테이블 및 열과 같은 자세한 데이터 원본 정보에 대한 액세스를 제공합니다. 수집기는 Power BI 스캐너 API를 사용하여 소스 테이블 및 열에 대한 계보를 설정합니다. 수집기를 구성하기 전에 스캐너 API에 대한 제한 사항을 검토합니다.

    프로시저

    인증 방법에 따라 메타데이터 스캔을 활성화합니다.
    • 서비스 주체 인증의 경우:

      1. Power BI 설명서에 따라 Power BI 읽기 전용 API에 대한 서비스 주체 인증을 사용하도록 설정합니다.
      2. 메타데이터 검사를 위해 다음과 같은 향상된 테넌트 설정을 활성화합니다.
        • 자세한 메타데이터로 관리자 API 응답 개선
        • DAX 및 매시업 표현식을 사용하여 관리자 API 응답 개선
    • 사용자 이름 및 암호 인증의 경우 메타데이터 검사를 위해 다음과 같은 향상된 테넌트 설정을 활성화합니다.

      중요사항:
      메타데이터 검사를 사용하려면 사용자에게 관리자 권한(Microsoft 365 전역 관리자 또는 Power BI 서비스 관리자)이 있어야 합니다. 자세한 내용은 Power BI 설명서를 참조하세요.
      • 자세한 메타데이터로 관리자 API 응답 개선
      • DAX 및 매시업 표현식을 사용하여 관리자 API 응답 개선

    Power BI 테넌트 ID 가져오기

    Power BI 애플리케이션에서 테넌트 ID를 검색합니다.

    시작하기 전에

    필요한 역할: 관리자

    이 태스크 정보

    테넌트 ID는 Power BI 수집기를 구성할 때 필요합니다. Power BI 애플리케이션에서 이 값을 검색합니다.

    프로시저

    1. Power BI 애플리케이션에서 물음표 아이콘을 선택합니다.
    2. Power BI 정보를 선택합니다.
    3. 테넌트 URL 끝에서 테넌트 ID를 복사합니다.

      이 값을 저장합니다. Power BI 수집기를 구성할 때 사용합니다.

    Power BI 보고서 이미지 수집 구성

    보고서 이미지 수집을 사용하도록 설정하여 Power BI 보고서에서 미리 보기 이미지를 수집합니다.

    시작하기 전에

    필요한 역할: 관리자

    주:
    보고서 이미지 수집은 Power BI 앱에 지원되지 않습니다.

    이 태스크 정보

    보고서 이미지 수집을 사용하도록 설정하여 Power BI 보고서에서 미리 보기 이미지를 수집하여 데이터 카탈로그에 표시합니다.

    프로시저

    1. Power BI 관리 포털에서 내보내기 설정을 사용하도록 설정합니다.
      1. Power BI 관리자 계정을 사용하여 Power BI에 로그인합니다.
      2. 다음으로 이동 설정 > 관리자 포털.
      3. 관리자 설정에서 보고서를 이미지 파일로 익스포트 설정을 찾아 활성화합니다.
    2. 작업 공간 용량을 확인합니다.

      익스포트할 보고서가 프리미엄, 임베디드 또는 패브브 용량이 있는 작업 영역에 있는지 확인합니다. 자세한 내용은 Power BI 설명서를 참조하세요.

    Power BI 계보 매핑 구성

    YAML 파일을 생성하여 계보 수집을 위한 데이터 소스를 매핑합니다.

    시작하기 전에

    필요한 역할: 관리자

    이 태스크 정보

    이것은 계보 정보를 수집하기 위한 선택적 작업입니다. 수집기를 실행할 때 YAML 파일을 생성하고 데이터 소스 이름 매핑 파일 옵션을 사용하여 전달합니다.

    다음 시나리오에서 YAML 파일을 설정합니다.

    표 5. 계보 매핑 시나리오
    시나리오 상세 정보 작업
    Power BI의 ODBC 연결 Power BI에는 ODBC 연결을 사용하는 데이터 원본이 있습니다. 이러한 경우 Power BI는 소스의 호스트 또는 데이터베이스 유형을 제공하지 않습니다 YAML 파일에서 DSN을 특정 데이터베이스 호스트 및 유형에 매핑합니다. Power BI 데이터 원본에 데이터베이스 이름이 없는 경우 YAML 파일의 데이터 원본에 defaultDatabaseName 옵션을 추가합니다
    여러 서버 이름 별칭 동일한 데이터베이스 인스턴스(호스트)에 대한 여러 서버 이름(별칭)이 있으며 데이터베이스 수집기가 Power BI 연결에 정의된 별칭과 다른 별칭을 사용합니다 YAML 파일을 사용하여 데이터베이스 호스트를 사용자 지정 별칭에 매핑합니다.
    사용자 지정 SQL 문 사용자 지정 SQL 문은 Power BI 테이블 소스 정의에 사용됩니다. Power BI 수집기는 현재 SQL 문에서 계보를 해결하기 위해 Snowflake, SQL Server, PostgreSQL, Redshift, Oracle, Databricks, Denodo, BigQuery와 같은 데이터베이스 유형에 연결하는 것을 지원합니다. SQL 문을 사용한 테이블 소스의 계보 확인은 단일 SELECT 문으로 구성된 SQL만 지원합니다. 환경 변수를 사용하여 datasourceKey, 호스트 및 보안 자격 증명을 포함하여 사용자 지정 SQL 문에 지정된 데이터베이스를 구성합니다
    주:
    암호와 같은 중요한 정보에 파일의 환경 변수를 사용할 수 있습니다.

    프로시저

    1. datasources.yml라는 YAML 파일을 만듭니다.
    2. 시나리오에 따라 YAML 파일을 구성합니다.
      • 여러 서버 이름 별칭의 경우:

        다음을 추가하여 호스트 별칭을 매핑합니다.

        datasources:
         - datasourceKey: "<host or data source key in Power BI source>"
          host: <my-datasource-host>

        예를 들어 Power BI 테이블 원본이 다음과 같은 경우:

        let Source = Snowflake.Database("host-alias.snowflakecomputing.com", "KOS_TEST"),
        PowerBiTest_Test_Table = Source{[Schema="POWERBI_TEST",Item="TEST_TABLE"]}[Data]
        in PowerBiTest_Test_Table

        그러면 datasourceKey가 host-alias.snowflakecomputing.com 됩니다. datasources.yml 파일은 다음과 같습니다.

        datasources:
        - datasourceKey: host-alias.snowflakecomputing.com
        host: host-actual.snowflakecomputing.com
      • 사용자 지정 SQL 문의 경우:

        사용자 지정 SQL 문에 지정된 데이터베이스에 대해 다음을 추가합니다. 환경 변수가 지원됩니다.

        datasources:
          - datasourceKey: "<host or data source key in Power BI source>"
          OR
         - name: <data source name>
         host: <my-datasource-host>
         databaseUsername: <username> # recommend setting up env variable
         databasePassword: <password> # recommend setting up env variable

        다음 옵션을 사용하여 데이터 소스 구성이 적용되는 데이터베이스를 지정합니다. 제공되지 않은 경우 데이터 소스 설정이 지정된 호스트의 모든 데이터베이스에 적용되는 것으로 가정합니다.

        applicableDatabases:
          - <database_name>

        예:

        datasources:
        - datasourceKey: "example.cpcnqsn422gx.us-east-1.rds.amazonaws.com, 1433"
         host: example.cpcnqsn422gx.us-east-1.rds.amazonaws.com
         databaseUsername: ${DB_USERNAME}
         databasePassword: ${DB_PASSWORD}
         applicableDatabases:
         - 8bank_database
      • ODBC 연결의 경우:

        DSN을 특정 데이터베이스 호스트 및 유형에 매핑합니다. ODBC 연결의 경우 해당 호스트 및 데이터베이스 유형으로 데이터 소스를 나열합니다. ODBC 연결에서 Odbc.Query를 사용하는 경우 사용자 이름과 암호를 지정합니다. ODBC 연결에서 데이터베이스 이름을 지정하는 경우 defaultDatabaseName을 포함합니다.

        datasources:
        - name: "Name-for-datasource"
        host: <my-datasource-host>
        databaseType: <type-of-database>
        databaseUsername: <username> # optional
        databasePassword: <password> # optional
        defaultDatabaseName: <database name> # optional

        가능한 databaseType 목록은 postgres, redshift, bigquery, oracle, mysql, netezza, snowflake, sqlanywhere, sqlserver, databricks, denodo입니다. 유형은 대/소문자를 구분하지 않지만 공백이 없는 단일 단어여야 합니다.

        예:

        datasources:
        - name: "SQL Server DSN Production"
        databaseType: sqlserver
        host: 8bank-sqlserver.cpetgx.us-east-1.rds.amazonaws.com
    3. 옵션: 필요한 경우 데이터베이스별 구성 옵션을 추가합니다.

      JDBC 속성 옵션:

      표 6. JDBC 속성
      옵션 설명
      jdbcProperties YAML 목록을 사용하여 여러 JDBC 속성을 지정할 수 있습니다. 예상 형식은 jdbcProperties: key=value입니다.

      예: jdbcProperties: encrypt=true

      여러 값의 경우:

      jdbcProperties:
      - encrypt=true
      - readOnly=true

      Snowflake 데이터베이스 자격 증명 옵션:

      표 7. Snowflake 옵션
      옵션 설명
      데이터베이스 사용자 이름: ${DB_USERNAME} Power BI 데이터베이스 원본에서 사용자 지정 SQL 쿼리를 사용하는 경우 필수입니다.
      데이터베이스 암호: ${DB_PASSWORD} SQL 쿼리가 사용되고 Snowflake에 대한 인증에 개인 키가 사용되지 않는 경우 필수입니다.
      snowflakePrivateKeyFile: privateKeyFile SQL 쿼리가 사용되고 Snowflake에 대한 인증에 개인 키가 사용되는 경우 필수입니다.
      snowflakePrivateKeyFilePassword: ${privateKeyFilePassword} SQL 쿼리가 사용되고 Snowflake에 대한 인증에 개인 키가 사용되는 경우 필수입니다.
      snowflakeRole: role SQL 쿼리를 사용하는 경우 필요
      snowflakeWarehouse: 창고 데이터베이스 연결에서 Power BI 표현식에 사용되는 창고를 재정의하는 데 사용

      Databricks 데이터베이스 자격 증명 옵션:

      표 8. Databricks 옵션
      옵션 설명
      databricksHttpPath 소스 데이터베이스가 Databricks인 경우 필수입니다.

      Oracle 자동 데이터베이스 옵션:

      표 9. Oracle 자동 데이터베이스 옵션
      옵션 설명
      oracleAutonomousDbConnectionString 소스가 Oracle 자동 데이터베이스인 경우 필수입니다. 연결 문자열은 다음 형식이어야 합니다.
      jdbc:oracle:thin:<host>:<port>/<service_name>, 
      jdbc:oracle:thin:@(address=(protocol=tcps)(port=<port>)(host:<host>))
      (connect_data=(service_name=<service_name>))
      (security=(ssl_server_dn_match=yes)), 
      or jdbc:oracle:thin:@alias_name?TNS_ADMIN=/path/to/wallet
      

      BigQuery 옵션:

      표 10. BigQuery 옵션
      옵션 설명
      프로젝트 소스가 BigQuery 테이블인 경우 필수입니다.
      bigQueryCredentialJsonString BigQuery 자격 증명 제공에 필요

      BigQuery 데이터베이스의 예:

      datasources:
       - project: "project-name"
      databaseType: bigquery
      bigQueryCredentialJsonString: '{"key": "value","key": "value"}'
    4. datasources.yml 파일을 저장합니다.
    5. 수집기를 실행할 때 --datasource-mapping-file 매개변수를 사용하여 YAML 파일을 수집기에 전달합니다.

    PowerBI 메타데이터 수집기 만들기

    PowerBI에서 메타데이터를 임포트하는 수집기를 생성합니다.

    시작하기 전에

    시작하기 전에 다음을 확인하십시오.

    프로시저

    1. 다음으로 이동 모두 > 워크플로우 데이터 패브릭 > 워크플로우 데이터 패브릭 홈.
    2. 왼쪽 사이드바에서 허브 연결 허브 연결 아이콘 아이콘을 선택합니다.
    3. 선택 작성 > 메타데이터 수집기.
    4. 시스템 목록에서 PowerBI를 선택합니다.
    5. 양식을 작성합니다.
      표 11. 새 PowerBI Gov 메타데이터 수집기 양식
      필드 설명
      연결 이름 연결에 대한 고유 식별자입니다. 연결이 설정되면 이 필드를 수정할 수 없습니다.
      간단한 설명 연결의 목적 및 상세 정보입니다.
    6. 인증 옵션을 구성합니다.
      표 12. 인증 옵션
      필드 설명
      Azure 사용자 이름 및 암호를 사용하여 인증 Azure Active Directory 사용자 이름 및 암호입니다. 사용자 이름 및 암호 인증을 사용하는 동안 Azure 테넌트 ID를 지정하려면 Azure 테넌트 ID를 설정합니다.
      Azure 서비스 주체를 사용하여 인증 Power BI 앱에 대한 Azure Active Directory 애플리케이션 테넌트 ID입니다. 테넌트 ID를 찾으려면 Power BI 앱에서 물음표를 선택한 다음, Power BI 정보를 선택합니다. 테넌트 ID는 테넌트 URL 끝에 있습니다.
    7. 클라이언트 ID 및 클라이언트 비밀 상세 정보를 구성합니다.
      표 13. 구성 상세 정보
      필드 설명
      Microsoft Entra 클라이언트 ID PowerBI 앱의 애플리케이션 클라이언트 ID입니다.
      Microsoft Entra 클라이언트 비밀 PowerBI 앱에 대한 애플리케이션 클라이언트 비밀입니다.
    8. 작업 공간 범위 및 필터 옵션을 구성합니다.
      표 14. 작업 공간 범위 및 필터 옵션
      필드 설명
      계보 수집 사용 안 함 Power BI 소스 표현식에서 계보 메타데이터 수집을 건너뛰는 옵션입니다.
      사용자의 내 작업 공간의 카탈로그 콘텐츠 Power BI에서 사용자의 내 작업 영역 콘텐츠를 카탈로그화하는 옵션입니다.

      기본값: 사용자의 작업 공간을 건너뜁니다.

      테넌트의 모든 작업 공간 및 앱 카탈로그 자격 증명에 명시적으로 액세스할 수 있는 작업 공간 및 앱이 아닌 테넌트의 모든 작업 공간과 앱을 카탈로그화하는 옵션입니다. 사용되는 자격 증명에는 관리자 권한이 필요합니다.
      Power BI 작업 영역 포함 수집할 작업 공간입니다. 정확한 작업 공간 이름 또는 일치하는 정규 표현식을 입력합니다.
      주:
      작업 공간 이름에 특수 문자 [. , + , * , ? , ^ , $ , ( , ) , [ , ] , { , } , | , \]가 포함된 경우 각 특수 문자를 백슬래시(\)로 이스케이프하십시오. 예를 들어 작업 공간(Dev)에 Workspace \(Dev\)를 입력합니다.
      Power BI 작업 영역 제외 카탈로그 작성에서 제외할 Power BI 작업 영역 및 해당 콘텐츠입니다. 정확한 작업 공간 이름 또는 일치하는 정규 표현식을 입력합니다. 작업 공간 포함 및 작업 공간 제외가 모두 구성된 경우 작업 공간 포함이 우선합니다.
      주:
      작업 공간 이름에 특수 문자 [. , + , * , ? , ^ , $ , ( , ) , [ , ] , { , } , | , \]가 포함된 경우 각 특수 문자를 백슬래시(\)로 이스케이프하십시오. 예를 들어 작업 공간(Dev)에 Workspace \(Dev\)를 입력합니다.
    9. 연결 및 안정성 옵션을 구성합니다.
      표 15. 연결 및 안정성 옵션
      필드 설명
      최대 Power BI 표현식 길이 계보 메타데이터에 대해 구문 분석되는 Power BI 식의 최대 문자 수입니다. 이 값보다 긴 식은 건너뜁니다.

      기본값: 32000

      데이터 소스 이름 매핑 파일 datasources.yml 파일에 구성된 ODBC 소스 상세 정보를 매핑하는 파일입니다. ODBC 소스 상세 정보를 구성한 경우 파일을 업로드합니다.
      카탈로그 보고서 미리 보기 이미지 미리 보기 이미지를 카탈로그화하는 옵션입니다.

      기본값: false

      최대 요청 대기 사용 안 함 Power BI API가 제한 제한을 다시 설정할 때까지 대기하지 않도록 설정하는 옵션입니다(오류 코드 429). 선택하지 않으면 수집기가 최대 1시간 동안 5분마다 다시 시도합니다. 이 옵션을 선택하면 최대 재시도 및 재시도 지연 설정이 대신 사용됩니다.
      최대 재시도 시스템에서 실패한 API 호출을 재시도하는 횟수입니다.

      기본값: 5

      재시도 지연 실패한 API 호출에 대한 재시도 사이에 기다리는 시간(초)입니다.

      기본값: 2초

    10. 저장을 선택합니다.

    결과

    메타데이터 수집기가 생성되고 커넥터 페이지에 구성됨 상태로 나타납니다. 이제 소스 시스템에 연결하고 메타데이터를 수집할 준비가 되었습니다.

    다음에 수행할 작업

    수집기를 생성한 후에는 다음 작업을 수행할 수 있습니다.