Power BI 수집(Ingestion) 기능 지원
Power BI 수집(Ingestion) 기능 지원
Power BI 파일을 Semantic View Autopilot에 업로드하면, 이미 만들어 둔 데이터 모델에서 시맨틱 뷰가 자동으로 생성돼요. 이렇게 하면 Power BI에서 이미 구축한 비즈니스 로직(측정항목 정의, 테이블 관계, 컬럼 설명 등)이 그대로 보존되면서 Cortex Analyst와 다른 Snowflake 도구에서도 활용할 수 있게 돼요.
출처: Snowflake 문서
본문
Power BI 파일을 Semantic View Autopilot에 업로드하면, 기존 데이터 모델에서 시맨틱 뷰가 자동으로 생성돼요. 이 방식은 Power BI에 이미 구축해 둔 비즈니스 로직(측정항목 정의, 테이블 관계, 컬럼 설명 포함)을 보존하면서, 이를 Cortex Analyst와 다른 Snowflake 도구에서 쓸 수 있게 해줘요.
Power BI 파일은 Autopilot 마법사의 컨텍스트로 제공하면 돼요.
전제 조건(Prerequisites)
Autopilot 전제 조건 외에, Power BI 수집 기능에는 다음이 필요해요:
- 쓰기 권한이 있는 스테이지(stage)
- Power BI 파일이 참조하는 기본 테이블과 컬럼에 대한 읽기 액세스
- 파일 크기 250 MB 미만
Power BI 모델이 Snowflake에 매핑되는 방식
Power BI 파일을 업로드하면 Snowflake가 Power BI 시맨틱 모델을 시맨틱 뷰로 변환해요:
- Power BI 모델의 테이블과 컬럼은 Snowflake의 해당 테이블과 컬럼에 매칭돼요. 테이블 이름, 컬럼 이름, 데이터 타입이 그대로 이어져요.
- **관계(테이블 간 조인)**는 시맨틱 뷰 관계로 보존돼요.
- **DAX 측정값(measures)**은 시맨틱 뷰의 **메트릭(metric)**으로 등록돼요. 단일 테이블 측정값, 교차 테이블 측정값, 파생 메트릭 모두 지원돼요. 예를 들어
Total Revenue = SUM(Sales[Amount])같은 DAX 측정값은 시맨틱 뷰의 메트릭이 돼요. - **계산 컬럼(Calculated columns, DAX로 정의된 가상 컬럼)**은 단일 테이블 계산에 한해 시맨틱 뷰의 차원(dimension)으로 포함돼요.
- **M 쿼리 변환(
Table.RenameColumns)**으로 이름이 바뀐 테이블과 컬럼도 반영돼요. 시맨틱 뷰는 바뀐 표시 이름을 사용해요. - **기본 키(primary keys)**는 자동으로 감지돼요. 두 개 이상의 컬럼이 함께 고유 값을 갖는 복합 키(composite key)도 감지해요.
예외사항: 보고서 수준 측정값과 시간 인텔리전스 함수(PREVIOUSMONTH, SAMEPERIODLASTYEAR, TOTALYTD 등)는 아직 완전히 지원되지 않아요. 자세한 내용은 아래 기능 표를 참고해요.
지원되는 기능
다음 표는 완전히 지원되는 Power BI 기능을 설명해요.
| 기능 | 세부 사항 |
|---|---|
.pbit 파일 |
데이터가 포함되지 않은 템플릿 파일 |
.pbix 파일 |
데이터가 포함된 보고서 파일 |
| 테이블 관계 | 시맨틱 뷰 관계로 매핑됨 |
| 단일 테이블 DAX 측정값 | 시맨틱 뷰 메트릭으로 변환됨. 대부분의 단일 테이블 측정값이 지원됨 |
| 교차 테이블 측정값 | 시맨틱 뷰의 최상위 메트릭으로 생성됨. 예: SUMX(ORDERS, ORDERS[AMT] * RELATED(CUSTOMERS[SPEND])) 가 동작함 |
| 파생 메트릭 | 다른 메트릭을 참조하는 메트릭은 사이클 감지와 함께 재귀적으로 해석됨 |
| 계산 컬럼 | DAX로 정의된 가상 컬럼, 단일 테이블에 한정됨 |
| 이름이 바뀐 테이블과 컬럼 | M 쿼리 Table.RenameColumns 변환이 반영됨 |
| 파라미터화된 Snowflake 연결 | 지원됨. 파라미터가 null로 남아 있으면 명확한 오류가 표시됨 |
| 기본 키 감지 | 두 개 이상의 컬럼이 고유 값을 갖는 경우를 포함해 기본 키가 자동 감지됨 |
| 메트릭 설명 | 수집된 메트릭에 대해 설명이 자동 생성됨 |
부분적으로 지원되는 기능
| 기능 | 세부 사항 |
|---|---|
| 윈도우 함수 메트릭 | 필터 함수(CALCULATE, FILTER, ALL, ALLEXCEPT, REMOVEFILTERS)는 지원됨. 시간 인텔리전스 함수(PREVIOUSMONTH, SAMEPERIODLASTYEAR, TOTALYTD)는 보고서 수준 날짜 컨텍스트가 필요해서 아직 지원되지 않음 |
지원되지 않는 기능
다음 기능은 아직 지원되지 않아요:
- 보고서 수준 측정값: 수집은 DataModelSchema/DataModel을 읽지 Report/Layout은 읽지 않아요.
- 시간 인텔리전스 함수: PREVIOUSMONTH, SAMEPERIODLASTYEAR, TOTALYTD 같은 함수는 수집 중 사용할 수 없는 보고서 수준 날짜 컨텍스트가 필요해요.
- 대시보드 범위 수집: 현재는 특정 대시보드나 보고서가 사용하는 테이블과 컬럼만이 아니라, 전체 Power BI 시맨틱 모델이 수집돼요.
Power BI 파일 준비하기
.pbit(템플릿) 또는 .pbix(보고서) 파일을 업로드할 수 있어요.
Power BI Desktop에서 .pbit 파일 내보내기
데이터가 포함되지 않은 템플릿 파일을 내보내려면:
- Power BI Desktop에서 보고서를 열어요.
- File > Export > Power BI template으로 이동해요.
.pbit파일을 로컬 머신에 저장해요.
.pbit 파일에는 기본 데이터 없이 구조화된 형식(테이블, 관계, DAX 계산, 측정값)의 데이터 모델이 들어 있어요.
.pbix 파일 직접 사용하기
.pbix 파일을 직접 업로드할 수도 있어요. 이 파일은 표준 Power BI Desktop 파일 형식으로, 데이터 모델과 함께 내장 데이터를 포함해요.
주의: Power BI 시맨틱 모델이 데이터베이스나 스키마 이름에 파라미터를 사용한다면, 내보내기 전에 해당 파라미터 값을 반드시 채워 두세요. Snowflake는 이 값을 이용해 계정 안의 테이블을 매칭해요. 파라미터가 비어 있으면 테이블 매칭이 실패해 시맨틱 뷰 생성이 완료되지 않아요.