Команда зеркального отображения политики таблицы 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.