Spiegelungsrichtlinie

Artikel
09/26/2024

Gilt für: ✅Microsoft Fabric

Mit den Befehlen für die Spiegelungsrichtlinie können Sie Ihre Tabellenspiegelungsrichtlinie anzeigen, ändern, partitionieren und löschen. Sie bieten auch eine Möglichkeit, die Spiegelungslatenz zu überprüfen, indem sie den Spiegelungsstatus der Vorgänge überprüfen.

Befehle für Verwaltung

Verwenden Sie den Befehl "Tabellenrichtlinienspiegelung anzeigen" , um die aktuelle Spiegelungsrichtlinie der Tabelle anzuzeigen.
Verwenden Sie den Befehl ".alter-merge table policy mirroring" zum Ändern der aktuellen Spiegelungsrichtlinie.
Verwenden Sie den Befehl ".delete-Tabellenrichtlinienspiegelung", um die aktuelle Spiegelungsrichtlinie vorläufig zu löschen.
Verwenden Sie den Befehl zum Anzeigen von Tabellenspiegelungsvorgängen, um den Spiegelungsstatus von Vorgängen zu überprüfen.
Verwenden Sie den Befehl ".show table mirroring operations exported artifacts" zum Überprüfen des Status der exportierten Artefakte.
Verwenden Sie .show table mirroring operations failure to check operations mirroring failure status.

Das Richtlinienobjekt

Die Spiegelungsrichtlinie enthält die folgenden Eigenschaften:

Eigenschaft	BESCHREIBUNG	Werte	Standard
Format	Das Format Ihrer gespiegelten Dateien.	Gültiger Wert ist `parquet`.	`parquet`
ConnectionStrings	Ein Array von Verbindungszeichenfolge, die beim Konfigurieren und Einrichten von Verbindungen helfen. Dieser Wert wird automatisch aufgefüllt.
IsEnabled	Bestimmt, ob die Spiegelungsrichtlinie aktiviert ist. Wenn die Spiegelungsrichtlinie deaktiviert und auf `false`diese festgelegt ist, werden die zugrunde liegenden Spiegelungsdaten in der Datenbank aufbewahrt.	`true`, , `falsenull`.	`null`
Partitionen	Eine durch Trennzeichen getrennte Liste von Spalten, die zum Aufteilen der Daten in kleinere Partitionen verwendet werden.	Siehe Partitionsformatierung.

Warnung

Durch das Löschen oder Ablegen der Tabellenspiegelungsrichtlinie wird die Delta-Tabelle in OneLake endgültig gelöscht.

Hinweis

Wenn die Spiegelungsrichtlinie aktiviert ist, können Tabellen nicht umbenannt werden.

Partitionsformatierung

Die Partitionsliste ist eine beliebige Kombination aus Partitionsspalten, die mithilfe eines der in der folgenden Tabelle gezeigten Formulare angegeben wird.

Partitionstyp	Syntax	Hinweise
Virtuelle Spalte	PartitionName `:` (`datetime` \| `string`)	Weitere Informationen zu virtuellen Spalten.
Zeichenfolgenspaltenwert	PartitionName ColumnName `:` `string` `=`
Zeichenfolgenspaltenwerthash ()	PartitionName ColumnName`=``:` `long` `hash(,` Number`)`	Der Hash ist modulo Number.
Abgeschnittene Datetime-Spalte (Wert)	PartitionName (`startofyear` \| `startofmonthstartofday` \| \| `startofweek`) `(` ColumnName `:` `datetime` `=` `)`	Weitere Informationen finden Sie in der Dokumentation zu "startofyear", "startofmonth", "startofweek" oder "startofday".See documentation on startofyear, startofmonth, startofweek, or startofday functions.
Abgeschnittener Datetime Column Value `=` `(` `bin` ColumnName `,` TimeSpan `)`	Weitere Informationen zur Bin-Funktion .

Hinweis

Jede Partition wird anhand des in der Partitionsliste aufgeführten PartitionName als separate Spalte dargestellt. PartitionName muss eine eindeutige Zeichenfolge ohne Groß-/Kleinschreibung sein, sowohl unter anderen Partitionsnamen als auch die Spaltennamen der gespiegelten Tabelle.

Zuordnung von Datentypen

Um Kompatibilität zu gewährleisten und Abfragen zu optimieren, stellen Sie sicher, dass Ihre Datentypen ordnungsgemäß den Parkettdatentypen zugeordnet sind.

Zuordnung von Eventhouse- zu Delta-Parquet-Datentypen

Datentypen von Event House werden Delta-Parkett-Datentypen zugeordnet, wobei die folgenden Regeln verwendet werden:

Eventhouse-Datentyp	Delta-Datentyp
`bool`	`boolean`
`datetime`	`timestamp OR date (for date-bound partition definitions)`
`dynamic`	`string`
`guid`	`string`
`int`	`integer`
`long`	`long`
`real`	`double`
`string`	`string`
`timespan`	`long`
`decimal`	`decimal(38,18)`

Weitere Informationen zu Eventhouse-Datentypen finden Sie unter Skalare Datentypen.

Beispielrichtlinie

{
  "Format": "parquet",
  "IsEnabled": true,
  "Partitions": null,
}

Freigeben über