.alter materialized-view

Článek
11/23/2024

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

Změna materializovaného zobrazení se dá použít ke změně dotazu materializovaného zobrazení a zachování existujících dat v zobrazení.

Upozorňující

Při změně materializovaného zobrazení buďte opatrní. Nesprávné použití může vést ke ztrátě dat.

Oprávnění

Abyste mohli tento příkaz spustit, musíte mít alespoň materializovaná oprávnění správce zobrazení.

Syntaxe

.altermaterialized-view [ with(PropertyName = PropertyValue,...)] MaterializedViewName on table SourceTableName{– dotaz }

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název	Type	Požadováno	Popis
PropertyName, PropertyValue	`string`		Seznam vlastností ve formě párů názvů a hodnot ze seznamu podporovaných vlastností
MaterializedViewName	`string`	✔️	Název materializovaného zobrazení
SourceTableName	`string`	✔️	Název zdrojové tabulky, na které je zobrazení definováno.
Dotaz	`string`	✔️	Definice dotazu materializovaného zobrazení

Podporované vlastnosti

Následující vlastnosti jsou podporovány v klauzuli with (PropertyName = PropertyValue.) Všechny vlastnosti jsou volitelné.

Name	Typ	Popis
lookback	`timespan`	Platné pouze pro `arg_max`//`arg_mintake_any` materializovaná zobrazení. Omezuje dobu, po kterou se očekávají duplicity. Pokud je například v zobrazení zadáno `arg_max` zpětné vyhledávání 6 hodin, odstranění duplicitních dat mezi nově přijatými záznamy a existujícími záznamy bude brát v úvahu pouze záznamy, které byly ingestovány až před 6 hodinami. Zpětné vyhledávání je relativní vzhledem k `ingestion_time`. Nesprávné definování období zpětného vyhledávání může vést k duplicitám v materializovaném zobrazení. Pokud se například záznam pro určitý klíč ingestuje 10 hodin po ingestování záznamu pro stejný klíč a zpětné vyhledávání je nastavené na 6 hodin, bude tento klíč v zobrazení duplicitní. Období zpětného vyhledávání se použije v době materializace i v době dotazu.
autoUpdateSchema	`bool`	Zda se má zobrazení u zdrojových tabulek automaticky aktualizovat. Výchozí hodnota je `false`. Tato možnost je platná pouze pro zobrazení typu `arg_max(Timestamp, )`//`arg_min(Timestamp, )take_any()` (pouze v případě, že argument sloupce je ).`` Pokud je tato možnost nastavená na `true`, změny zdrojové tabulky se automaticky projeví v materializovaném zobrazení.
DimensionTables	pole	Dynamický argument, který v zobrazení obsahuje pole tabulek dimenzí. Viz parametr dotazu.
souborů	`string`	Složka materializovaného zobrazení.
docString	`string`	Řetězec, který dokumentuje materializované zobrazení.

Návraty

Výstupní schéma:

Name	Typ	Popis
Name	`string`	Název materializovaného zobrazení
Zdrojová tabulka	`string`	Název zdrojové tabulky, na které je zobrazení definováno.
Dotaz	`string`	Definice dotazu materializovaného zobrazení
MaterializedTo	`datetime`	Maximální materializované časové razítko ingestion_time() ve zdrojové tabulce Další informace naleznete v tom , jak materializovaná zobrazení fungují.
LastRun	`datetime`	Čas posledního spuštění materializace
LastRunResult	`string`	Výsledek posledního spuštění Vrátí `Completed` pro úspěšná spuštění, jinak `Failed`.
IsHealthy	`bool`	`true` pokud je zobrazení považováno za zdravé, `false` jinak. Zobrazení je považováno za zdravé, pokud bylo úspěšně materializováno až do poslední hodiny (`MaterializedTo` je větší než `ago(1h)`).
IsEnabled	`bool`	`true` při povolení zobrazení (viz Zakázání nebo povolení materializovaného zobrazení)
Složka	`string`	Složka, pod kterou se vytvoří materializované zobrazení.
DocString	`string`	Popis přiřazený materializovanému zobrazení
AutoUpdateSchema	`bool`	Určuje, jestli je zobrazení povolené pro automatické aktualizace.
EffectiveDateTime	`datetime`	Datum účinnosti zobrazení určeného během vytváření (viz `.create materialized-view`).
Zpětné vyhledávání	`timespan`	Časový rozsah omezuje časové období, ve kterém jsou očekávány duplicity.

Příklady

Úprava definice dotazu materializovaného zobrazení

Následující příkaz upraví definici dotazu materializovaného zobrazení MyView:

.alter materialized-view MyView on table MyTable
{
    MyTable | summarize arg_max(Column3, *) by Column1
}

Výstup

Název	Zdrojová tabulka	Dotaz	MaterializedTo	LastRun	LastRunResult	IsHealthy	IsEnabled	Složka	DocString	AutoUpdateSchema	EffectiveDateTime	Zpětné vyhledávání
MyView	MyTable	Tabulka \| summarize arg_max(Column3; *) by Column1	2023-02-26T16:40:03.3345704Z	2023-02-26T16:44:15.9033667Z	Dokončeno	true	true			false (nepravda)	2023-02-23T14:01:42.5172342Z

Případy použití

Přidání agregací do zobrazení – například přidání avg agregace do T | summarize count(), min(Value) by Id, změnou dotazu zobrazení na T | summarize count(), min(Value), avg(Value) by Id.
Změňte operátory jiné než operátor sumarizace. Například vyfiltrujte některé záznamy tak, že změníte T | summarize arg_max(Timestamp, *) by User na T | where User != 'someone' | summarize arg_max(Timestamp, *) by User.
Změňte dotaz beze změny kvůli změně ve zdrojové tabulce. Předpokládejme například zobrazení T | summarize arg_max(Timestamp, *) by Id, které není nastavené na autoUpdateSchema (viz .create materialized-view příkaz). Pokud se sloupec přidá nebo odebere ze zdrojové tabulky zobrazení, zobrazení se automaticky zakáže. Provedením příkazu alter se stejným dotazem změňte schéma materializovaného zobrazení tak, aby odpovídalo novému schématu tabulky. Zobrazení musí být po změně explicitně povoleno pomocí příkazu povolit materializované zobrazení .

Omezení

Změny se nepodporují:
- Změny materializované skupiny zobrazení podle výrazů
- Změna typu sloupce
- Přejmenování sloupců Například změna zobrazení T | summarize count() by Id na pokles sloupce count_ a vytvoření nového sloupce Count, který zpočátku obsahuje T | summarize Count=count() by Id pouze hodnoty null.
Dopad na existující data:
- Změna materializovaného zobrazení nemá žádný vliv na existující data.
- Přidání filtrů do dotazu se vztahuje pouze na nově ingestované záznamy a nemění záznamy, které už byly materializovány.
  - Nové sloupce přijímají hodnoty null pro všechny existující záznamy, dokud záznamy ingestované po příkazu alter nezmění hodnoty null.
  - Příklad: Zobrazení T | summarize count() by bin(Timestamp, 1d) je změněno na T | summarize count(), sum(Value) by bin(Timestamp, 1d). Pro konkrétní Timestamp=T záznamy, které již byly zpracovány před změnou zobrazení, sum sloupec obsahuje částečná data. Toto zobrazení obsahuje pouze záznamy zpracovávané po provedení změny.

Sdílet prostřednictvím