.alter-merge table policy mirroring command

Artikel
2025-03-09

Van toepassing op: ✅Microsoft Fabric-

Hiermee wijzigt u het beleid voor spiegeling van tabellen. Het spiegelingsbeleid maakt een logische kopie van tabellen in uw database in delta parquet-indeling en stelt u in staat om uw bestanden te partitioneren om de querysnelheid te verbeteren. Elke partitie wordt weergegeven als een afzonderlijke kolom met behulp van de PartitionName vermeld in de partities lijst. Dit betekent dat er meer kolommen in het doel staan dan in de brontabel.

Syntaxis

(.alter | .alter-merge) tableTableNamepolicy mirroring [partitionby (Partitions)] dataformat = parquet [with(propertyName=propertyValue [, ...])]

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
TableName-	snaar	✔️	Een tabelnaam die voldoet aan de Entiteitsnamen regels.
partities	snaar		Een door komma's gescheiden lijst met kolommen die worden gebruikt om de gegevens te verdelen in kleinere partities. Zie Partities opmaken.
propertyName, propertyValue	`string`		Een door komma's gescheiden lijst met sleutel-waarde-eigenschapsparen. Zie ondersteunde eigenschappen.

Opmaak van partities

De lijst met partities is een combinatie van partitiekolommen, die zijn opgegeven met behulp van een van de formulieren die in de volgende tabel worden weergegeven.

Partitietype	Syntaxis	Notities
Virtuele kolom	PartitionName`:` (`datetime` \| `string`)	Lees meer over virtuele kolommen.
Kolomwaarde tekenreeks	PartitionName`:string=`ColumnName
Kolomwaarde tekenreeks hash()	PartitionName`:long=hash(`ColumnName`,`Number`)`	De hash is modulo Number.
Afgekapte datum/tijd-kolom (waarde)	PartitionName`:datetime=` (`startofyear` \| `startofmonth` \| `startofweek` \| `startofday`) `(`ColumnName`)`	Zie de documentatie over startofyear, startofmonth, startofweekof startofday functies.
Afgekapte datum/tijd-kolomwaarde `=bin(`ColumnName`,`TimeSpan-`)`	Lees meer over de functie bin.

Notitie

Elke partitie wordt weergegeven als een afzonderlijke kolom met behulp van de PartitionName vermeld in de partities lijst. PartitionName- moet een niet-hoofdlettergevoelige unieke tekenreeks zijn, zowel tussen andere partitienamen als de kolomnamen van de gespiegelde tabel.

Ondersteunde eigenschappen

Naam	Type	Beschrijving
`IsEnabled`	`bool`	Een Booleaanse waarde die bepaalt of het spiegelingsbeleid is ingeschakeld. De standaardwaarde is `true`. Wanneer het spiegelingsbeleid is uitgeschakeld en is ingesteld op `false`, worden de onderliggende spiegelingsgegevens voorlopig verwijderd en bewaard in de database.
`TargetLatencyInMinutes`	`int`	De vertraging van de schrijfbewerking in minites. De schrijfbewerking kan standaard tot 3 uur duren of totdat er 256 MB aan gegevens beschikbaar is. U kunt de vertraging aanpassen aan een waarde tussen 5 minuten en 3 uur.
`Backfill`	`bool`	Als deze is ingesteld op `true`, begint spiegeling vanaf de `EffectiveDateTime`. Als `EffectiveDateTime` niet is opgegeven, worden alle tabelgegevens gespiegeld. De standaardwaarde is `false`.
`EffectiveDateTime`	`datetime`	Relevant wanneer Backfill is ingesteld op `true`. Indien opgegeven, begint spiegeling vanaf de opgegeven waarde.

Notitie

Wanneer het spiegelingsbeleid is ingeschakeld, kunnen tabellen niet worden gewijzigd.

Voorbeelden

.alter table policy mirroring

In het volgende voorbeeld wordt een tabel met de naam myTable gespiegeld. De gegevens worden eerst gepartitioneerd op naam en vervolgens op datum.

.alter table myTable policy mirroring
  partition by (Name: string=Name, Date: datetime= startofday(timestamp))
  dataformat=parquet
  with
  (IsEnabled=true, Backfill=true, EffectiveDateTime=datetime(2025-01-01))

Zie opdracht voor tabelspiegelingsbewerkingen weergevenom spiegelingsbewerkingen te controleren.
Zie opdracht voor het spiegelen van tabelbeleid verwijderenom spiegelingsbewerkingen te verwijderen.

Delen via