Udostępnij za pośrednictwem

Polecenie dublowania zasad tabeli alter-merge

  • Artykuł

Dotyczy: ✅Microsoft Fabric

Zmienia zasady dublowania tabel. Zasady dublowania tworzą logiczną kopię tabel w bazie danych w formacie delta parquet i umożliwiają partycjonowanie plików w celu zwiększenia szybkości wykonywania zapytań. Każda partycja jest reprezentowana jako oddzielna kolumna przy użyciu nazwy partycji wymienionej na liście Partycje. Oznacza to, że w tabeli źródłowej znajduje się więcej kolumn niż w tabeli źródłowej.

Składnia

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

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
TableName string ✔️ Nazwa tabeli zgodna z regułami nazw jednostek.
Partycje string Rozdzielona przecinkami lista kolumn używanych do dzielenia danych na mniejsze partycje. Zobacz Formatowanie partycji.
propertyName, propertyValue string Rozdzielona przecinkami lista par właściwości klucz-wartość. Zobacz obsługiwane właściwości.

Formatowanie partycji

Lista partycji to dowolna kombinacja kolumn partycji określona przy użyciu jednej z formularzy przedstawionych w poniższej tabeli.

Typ partycji Składnia Uwagi
Kolumna wirtualna PartitionName: (datetime | string) Przeczytaj więcej na temat kolumn wirtualnych.
Wartość kolumny ciągu : string = Nazwa_kolumny_partycji
Skrót wartości kolumny ciągu() Numer nazwy kolumny PartitionName:long=hash(,) Skrót to liczba modulo.
Obcięta kolumna data/godzina (wartość) PartitionName:datetime= (startofyear | startofmonth | startofweek | startofday) (Nazwakolumny) Zobacz dokumentację funkcji startofyear, startofmonth, startofweek lub startofday .
Obcięta wartość =bin(kolumny datetime nazwa_kolumny timeSpan,) Przeczytaj więcej na temat funkcji bin .

Uwaga

Każda partycja jest reprezentowana jako oddzielna kolumna przy użyciu nazwy partycji wymienionej na liście Partycje. Nazwa_partycji musi być unikatowym ciągiem bez uwzględniania wielkości liter, zarówno między innymi nazwami partycji, jak i nazwami kolumn tabeli dublowanej.

Obsługiwane właściwości

Nazwisko Type opis
IsEnabled bool Wartość logiczna określająca, czy zasady dublowania są włączone. Wartość domyślna to true. Gdy zasady dublowania są wyłączone i ustawione na false, bazowe dane dublowania są usuwane nietrwale i przechowywane w bazie danych.
TargetLatencyInMinutes int Opóźnienie operacji zapisu w minitecie. Domyślnie operacja zapisu może potrwać do 3 godzin lub do momentu udostępnienia 256 MB danych. Opóźnienie można dostosować do wartości z zakresu od 5 minut do 3 godzin.
Backfill bool Po ustawieniu wartości truefunkcja dublowania rozpoczyna się od EffectiveDateTime. Jeśli nie określono EffectiveDateTime, wszystkie dane tabeli są dublowane. Wartość domyślna to false.
EffectiveDateTime datetime Istotne w przypadku ustawienia wypełniania wstecznego na wartość true. Jeśli zostanie podana, dublowanie rozpoczyna się od określonej wartości.

Uwaga

Po włączeniu zasad dublowania nie można zmienić nazwy tabel.

Przykłady

.alter table policy dublowanie

W poniższym przykładzie tabela o nazwie myTable jest dublowana. Dane są partycjonowane według nazwy, a następnie według daty.

.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))

Powiązana zawartość