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.

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)

Powiązana zawartość