ALTER STREAMING TABLE
Si applica a: Databricks SQL
Consente di:
- Aggiungere una pianificazione per l'aggiornamento di una tabella di streaming esistente.
- Modificare una pianificazione di aggiornamento esistente per una tabella di streaming.
- Eliminare la pianificazione dell'aggiornamento per una tabella di streaming. Se la pianificazione viene eliminata, l'oggetto deve essere aggiornato manualmente per riflettere i dati più recenti.
Sintassi
ALTER STREAMING TABLE table_name
{
{ 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 ] }
Parametri
-
Nome della tabella di streaming per modificare la definizione di . Il nome non deve includere una specifica temporale.
SCHEDULE [ REFRESH ] schedule_clause
Consente di aggiungere o modificare la pianificazione di una tabella di streaming.
EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS }
Importante
Questa funzionalità è disponibile in anteprima pubblica.
Per pianificare un aggiornamento che si verifica periodicamente, usare la
EVERY
sintassi. SeEVERY
si specifica la sintassi, la tabella di streaming o la vista materializzata viene aggiornata periodicamente all'intervallo specificato in base al valore specificato, ad esempioHOUR
,HOURS
DAY
,DAYS
, ,WEEK
oWEEKS
. Nella tabella seguente sono elencati i valori 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 aggiornamento utilizzando un valore cron di quarzi. 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 è impostato, viene generato un errore.SCHEDULE
è semanticamente equivalente aSCHEDULE REFRESH
.
Esempi
-- Adds a schedule to refresh the streaming table once a day
-- at midnight in Los Angeles
> ALTER STREAMING TABLE my_st
ADD SCHEDULE CRON '0 0 0 * * ? *' AT TIME ZONE 'America/Los_Angeles';
-- Alters the schedule to run every 15 minutes for a streaming table
> ALTER STREAMING TABLE my_st
ALTER SCHEDULE CRON '0 0/15 * * * ? *';
-- Drops the schedule for a streaming table
> ALTER STREAMING TABLE my_st
DROP SCHEDULE;