Sdílet prostřednictvím

ALTER STREAMING TABLE

  • Článek

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

Umožňuje:

  • Přidejte plán aktualizace existující tabulky streamování.
  • Změna existujícího plánu aktualizace pro tabulku streamování
  • Odstraňte plán aktualizace pro tabulku streamování. Pokud se plán zahodí, je potřeba objekt aktualizovat ručně, aby odrážel nejnovější data.

Pokud chcete přidat nebo změnit komentář k tabulce nebo jeho sloupcům, použijte COMMENT ON.

Syntaxe

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 ] }

Parametry

  • table_name

    Název tabulky streamovacích dat, u které se má změnit definice. Název nesmí obsahovat dočasnou specifikaci.

  • SCHEDULE [ REFRESH ] schedule_clause

    Umožňuje přidat nebo upravit plán streamovací tabulky.

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

      Pokud chcete naplánovat aktualizaci, která se pravidelně provádí, použijte EVERY syntaxi. Pokud je zadaná syntaxe EVERY, aktualizuje se streamovaná tabulka nebo materializované zobrazení pravidelně v zadaném intervalu na základě zadané hodnoty, například HOUR, HOURS, DAY, DAYS, WEEKnebo WEEKS. V následující tabulce jsou uvedeny celočíselné hodnoty pro number.

      Časová jednotka Celočíselná hodnota
      HOUR or HOURS 1 <= H <= 72
      DAY or DAYS 1 <= D <= 31
      WEEK or WEEKS 1 <= W <= 8

      Poznámka:

      Jednotné a množné číslo zahrnuté časové jednotky jsou sémanticky ekvivalentní.

    • CRON cron_string [ AT TIME ZONE timezone_id ]

      Pro naplánování aktualizace pomocí hodnoty quartz cron. Jsou přijímány platné 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 pokud není nastavené časové pásmo relace, vyvolá se chyba. SCHEDULE je sémanticky ekvivalentní SCHEDULE REFRESH.

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 EVERY 15 MINUTES;

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