Trasformazioni di file di scorciatoie

Shortcut transformations convert raw files into Delta tables that stay always in sync with the source data.
La trasformazione viene eseguita dal calcolo di Fabric Spark, che copia i dati a cui fa riferimento un collegamento OneLake in una tabella Delta gestita in modo da non dover compilare e orchestrare manualmente le pipeline ETL tradizionali.

Note

Shortcut transformations are currently in public preview and are subject to change.

Perché usare le trasformazioni rapide?

• Nessuna pipeline manuale : Fabric copia e converte automaticamente i file di origine in formato Delta; non è necessario orchestrare i carichi incrementali.
• Frequent refresh – Fabric checks the shortcut every 2 minutes and synchronizes any changes almost immediately.
• Open & analytics-ready - l'output è una tabella Delta Lake che qualsiasi motore compatibile con Apache Spark può interrogare.
• Unified governance – The shortcut inherits OneLake lineage, permissions, and Microsoft Purview policies.
• Spark based – Transforms build for scale.

Prerequisites

Requirement	Details
SKU di 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.

Origini e destinazioni supportate

Formato del file di origine	Destination	Notes
CSV (UTF-8, delimitato da virgole)	Tabella Delta Lake nella cartella Lakehouse/Tables	Durante l'anteprima verranno aggiunti altri formati (Parquet, JSON).

Configurare una trasformazione scorciatoia

1. In lakehouse, selezionare >
2. Choose shortcut – Browse to an existing OneLake shortcut that points to the folder with your CSV files.
3. 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).
   • Prima riga come intestazioni : indica se la prima riga contiene nomi di colonna.
4. Select Create.

Fabric Spark compute copies the data into a Delta table and shows progress in the Manage shortcuts pane.

Funzionamento della sincronizzazione

Dopo il caricamento iniziale, calcolo di Fabric Spark:

• Controlla la destinazione del collegamento ogni 2 minuti.
• Rileva file nuovi o modificati e aggiunge o sovrascrive le righe di conseguenza.
• Detects deleted files and removes corresponding rows.

Monitorare e risolvere i problemi

1. Open the lakehouse and select Shortcuts in the left pane.
2. Scegli la scorciatoia che alimenta la tua trasformazione.
3. 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.
• I file devono condividere uno schema identico; la deriva dello schema non è ancora supportata.
• 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

Per arrestare la sincronizzazione, eliminare la trasformazione del collegamento dall'interfaccia utente di Lakehouse.
L'eliminazione della trasformazione non comporta la rimozione dei file sottostanti.