Sdílet prostřednictvím

ALTER STREAMING TABLE

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 |
    ALTER COLUMN clause |
    SET ROW FILTER clause |
    DROP ROW FILTER |
    SET TAGS clause |
    UNSET TAGS clause |
  }

  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.

  • PROMĚNIT COLUMN

    Důležité

    Tato funkce je ve verzi Public Preview.

    Změní vlastnost sloupce.

  • SET ROW FILTER klauzule

    Důležité

    Tato funkce je ve verzi Public Preview.

    Přidá funkci filtru řádků do tabulky streamování. Všechny následné dotazy do streamované tabulky obdrží podmnožinu řádků, ve kterých se funkce vyhodnotí jako logické TRUE. To může být užitečné pro jemně odstupňované řízení přístupu, kdy funkce může zkontrolovat identitu nebo členství ve skupině uživatele, který funkci vyvolává, a určit, zda se mají určité řádky filtrovat.

  • DROP ROW FILTER

    Důležité

    Tato funkce je ve verzi Public Preview.

    Odstraní filtr řádků z tabulky pro streamování, pokud existuje. Budoucí dotazy vrátí všechny řádky z tabulky bez automatického filtrování.

  • SET TAGS ( { tag_name = tag_value } [, ...] )

    Důležité

    Tato funkce je ve verzi Public Preview.

    Použijte značky u tabulky streamování. Musíte mít APPLY TAG oprávnění k přidání značek do streamované tabulky.

    • tag_name

      Literál STRING. Musí tag_name být jedinečný v rámci streamované tabulky nebo sloupce.

    • tag_value

      Literál STRING.

  • UNSET TAGS ( tag_name [, ...] )

    Důležité

    Tato funkce je ve verzi Public Preview.

    Odeberte značky ze streamované tabulky. Musíte mít APPLY TAG oprávnění k odebrání značek ze streamovací tabulky.

    • tag_name

      Literál STRING. Musí tag_name být jedinečný v rámci streamované tabulky nebo sloupce.

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;