Condividi tramite

ALTER STREAMING TABLE

  • Articolo

Si applica a:segno di spunta sì Databricks SQL

Consente di:

  • Aggiungere una pianificazione per l'aggiornamento di una tabella di streaming esistente.
  • Modificare la pianificazione di aggiornamento esistente per una tabella 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.

Per aggiungere o modificare un commento in una tabella o nelle relative colonne, utilizzare COMMENT ON.

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

  • table_name

    Nome della tabella di streaming di cui modificare la definizione. Il nome non deve includere una specifica temporale.

  • PROGRAMMA [ REFRESH ] clausola_programma

    Consente di aggiungere una programmazione a o modificare il programma di una tabella di streaming.

    • EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS }

      Per pianificare un aggiornamento che si verifica periodicamente, usare la sintassi EVERY. Se viene specificata la sintassi EVERY, la tabella di streaming o la vista materializzata viene aggiornata periodicamente all'intervallo dato dal valore indicato, ad esempio HOUR, HOURS, DAY, DAYS, WEEKo WEEKS. Nella tabella seguente sono elencati i valori integer accettati per number.

      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 . Vengono accettati time_zone_values validi. AT TIME ZONE LOCAL non è supportata.

      Se AT TIME ZONE è assente, viene usato il fuso orario della sessione. Se AT TIME ZONE è assente e il fuso orario della sessione non è impostato, viene generato un errore. SCHEDULE è semanticamente equivalente a SCHEDULE 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 EVERY 15 MINUTES;

-- Drops the schedule for a streaming table
> ALTER STREAMING TABLE my_st
  DROP SCHEDULE;