Condividi tramite


AGGIORNAMENTO (VISTA MATERIALIZZATA E TABELLA DI STREAMING)

Si applica a: segno di spunta sì Databricks SQL

Importante

Questa funzionalità è disponibile in anteprima pubblica.

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.

Sintassi

REFRESH { MATERIALIZED VIEW | [ STREAMING ] TABLE } table_name [ FULL | { SYNC | ASYNC }]

Parametri

  • table_name

    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

    Se eseguire un aggiornamento completo, che tronca la tabella ed elabora tutti i dati disponibili nell'origine con la definizione più recente della tabella di streaming. Le viste materializzate non supportano aggiornamenti completi.

    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 e il caricamento iniziale dei dati termina.

    Si tratta del 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;