Share via


의미 체계 모델을 위한 OneLake 통합

Important

의미 체계 모델에 대한 OneLake 통합은 현재 미리 보기로 제공됩니다.

의미 체계 모델에 대한 Microsoft OneLake 통합을 사용하면 모델 테이블로 가져온 데이터를 OneLake의 Delta 테이블에 자동으로 기록할 수도 있습니다. Delta 형식은 Microsoft Fabric의 모든 컴퓨팅 엔진에서 통합 테이블 형식입니다. OneLake 통합은 더 높은 성능으로 보다 원활한 데이터 액세스를 제공하기 위해 모든 주요 성능 기능이 활성화된 데이터를 내보냅니다.

데이터 과학자, 데이터베이스 분석가, 앱 개발자, 데이터 엔지니어 및 기타 데이터 소비자는 Power BI에서 비즈니스 인텔리전스 및 재무 보고서를 구동하는 동일한 데이터에 액세스할 수 있습니다. T-SQL, Python, Scala, PySpark, Spark SQL, R 및 코드 없음/하위 코드 솔루션은 모두 Delta 테이블의 데이터를 쿼리하는 데 사용할 수 있습니다.

Diagram of OneLake integration for semantic models

조직에서 OneLake 통합 솔루션을 구현하기 전에 이 문서의 뒷부분에 고려 사항 및 제한 사항을 읽어보세요.

필수 조건

의미 체계 모델에 대한 OneLake 통합은 Power BI Premium P 및 Microsoft Fabric F SKU에서만 지원됩니다. Power BI Pro, 사용자 단위 Premium 또는 Power BI Embedded A/EM SKU에서는 지원되지 않습니다.

OneLake 통합을 사용하도록 설정하기 전에 다음이 있어야 합니다.

사용 권한

모델 기여자 (읽기, 쓰기, 탐색) 권한은 모델 폴더의 내용에 액세스하고 Lakehouse 탐색기에서 폴더에 연결하는 바로 가기를 만드는 데 필요합니다.

OneLake 통합 사용

의미 체계 모델 설정에서 OneLake 통합을 확장하고 슬라이더를 켜기로 클릭하고 적용을 선택합니다.

Enable OneLake integration in model settings.

관리 포털

전역 및 테넌트 관리자는 Power BI 관리 포털에서 다음 설정을 사용하여 OneLake 통합을 제어할 수 있습니다.

Screenshot of tenant settings for admin portal.

  • 의미 체계 모델은 OneLake 로 데이터를 내보낼 수 있습니다. 이를 통해 조직 수준에서 OneLake를 통합할 수 있습니다. 사용하지 않도록 설정된 경우 사용자는 의미 체계 모델에 대해 OneLake 통합을 켤 수 없으며 현재 OneLake 통합을 위해 구성된 의미 체계 모델은 가져오기 테이블을 OneLake로 내보내는 것을 중지합니다. OneLake 통합은 기본적으로 전체 조직에 대해 사용하도록 설정됩니다.

  • 사용자는 OneLake 에 의미 체계 모델 테이블을 저장할 수 있습니다. 조직의 모든 또는 선택한 사용자가 의미 체계 모델에 대해 OneLake 통합을 구성할 수 있습니다. 특정 사용자에 대해 사용하지 않도록 설정된 경우 해당 사용자는 더 이상 OneLake 통합을 켤 수 없지만 OneLake 통합을 위해 이미 구성한 의미 체계 모델은 계속해서 가져오기 테이블을 OneLake로 내보냅니다. 해당 사용자는 OneLake 통합을 위해 이미 구성된 의미 체계 모델에 대해 OneLake 통합을 사용하지 않도록 설정할 수 있지만 OneLake 통합을 다시 사용하도록 설정할 수는 없습니다. 이 설정을 사용하려면 의미 체계 모델이 OneLake 테넌트 설정으로 데이터를 내보낼 수 있어야 합니다. 기본적으로 조직의 모든 사용자는 의미 체계 모델에 대해 OneLake 통합을 구성할 수 있습니다.

모델 새로 고침

모델 가져오기 데이터를 OneLake의 Delta 테이블에 쓰려면 모델에 대해 하나 이상의 수동 또는 예약된 새로 고침을 실행해야 합니다. 수동 새로 고침을 실행하거나 예약된 새로 고침을 기다립니다.

OneLake Delta 테이블 내보내기

Delta 테이블은 여러 가지 방법으로 내보낼 수 있습니다. 의미 체계 모델에 XMLA 읽기/쓰기 모드가 활성화되어 있는 경우 테이블 형식 개체 모델(TOM)테이블 형식 모델 스크립팅 언어(TMSL)를 사용하여 프로그래밍 방식으로 내보낼 수 있습니다.

예를 들어 SSMS(SQL Server Management Studio)를 사용하여 다음 TMSL 명령을 실행할 수 있습니다.

{  
 "export": {  
   "layout": "delta",
   "type": "full",  
   "objects": [  
     {  
       "database": "<database name>"  
     }  
   ]  
 }  
}

내보내기 파일 탐색

내보낸 후 OneLake를 Windows 파일 탐색기와 통합하는 OneLake 파일 탐색기를 사용하여 Delta 테이블 내보내기 파일을 찾을 수 있습니다.

  1. OneLake 파일 탐색기에서 작업 영역 폴더를 마우스 오른쪽 단추로 클릭한 다음 OneLake 동기화를 선택합니다.

  2. Windows 파일 탐색기를 사용하여 데이터 파일을 찾습니다. 작업 영역 폴더에서 의미 체계 모델과 일치하고 이름이 .SemanticModel로 끝나는 하위 폴더를 찾습니다. 의미 체계 모델 폴더에는 Delta 테이블의 parquet 파일과 로그가 포함된 하위 폴더에 있는 모든 가져오기 모드 테이블이 포함됩니다.

    TMSL export command in SSMS.

바로 가기

의미 체계 모델 Lakehouse 테이블에 대한 바로 가기를 만들면 Fabric의 다른 워크로드에서 빠르고 쉽게 액세스할 수 있습니다.

  1. Lakehouse 탐색기에서 테이블을 마우스 오른쪽 단추로 클릭한 다음 새 바로 가기를 선택합니다.

  2. 새 바로 가기에서 Microsoft OneLake를 선택합니다.

  3. 데이터 원본 형식을 선택하고 의미 체계 모델을 선택한 다음 포함할 테이블을 선택합니다.

    OneLake shortcuts in Explorer

고려 사항 및 제한 사항

  • 미리 보기 중에 소수점 이하 18자리보다 큰 값을 가진 통화 데이터 유형은 Delta 파일로 내보낼 때 약간의 정밀도 손실이 발생할 수 있습니다.

  • 미리 보기 중에는 BYOK를 사용하도록 설정된 작업 영역의 의미 체계 모델은 지원되지 않습니다.

  • 미리 보기 중에는 SQL 엔드포인트를 사용하여 Lakehouse에서 내보낸 모델을 기반으로 빌드된 바로 가기 테이블을 쿼리할 수 없습니다.

  • 미리 보기 중에는 Multi-Geo 용량이 아직 지원되지 않습니다.

  • 미리 보기 중에는 OneLake로 모델을 내보내는 작업은 요금이 청구되지 않지만 OneLake 에서 내보낸 모델의 컴퓨팅 및 스토리지 사용량은 청구됩니다.

  • 내보낸 모델 테이블에 대한 기여자 권한이 있지만 작업 영역에 대한 보기 권한만 있는 사용자의 경우 모델 폴더가 Lakehouse 탐색기에 나타나지만 선택하면 오류가 반환됩니다.

  • 측정값, DirectQuery 테이블, 하이브리드 테이블, 계산 그룹 테이블 및 시스템 관리 집계 테이블은 Delta 형식 테이블로 내보낼 수 없습니다.

  • 단일 버전의 델타 테이블만 내보내져 OneLake에 저장됩니다. 이전 버전의 델타 테이블은 성공적으로 내보내기 후에 삭제됩니다. 지금은 삭제되었지만 이전 버전의 데이터를 사용하는 다른 실행 엔진에서는 일시적인 오류가 발생할 수 있습니다.