ALTER MATERIALIZED VIEW
Si applica a: Databricks SQL
Modifica i metadati associati alla vista.
Consente di eseguire una delle azioni seguenti:
- Aggiungere una pianificazione per aggiornare una vista materializzata esistente.
- Modificare una pianificazione refresh esistente per una vista materializzata.
- Eliminare la pianificazione refresh per una vista materializzata. Se la pianificazione viene eliminata, l'oggetto deve essere aggiornato manualmente per riflettere i dati più recenti.
Per aggiungere o modificare un commento su una visualizzazione o sulla relativa columns, usare COMMENT ON.
Sintassi
ALTER MATERIALIZED VIEW view_name
{ schedule }
schedule
{
{ ADD | ALTER } SCHEDULE [ REFRESH ]
schedule_clause |
DROP SCHEDULE
}
schedule_clause
{ EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } |
CRON cron_string [ AT TIME ZONE timezone_id ] }
Parameters
SCHEDULE [ REFRESH ] clausola_di_programma
Consente di aggiungere o modificare la pianificazione di una vista materializzata.
EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS }
Importante
Questa funzionalità è disponibile in anteprima pubblica.
Per pianificare un refresh che si verifica periodicamente, utilizzare la sintassi
EVERY
. Se la sintassiEVERY
è specificata, il flusso table o la vista materializzata viene aggiornata periodicamente all'intervallo specificato in base al valore fornito, comeHOUR
,HOURS
,DAY
,DAYS
,WEEK
oWEEKS
. Nell'table seguente sono elencati i values integer accettati pernumber
.Time unit Valore intero HOUR or HOURS
1 <= H <= 72 DAY or DAYS
1 <= D <= 31 WEEK or WEEKS
1 <= W <= 8 Nota
Le forme singolari e plurali dell'unità temporale inclusa sono semanticamente equivalenti.
CRON cron_string [ AT TIME ZONE timezone_id ]
Per pianificare un refresh utilizzando un cron valore. Vengono accettati time_zone_values validi.
AT TIME ZONE LOCAL
non è supportata.Se
AT TIME ZONE
è assente, viene usato il fuso orario della sessione. SeAT TIME ZONE
è assente e il fuso orario della sessione non è set, viene generato un errore.SCHEDULE
è semanticamente equivalente aSCHEDULE REFRESH
.
Esempi
-- Adds a schedule to refresh a materialized view once a day
-- at midnight in Los Angeles
> ALTER MATERIALIZED VIEW my_mv
ADD SCHEDULE CRON '0 0 0 * * ? *' AT TIME ZONE 'America/Los_Angeles';
-- Alters the schedule to run every 15 minutes for a materialized view
> ALTER MATERIALIZED VIEW my_mv
ALTER SCHEDULE CRON '0 0/15 * * * ? *';
-- Drops the schedule for a materialized view
> ALTER MATERIALIZED VIEW my_mv
DROP SCHEDULE;