Sincronizzazione dei metadati degli endpoint di analisi SQL

Questo articolo descrive cos'è l'endpoint di analisi SQL, come rimane sincronizzato con il lakehouse e i controlli da gestire. L'endpoint di analisi SQL rileva automaticamente la modifica e ne aggiorna i metadati SQL tramite un processo in background. È anche possibile aggiornare in modo gestito i metadati dell'endpoint di analisi SQL tramite il portale di Fabric, l'API REST o la stored procedure T-SQL.

Il processo in background di sincronizzazione dei metadati legge i log Delta dalla /Tables cartella in OneLake e mantiene aggiornato lo schema SQL.

Microsoft Fabric mantiene automaticamente sincronizzato l'endpoint di analisi SQL con il lakehouse sottostante. Nessuna infrastruttura da configurare e, nella maggior parte dei casi, non è necessaria alcuna azione da parte dell'utente. La piattaforma è responsabile di:

  • Rilevamento delle tabelle - rilevamento delle tabelle Delta appena create o eliminate nel lakehouse e creazione o rimozione delle corrispondenti tabelle SQL nell'endpoint.
  • Aggiornamento dei dati - rilevamento delle modifiche (inserimenti, aggiornamenti, eliminazioni) apportate ai dati nelle tabelle esistenti e garanzia che le query restituiscano risultati aggiornati.
  • Rilevamento delle modifiche dello schema : rilevamento di aggiunte, rimozioni o modifiche del tipo nelle tabelle Delta esistenti e aggiornamento della definizione di tabella SQL corrispondente.

Per informazioni dettagliate sul funzionamento di questa sincronizzazione e sui fattori che influiscono sulla latenza di sincronizzazione, vedere Considerazioni sulle prestazioni degli endpoint di analisi SQL.

Rilevamento modifiche dello schema e sincronizzazione dei metadati

Ogni lakehouse, warehouse, database e database con mirroring in Fabric viene automaticamente dotato del proprio endpoint di analisi SQL, consentendo di interrogare le tabelle Delta con T-SQL e il protocollo TDS, senza spostare né copiare i dati.

  • Ogni lakehouse, warehouse, database e database mirrorato ha esattamente un endpoint di analisi SQL.
  • Ogni tabella Delta nell'elemento sottostante viene automaticamente evidenziata come tabella SQL nell'endpoint.
  • L'endpoint è di sola lettura rispetto alle tabelle generate automaticamente. È possibile estendere il modello con schemi, viste, stored procedure e funzioni SQL personalizzati.
  • L'endpoint è basato sullo stesso motore di calcolo di Fabric Data Warehouse, quindi offre query SQL a bassa latenza e prestazioni elevate su file Delta aperti.

Nuova sincronizzazione dei metadati (anteprima)

Important

Questa funzionalità si trova in Anteprima.

A maggio 2026, la nuova sincronizzazione dei metadati per l'endpoint di analisi SQL è stata annunciata come funzionalità di anteprima. È possibile abilitare il nuovo processo di sincronizzazione dei metadati, che si applica solo ai nuovi endpoint di analisi SQL. La nuova opzione di sincronizzazione dei metadati consente di mantenere i dati disponibili per l'esecuzione di query entro pochi secondi dall'atterraggio nel lakehouse.

Il nuovo processo di sincronizzazione dei metadati include le funzionalità seguenti:

  • Nuova architettura basata su tabelle esterne per l'analisi dei log Delta e la creazione del catalogo.
  • Un'architettura disaccoppiata che rileva le modifiche dello schema e dei dati separatamente e aggiorna il catalogo di conseguenza.
  • Aggiornamento in background che verifica periodicamente la presenza di aggiornamenti dei dati.
  • Aggiornamento su richiesta dei dati quando si verifica una query di lettura in ingresso e il sistema rileva che i dati non sono aggiornati.

Abilitare la sincronizzazione dei nuovi metadati

È possibile abilitare la nuova sincronizzazione dei metadati nelle aree di lavoro passando a Impostazioni warehouse in Impostazioni area di lavoro.

Schermata del portale Fabric, pagina delle impostazioni dell'area di lavoro, che mostra l'opzione Warehouse New metadata sync e il riquadro New metadata sync (preview).

Quando si abilita la nuova sincronizzazione dei metadati, i nuovi endpoint di analisi SQL nell'area di lavoro vengono sincronizzati più velocemente quando si aggiornano le modifiche dalle tabelle sottostanti. Gli endpoint di analisi SQL esistenti non sono interessati.

Trovare l'ultimo aggiornamento dei metadati

Se si usa la nuova versione della sincronizzazione dei metadati, è possibile usare le viste a gestione dinamica (DMV) per ottenere informazioni dettagliate sull'aggiornamento più recente all'endpoint di analisi SQL. Usare la sys.dm_db_external_tables_log_status DMV per ottenere informazioni dettagliate sulla sincronizzazione dei metadati più recente:

  • last_update_time_utc: timestamp per l'ultima volta in cui la tabella è stata aggiornata con nuovi dati.
  • latest_log_version: La versione più alta del log delle transazioni Delta della tabella che è stata aggiornata.
  • latest_checkpoint_version: La versione più recente del checkpoint Delta che è stata elaborata.
  • is_blocked: indica se l'ultimo tentativo all'aggiornamento della tabella è stato bloccato (1) o riuscito (0).

Per altre informazioni, vedere sys.dm_db_external_tables_log_status.

Limitazioni della nuova sincronizzazione dei metadati

  • La nuova sincronizzazione dei metadati non supporta il checkpoint multipart, ovvero una funzionalità delta deprecata. Se le tabelle del lakehouse contengono checkpoint composti da più parti, non riescono ad aggiornarsi nella nuova sincronizzazione dei metadati.

Aggiornamento manuale

Oltre ai processi in background che aggiornano automaticamente i dati, è possibile aggiornare manualmente i metadati:

  • Aggiornare dal portale: nell’editor dell’endpoint di analisi SQL nel portale di Fabric, seleziona l’icona Refresh nella barra degli strumenti Explorer per forzare una sincronizzazione dei metadati su richiesta. Vai a Query del tuo endpoint di analisi SQL e cerca il pulsante Refresh nella barra degli strumenti.

    Screenshot del portale Fabric che mostra il pulsante Aggiorna schema per l'endpoint analitico SQL.

  • Aggiornare con l'API REST: usare l'API RESTAggiorna metadati dell'endpoint SQL per aggiornare a livello di codice i metadati di un endpoint di analisi SQL.

  • Aggiornamento tramite stored procedure: usare la stored procedure di sistema sys.sp_dw_refresh_ext_table per aggiornare i dati di una tabella specifica in un endpoint di analisi SQL. Questo metodo T-SQL è disponibile solo se l'endpoint di analisi SQL è stato creato dopo aver abilitato la sincronizzazione dei nuovi metadati (anteprima).This T-SQL method is available only if the SQL analytics endpoint was created after enabling the New metadata sync (preview). Per esempio:

    EXEC sys.sp_dw_refresh_ext_table "dbo.publicholidays";

Usare l'API solo se sono presenti modifiche dello schema, ad esempio l'aggiunta o l'eliminazione di tabelle o colonne, o la modifica dei tipi di colonne e la necessità di aggiornare l'intero elemento. Per le modifiche solo ai dati in un endpoint di analisi SQL, usare la sys.sp_dw_refresh_ext_table stored procedure di sistema per aggiornare una tabella specifica.

Per ottimizzare le tabelle Delta sottostanti per ottenere le migliori prestazioni di sincronizzazione e query dei metadati, vedere Considerazioni sulle prestazioni degli endpoint di analisi SQL.

Contenuti correlati

  • Last updated on