Příkaz .alter-merge table policy mirroring
Platí pro: ✅Microsoft Fabric
Změní zásady zrcadlení tabulek. Zásady zrcadlení vytvoří logickou kopii tabulek v databázi ve formátu delta parquet a umožňuje rozdělit soubory, aby se zlepšila rychlost dotazů. Každý oddíl je reprezentován jako samostatný sloupec pomocí Názvu oddílu uvedeného v seznamu Oddíly. To znamená, že cíl obsahuje více sloupců než zdrojová tabulka.
Syntaxe
(.alter | .alter-merge) tableTableNamepolicy mirroring [partitionby (Oddíly)] dataformat = parquet [with(propertyName=propertyValue [, ...])]
Přečtěte si další informace o konvencích syntaxe.
Parametry
| Název | Type | Požadováno | Popis |
|---|---|---|---|
| TableName | string | ✔️ | Název tabulky, který dodržuje pravidla názvů entit. |
| Oddíly | string | Čárkami oddělený seznam sloupců, které slouží k rozdělení dat do menších oddílů. Viz formátování oddílů. | |
| propertyName, propertyValue | string |
Čárkami oddělený seznam párů vlastností klíč-hodnota. Viz podporované vlastnosti. |
Formátování oddílů
Seznam oddílů je libovolná kombinace sloupců oddílů zadaná pomocí jednoho z formulářů zobrazených v následující tabulce.
| Typ oddílu | Syntaxe | Notes |
|---|---|---|
| Virtuální sloupec |
PartitionName: (datetime | string) |
Přečtěte si další informace o virtuálních sloupcích. |
| Řetězcová hodnota sloupce |
PartitionName ColumnName:string= |
|
| Hodnota hash () řetězcové hodnoty sloupce |
long
=
hash(
, Number) |
Hodnota hash je modulo Number. |
| Zkrácený sloupec datetime (hodnota) |
PartitionName:datetime= (startofyear | startofmonth | startofweek | startofday) (ColumnName) |
Viz dokumentace k funkcím startofyear, startofmonth, startofweek nebo startofday . |
Zkrácená hodnota =bin(,TimeSpan) |
Přečtěte si další informace o funkci přihrádky . |
Poznámka:
Každý oddíl je reprezentován jako samostatný sloupec pomocí Názvu oddílu uvedeného v seznamu Oddíly. PartitionName musí být jedinečný řetězec nerozlišující velká a malá písmena, a to jak názvy oddílů, tak názvy sloupců zrcadlené tabulky.
Podporované vlastnosti
| Název | Type | Popis |
|---|---|---|
IsEnabled |
bool |
Logická hodnota, která určuje, jestli je zásada zrcadlení povolená. Výchozí hodnota je true. Pokud je zásada zrcadlení zakázaná a nastavená na false, podkladová data zrcadlení se v databázi odstraní a zachovají se. |
TargetLatencyInMinutes |
int |
Zpoždění operace zápisu v minitech. Ve výchozím nastavení může operace zápisu trvat až 3 hodiny nebo až do dostupnosti 256 MB dat. Zpoždění můžete upravit na hodnotu mezi 5 minutami a 3 hodinami. |
Poznámka:
Pokud je zásada zrcadlení povolená, nelze tabulky přejmenovat.
Příklady
Zrcadlení zásad .alter table
V následujícím příkladu se zrcadlí tabulka s názvem myTable . Data se rozdělí podle jména a potom podle data.
.alter table myTable policy mirroring
partition by (Name: string=Name, Date: datetime= startofday(timestamp))
dataformat=parquet
with
(IsEnabled=true)