ALTER MATERIALIZED VIEW

Platí pro: zaškrtnuto ano Databricks SQL

Změní metadata přidružená k zobrazení.

Umožňuje provádět některou z následujících akcí:

Přidejte plán aktualizace existujícího materializovaného zobrazení.
Upravte existující plán aktualizace pro materializované zobrazení.
Zrušte plán aktualizace materializovaného zobrazení. Pokud se plán zruší, je potřeba objekt aktualizovat ručně, aby odrážel nejnovější data.

Pokud chcete přidat nebo změnit komentář k materializovanému zobrazení, použijte COMMENT ON.

Poznámka:

Změna datové sady vytvořené kanálem způsobem, který je v rozporu s definicí SQL, může způsobit vrácení některých změn. Viz Použití ALTER příkazů s deklarativními kanály Sparku Lakeflow.

Syntaxe

ALTER MATERIALIZED VIEW view_name
  {
    { ADD | ALTER } schedule |
    DROP SCHEDULE |
    ALTER COLUMN column_clause |
    SET ROW FILTER clause |
    DROP ROW FILTER |
    SET TAGS clause |
    UNSET TAGS clause }

  schedule
    { SCHEDULE [ REFRESH ] schedule_clause |
      TRIGGER ON UPDATE [ AT MOST EVERY trigger_interval ] }

  schedule_clause
    { EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } |
      CRON cron_string [ AT TIME ZONE timezone_id ] }

  column_clause
    column_identifier
    { COMMENT clause |
      SET MASK clause |
      DROP MASK |
      SET TAGS clause |
      UNSET TAGS clause }

Parametry

view_name

Název materializovaného zobrazení pro změnu definice. Název nesmí obsahovat dočasnou specifikaci.
rozvrh

Přidejte nebo upravte SCHEDULE příkaz v TRIGGER materializovaném zobrazení.

Poznámka:

Pomocí tohoto příkazu nemůžete upravit plán materializovaného zobrazení vytvořeného pomocí deklarativních kanálů Sparku Lakeflow. Použijte editor kanálu.
- SCHEDULE [ REFRESH ] schedule_clause
  - 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 ]
    
    Naplánujte aktualizaci pomocí hodnoty quartz cron. Platné time_zone_values jsou přijímány. 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é, dojde k chybě. SCHEDULE je sémanticky ekvivalentní SCHEDULE REFRESH.
- TRIGGER ON UPDATE [ AT MOST EVERY trigger_interval ]
  
  Důležité
  
  Funkce TRIGGER ON UPDATE je v beta verzi.
  
  Nastaví materializované zobrazení tak, aby se aktualizovalo, když se aktualizuje nadřazený zdroj dat, a to maximálně jednou za minutu. Nastavte hodnotu tak AT MOST EVERY , aby vyžadovala alespoň minimální čas mezi aktualizacemi.
  
  Nadřazené zdroje dat musí být externí nebo spravované tabulky Delta (včetně materializovaných zobrazení nebo streamovaných tabulek) nebo spravovaná zobrazení, jejichž závislosti jsou omezené na podporované typy tabulek.
  
  Povolení událostí souborů může zvýšit výkon triggerů a zvýšit některé limity pro aktualizace triggerů.
  
  Jedná se trigger_interval o příkaz INTERVAL , který je alespoň 1 minuta.
  
  TRIGGER ON UPDATE má následující omezení
  - Maximálně 10 nadřazených zdrojů dat pro materializované zobrazení při použití Triggeru ON UPDATE.
  - Pomocí triggeru ON UPDATElze zadat maximálně 1000 streamovaných tabulek nebo materializovaných zobrazení.
  - Výchozí AT MOST EVERY hodnota klauzule je 1 minuta a nesmí být menší než 1 minuta.
DROP SCHEDULE

Odebere rozvrh z materializovaného zobrazení.
ALTER COLUMN clause

Viz klauzule ALTERCOLUMN.
SET ROW FILTER klauzule

Důležité

Tato funkce je ve verzi Public Preview.

Přidá funkci filtru řádků do materializovaného zobrazení. Všechny následné dotazy do materializovaného zobrazení získají podmnožinu řádků, kde se funkce vyhodnotí na hodnotu typu boolean 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.

Filtry řádků přidané po vytvoření se po příští aktualizaci rozšíří pouze do podřízených tabulek. U průběžných kanálů to vyžaduje restartování kanálu.
DROP ROW FILTER

Důležité

Tato funkce je ve verzi Public Preview.

Pokud existuje, zahodí filtr řádků z materializovaného zobrazení. 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žití značek v materializovaném zobrazení Musíte mít APPLY TAG oprávnění k přidání značek do materializovaného zobrazení.
- tag_name
  
  Literál STRING. Musí tag_name být jedinečný v rámci materializovaného zobrazení nebo sloupce.
- tag_value
  
  Literál STRING.
UNSET TAGS ( tag_name [, ...] )

Důležité

Tato funkce je ve verzi Public Preview.

Odeberte tagy z materializovaného zobrazení. Musíte mít APPLY TAG oprávnění k odebrání značek z materializovaného zobrazení.
- tag_name
  
  Literál STRING. Musí tag_name být jedinečný v rámci materializovaného zobrazení nebo sloupce.

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

Klauzule ALTER COLUMN

Důležité

Tato funkce je ve verzi Public Preview.

Změní vlastnost nebo umístění sloupce.

Syntaxe

  ALTER COLUMN
    column_identifier
    { COMMENT comment |
      SET MASK mask_clause |
      DROP MASK |
      SET TAGS clause |
      UNSET TAGS clause }

Parametry

column_identifier

Název sloupce, který má být změněn.
COMMENT comment

Změní popis column_name sloupce. comment musí být STRING literál.
SET Klauzule MASK

Přidá funkci masky sloupce pro anonymizaci citlivých dat. Všechny následné dotazy z tohoto sloupce obdrží výsledek vyhodnocení této funkce místo původní hodnoty sloupce. To může být užitečné pro podrobné řízení přístupu, kdy funkce může zkontrolovat identitu nebo skupinové členství vyvolávajícího uživatele a určit, zda má být hodnota zredigována.

Masky sloupců přidané po vytvoření se po příští aktualizaci rozšíří pouze do podřízených tabulek. U průběžných kanálů to vyžaduje restartování kanálu.
DROP MASK

Odebere masku sloupce pro tento sloupec( pokud existuje). Budoucí dotazy z tohoto sloupce obdrží původní hodnoty sloupce.
SET TAGS ( { tag_name = tag_value } [, ...] )

Použijte značky u sloupce. Ke přidávání značek do sloupce potřebujete APPLY TAG oprávnění.
- tag_name
  
  Literál STRING. Musí tag_name být jedinečný v tabulce nebo sloupci.
- tag_value
  
  Literál STRING.
UNSET TAGS ( tag_name [, ...] )

Odstraňte zadané značky ze sloupce. Musíte mít APPLY TAG oprávnění k odebrání značek ze sloupce.
- tag_name
  
  Literál STRING. Musí tag_name být jedinečný v tabulce nebo sloupci.

Příklady

-- Adds a schedule to refresh the materialized view whenever its upstream data gets updated.
> ALTER MATERIALIZED VIEW my_mv
    ADD TRIGGER ON UPDATE;

-- Alters the schedule to refresh the materialized view when its upstream data
-- gets updated, and make sure the update frequency is no more than 1 update
-- per hour.
> ALTER MATERIALIZED VIEW my_mv
    ALTER TRIGGER ON UPDATE AT MOST EVERY INTERVAL 1 hour;

-- Alters the schedule to run every two hours for a materialized view
> ALTER MATERIALIZED VIEW my_mv
    ALTER SCHEDULE EVERY 2 HOURS;

-- Alters the schedule to refresh a materialized view once a day
-- at midnight in Los Angeles
> ALTER MATERIALIZED VIEW my_mv
    ALTER SCHEDULE CRON '0 0 0 * * ? *' AT TIME ZONE 'America/Los_Angeles';

-- Drops the schedule for a materialized view
> ALTER MATERIALIZED VIEW my_mv
    DROP SCHEDULE;

-- Adds a column comment
> ALTER MATERIALIZED VIEW my_mv
    ALTER COLUMN my_column_name COMMENT 'test'

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-11-28

Sdílet prostřednictvím

ALTER MATERIALIZED VIEW

Syntaxe

Parametry

Klauzule ALTER COLUMN

Syntaxe

Parametry

Příklady

Související články

Váš názor

Další materiály