Shortcut transformations convert raw files into Delta tables that stay always in sync with the source data.
변환은 Fabric Spark 컴퓨팅에서 실행되며, OneLake 바로 가기에서 참조하는 데이터를 관리되는 델타 테이블에 복사 하므로 기존 ETL 파이프라인을 직접 빌드하고 오케스트레이션할 필요가 없습니다.
Note
Shortcut transformations are currently in public preview and are subject to change.
바로 가기 변환을 사용하는 이유는 무엇인가요?
- 수동 파이프라인 없음 – Fabric은 원본 파일을 델타 형식으로 자동으로 복사하고 변환합니다. 증분 로드를 오케스트레이션할 필요가 없습니다.
- Frequent refresh – Fabric checks the shortcut every 2 minutes and synchronizes any changes almost immediately.
- 분석 준비 열기 - 출력은 Apache Spark 호환 엔진이 쿼리할 수 있는 Delta Lake 테이블입니다.
- Unified governance – The shortcut inherits OneLake lineage, permissions, and Microsoft Purview policies.
- Spark based – Transforms build for scale.
Prerequisites
| Requirement | Details |
|---|---|
| Microsoft Fabric 제품 번호 | Capacity or Trial that supports Lakehouse workloads. |
| OneLake shortcut | A shortcut targeting a folder that contains homogeneous CSV files. |
| Workspace role | Contributor or higher. |
지원되는 원본 및 대상
| 원본 파일 형식 | Destination | Notes |
|---|---|---|
| CSV(UTF-8, 쉼표로 구분) | Lakehouse/Tables 폴더의 Delta Lake 테이블 | 미리 보기 중에 추가 형식(Parquet, JSON)이 추가됩니다. |
단축키 변환 설정하기
- Lakehouse에서 + 새 > 바로 가기 변환(미리 보기)을 선택합니다.
- Choose shortcut – Browse to an existing OneLake shortcut that points to the folder with your CSV files.
-
Configure transformation:
- Table name – Provide a friendly name; Fabric creates it under /Tables.
- Delimiter – Select the character used to separate columns (comma, semicolon, pipe, tab).
- 첫 번째 행을 머리글로 - 첫 번째 행에 열 이름이 포함되어 있는지 여부를 나타냅니다.
- Select Create.
Fabric Spark compute copies the data into a Delta table and shows progress in the Manage shortcuts pane.
동기화 작동 방식
초기 로드 후 Fabric Spark 컴퓨팅:
- 2분마다 바로 가기 대상의 상태를 확인합니다.
- 새 파일 또는 수정된 파일을 검색하고 그에 따라 행을 추가하거나 덮어씁니다.
- Detects deleted files and removes corresponding rows.
모니터링 및 문제 해결
- Open the lakehouse and select Shortcuts in the left pane.
- 변화를 촉진하는 바로 가기를 선택하세요.
- In the details pane, select the Manage shortcut tab to view:
- Status – Last scan result and current sync state.
- Activity log – Chronological list of sync operations with row counts and any error details.
From this tab you can also Pause or Delete the transformation if needed.
Limitations (preview)
- Only CSV sources are supported.
- 파일은 동일한 스키마를 공유해야 합니다. 스키마 드리프트는 아직 지원되지 않습니다.
- Transformations are read-optimized; MERGE INTO or DELETE statements directly on the table are blocked.
- Available only in Lakehouse items (not Warehouses or KQL databases).
Clean up
동기화를 중지하려면 lakehouse UI에서 바로 가기 변환을 삭제합니다.
변환을 삭제해도 기본 파일은 제거되지 않습니다.