ALTER STREAMING TABLE

  • Článek

Platí pro:zaškrtnutí označeného ano Databricks SQL

Důležité

Tato funkce je ve verzi Public Preview.

Umožňuje:

  • Přidejte plán aktualizace existujícího materializovaného zobrazení nebo tabulky streamování.
  • Upravte existující plán aktualizace pro materializované zobrazení nebo tabulku streamování.
  • Vypusťte plán aktualizace pro materializované zobrazení nebo tabulku streamování. Pokud se plán zahodí, je potřeba objekt aktualizovat ručně, aby odrážel nejnovější data.

Syntaxe

ALTER STREAMING TABLE table_name
  {
    { ADD | ALTER } SCHEDULE [ REFRESH ]
      CRON cron_string [ AT TIME ZONE timezone_id ] |
    DROP SCHEDULE
  }

Parametry

  • Table_name

    Název tabulky streamování, která má změnit definici. Název nesmí obsahovat dočasnou specifikaci.

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

    Pokud je k dispozici, naplánuje streamovací tabulku nebo materializované zobrazení, aby aktualizovala data s daným plánem quartz cron . Akceptují se pouze time_zone_values . AT TIME ZONE LOCAL není podporováno. Pokud AT TIME ZONE chybí, použije se časové pásmo relace. Pokud AT TIME ZONE chybí a časové pásmo relace není nastavené, vyvolá se chyba. SCHEDULE je sémanticky ekvivalentní SCHEDULE REFRESH.

    Syntaxi nelze použít SCHEDULE v definici kanálu Delta Live Tables.

Příklady

-- 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;