Sdílet prostřednictvím

ALTER STREAMING TABLE

  • Článek

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

Umožňuje:

  • Naplánujte obnovení existujícího streamu table.
  • Změnit existující plán refresh pro streamování table.
  • Zrušte plán refresh pro streamovací table. 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 table nebo jeho columns, 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 ] }

Parameters

  • table_name

    Název streamu table, jehož definici chcete změnit. Název nesmí obsahovat dočasnou specifikaci.

  • SCHEDULE [ REFRESH ] schedule_clause

    Umožňuje přidat rozvrh nebo změnit rozvrh streamování table.

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

      Pokud chcete naplánovat refresh, který se opakuje, použijte syntaxi EVERY. Pokud je zadaná syntaxe EVERY, streamování table nebo materializované zobrazení se pravidelně aktualizuje ve stanoveném intervalu na základě dané hodnoty, například HOUR, HOURS, DAY, DAYS, WEEKnebo WEEKS. Následující table uvádí seznam přijatých celočísel values 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 ]

      Naplánovat refresh pomocí quartz cron hodnoty. 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 časové pásmo relace není set, dojde k vyvolání chyby. 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;