Condividi tramite


ALTER STREAMING TABLE

Si applica a: segno di spunta sì 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

  • table_name

    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. Se EVERY si specifica la sintassi, la tabella di streaming o la vista materializzata viene aggiornata periodicamente all'intervallo specificato in base al valore specificato, ad esempio HOUR, HOURSDAY, 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 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. 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 CRON '0 0/15 * * * ? *';

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