AGGIORNAMENTO (VISTA MATERIALIZZATA O TABELLA DI STREAMING)
Si applica a: Databricks SQL
Aggiornare i dati per una tabella di streaming o una vista materializzata. I dati vengono aggiornati in modo sincrono per impostazione predefinita.
È possibile tenere traccia dello stato dell'aggiornamento eseguendo DESCRIBE EXTENDED
.
Nota
Le operazioni di creazione e aggiornamento su viste materializzate e tabelle di streaming sono basate su una pipeline di tabelle live Delta serverless. È possibile usare Esplora cataloghi per visualizzare i dettagli sulle pipeline di supporto nell'interfaccia utente. Vedere Che cos'è Esplora cataloghi?.
Sintassi
REFRESH { MATERIALIZED VIEW | [ STREAMING ] TABLE } table_name [ FULL | { SYNC | ASYNC }]
Parametri
-
Identifica la vista materializzata o la tabella di streaming da aggiornare. Il nome non deve includere una specifica temporale. Se non è possibile trovare l'oggetto Azure Databricks genera un errore di TABLE_OR_VIEW_NOT_FOUND .
FULL
Indica se eseguire un aggiornamento completo.
- Per le viste materializzate, un aggiornamento completo elabora tutti i dati disponibili nell'origine.
- Per le tabelle di streaming, un aggiornamento completo tronca la tabella ed elabora tutti i dati disponibili nell'origine con la definizione più recente della tabella di streaming.
Non è consigliabile chiamare aggiornamenti completi sulle origini che non mantengono l'intera cronologia dei dati o hanno brevi periodi di conservazione, ad esempio Kafka, perché l'aggiornamento completo tronca i dati esistenti. Potrebbe non essere possibile recuperare i dati obsoleti se i dati non sono più disponibili nell'origine.
SINCRONIZZAZIONE
Indica se eseguire un aggiornamento sincrono. Il comando blocca fino a quando non viene creata la vista materializzata o la tabella di streaming e il caricamento iniziale dei dati termina.
Questo è il comportamento predefinito.
ASYNC
Indica se eseguire un aggiornamento asincrono, che avvia un processo in background nelle tabelle Live Delta. Il comando viene restituito immediatamente prima del completamento del caricamento dei dati con un collegamento alla pipeline Delta Live Tables che esegue il backup della vista materializzata o della tabella di streaming. È possibile visitare il collegamento per visualizzare lo stato dell'aggiornamento.
È necessario specificare
ASYNC
se si desidera eseguire aggiornamenti asincroni. L'operazione viene eseguita in modo sincrono se non viene specificata alcuna parola chiave.
Esempi
-- Refreshes the materialized view to reflect the latest available data
> REFRESH MATERIALIZED VIEW catalog.schema.view_name;
-- Refreshes the streaming table to process the latest available data
-- The current catalog and schema will be used to qualify the table
> REFRESH STREAMING TABLE st_name;
-- Truncates the table and processes all data from scratch for the streaming table
> REFRESH TABLE cat.db.st_name FULL;