Dela via

.alter-merge table policy mirroring command

  • Artikel

Gäller för: ✅Microsoft Fabric

Ändrar tabellernas speglingsprincip. Speglingsprincipen skapar en logisk kopia av tabeller i databasen i deltaparquet-format och gör att du kan partitionera dina filer för att förbättra frågehastigheten. Varje partition representeras som en separat kolumn med hjälp av PartitionName som anges i listan Partitioner. Det innebär att det finns fler kolumner i målet än i källtabellen.

Syntax

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

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Krävs Beskrivning
TableName sträng ✔️ Ett tabellnamn som följer Entitetsnamn regler.
partitioner sträng En kommaavgränsad lista över kolumner som används för att dela upp data i mindre partitioner. Se formatering av partitioner.
propertyName, propertyValue string En kommaavgränsad lista över nyckel/värde-egenskapspar. Se egenskaper som stöds.

Partitionsformatering

Listan partitioner är en kombination av partitionskolumner som anges med något av de formulär som visas i följande tabell.

Partitionstyp Syntax Anteckningar
Virtuell kolumn PartitionName: (datetime | string) Läs mer om virtuella kolumner.
Strängkolumnvärde PartitionName:string=ColumnName
Strängkolumnvärde hash() PartitionName:long=hash(ColumnName,Number) Hashen är modulo Number.
Trunkerad datetime-kolumn (värde) PartitionName:datetime= (startofyear | startofmonth | startofweek | startofday) (ColumnName) Se dokumentationen om startofyear, startofmonth, startofweekeller startofday functions.
Trunkerat datetime-kolumnvärde =bin(ColumnName,TimeSpan) Läs mer om funktionen bin.

Not

Varje partition representeras som en separat kolumn med hjälp av PartitionName som anges i listan Partitioner. PartitionName måste vara en skiftlägesokänslig unik sträng, både bland andra partitionsnamn och kolumnnamnen i den speglade tabellen.

Egenskaper som stöds

Namn Typ Beskrivning
IsEnabled bool Ett booleskt värde som avgör om speglingsprincipen är aktiverad. Standardvärdet är true. När speglingsprincipen är inaktiverad och inställd på falsetas underliggande speglingsdata bort och behålls i databasen.
TargetLatencyInMinutes int Skrivåtgärdens fördröjning i miniter. Skrivåtgärden kan som standard ta upp till 3 timmar eller tills det finns 256 MB tillgängliga data. Du kan justera fördröjningen till ett värde mellan 5 minuter och 3 timmar.

Not

När speglingsprincipen är aktiverad kan tabeller inte byta namn.

Exempel

.alter table policy mirroring

I följande exempel speglas en tabell med namnet myTable. Data partitioneras först efter namn och sedan efter datum.

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

Relaterat innehåll