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

Изменяет политику зеркального отображения таблиц. Политика зеркального отображения создает логическую копию таблиц в базе данных в разностном формате 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.
Усеченный столбец datetime (значение)	Имя столбца PartitionName datetime bin ( = : , 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.

Эта возможность не поддерживается.