Поделиться через


Команда зеркального отображения политики таблицы alter-merge

Область применения: ✅Microsoft Fabric

Изменяет политику зеркального отображения таблиц. Политика зеркального отображения создает логическую копию таблиц в базе данных в разностном формате parquet и позволяет секционировать файлы для повышения скорости запроса. Каждая секция представлена в виде отдельного столбца, используя имя секции , указанное в списке секций . Это означает, что в целевой таблице больше столбцов, чем в исходной таблице.

Синтаксис

(.alter | .alter-merge) table TableName policy mirroring [partition by (Секции)] dataformat = parquet
[with (IsEnabled=IsEnabledValue)]

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название) Type Обязательно Описание
TableName строка ✔️ Имя таблицы, которое соответствует правилам имен сущностей .
Секции строка Разделенный запятыми список столбцов, используемых для разделения данных на небольшие секции. См . раздел форматирования секций.

Форматирование секций

Список секций — это любое сочетание столбцов секций, указанных с помощью одной из форм, показанных в следующей таблице.

Тип секции Синтаксис Примечания.
Виртуальный столбец PartitionName : (datetime | string) Дополнительные сведения о виртуальных столбцах.
Строковое значение столбца Имя столбца PartitionName : string =
Хэш значений строкового столбца() Номер столбца PartitionName : long = hash(, ) Хэш — это число с модулем.
Усеченный столбец datetime (значение) Имя столбца PartitionName datetime : = () ( startofyear | startofmonth | startofweek | startofday ) См. документацию по функциям startofyear, startofmonth, startofweek или startofday.
Усеченное значение столбца = ( bin datetime ColumnName , TimeSpan ) Дополнительные сведения о функции bin .

Примечание.

Каждая секция представлена в виде отдельного столбца, используя имя секции , указанное в списке секций . PartitionName должен быть нечувствительной уникальной строкой регистра, как среди других имен секций, так и имен столбцов зеркальной таблицы.

Свойства

Имя. Тип Описание
IsEnabled bool Логическое значение, определяющее, включена ли политика зеркального отображения. По умолчанию — true. Если политика зеркального отображения отключена и задана false, базовые данные зеркального отображения обратимо удаляются и сохраняются в базе данных.

Примечание.

Если политика зеркального отображения включена, таблицы нельзя переименовать.

Примеры

Зеркальное отображение политики таблицы alter

В следующем примере таблица с именем myTable зеркальна. Данные сначала секционируются по имени, а затем по дате.

.alter table myTable policy mirroring
  partition by (Name: string=Name, Date: datetime= startofday(timestamp))
  dataformat=parquet
  with
  (IsEnabled=true)
  • Чтобы проверить операции зеркального отображения, см . команду операций зеркального отображения таблицы .show.
  • Инструкции по удалению операций зеркального отображения см. в статье .delete table policy mirroring command.