ALTER STREAMING TABLE

  • Articolo

Si applica a:check contrassegnato con sì Databricks SQL

Importante

Questa funzionalità è disponibile in anteprima pubblica. Per iscriversi per l'accesso, compilare il modulo.

Consente di:

  • Aggiungere una pianificazione per aggiornare una vista materializzata o una tabella di streaming esistente.
  • Modificare una pianificazione di aggiornamento esistente per una vista materializzata o una tabella di streaming.
  • Eliminare la pianificazione dell'aggiornamento per una vista materializzata o 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 ]
      CRON cron_string [ AT TIME ZONE timezone_id ] |
    DROP SCHEDULE
  }

Parametri

  • Table_name

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

  • SCHEDULE [ REFRESH ] CRON cron_string [ AT TIME ZONE timezone_id ]

    Se specificato, pianifica la tabella di streaming o la vista materializzata per aggiornare i dati con la pianificazione di cron al quarzi specificata. Vengono accettate solo time_zone_values . AT TIME ZONE LOCAL non è supportato. 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.

    Non è possibile usare la SCHEDULE sintassi in una definizione di pipeline delta Live Tables.

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;