Comando de espelhamento de política de tabela .alter-merge
Aplica-se a: ✅Microsoft Fabric
Altera a política de espelhamento das tabelas. A política de espelhamento cria uma cópia lógica das tabelas em seu banco de dados no formato delta parquet e permite que você particione seus arquivos para melhorar a velocidade da consulta. Cada partição é representada como uma coluna separada usando o PartitionName listado na lista Partições. Isso significa que há mais colunas no destino do que na tabela de origem.
Sintaxe
(.alter.alter-merge | ) table TableName policy mirroring [ bypartition (Partições)]dataformat = parquet
with [ (=IsEnabledIsEnabledValue)]
Saiba mais sobre as convenções de sintaxe.
Parâmetros
| Nome | Digitar | Obrigatória | Descrição |
|---|---|---|---|
| TableName | string | ✔️ | Um nome de tabela que adere às regras de nomes de entidade. |
| Partições | string | Uma lista separada por vírgulas de colunas usadas para dividir os dados em partições menores. Consulte Formatação de partições. |
Formatação de partições
A lista de partições é qualquer combinação de colunas de partição, especificada usando um dos formulários mostrados na tabela a seguir.
| Tipo de partição | Sintaxe | Observações |
|---|---|---|
| Coluna virtual | PartitionName : (datetime | string) |
Leia mais em Colunas virtuais. |
| Valor da coluna String | PartitionName = : string ColumnName |
|
| Valor da coluna de string hash() | PartitionName =long hash(: ColumnName Número, ) |
O hash é o número do módulo. |
| Coluna de data e hora truncada (valor) | PartitionName datetime = : (startofmonthstartofweek | | startofyearstartofday | ) ( ColumnName ) |
Consulte a documentação sobre as funções startofyear, startofmonth, startofweek ou startofday . |
Valor = ( bin da coluna de data e hora truncado ColumnName , TimeSpan ) |
Leia mais sobre a função bin . |
Observação
Cada partição é representada como uma coluna separada usando o PartitionName listado na lista Partições. PartitionName deve ser uma cadeia de caracteres exclusiva que não diferencia maiúsculas de minúsculas, tanto entre outros nomes de partição quanto entre os nomes de coluna da tabela espelhada.
Propriedades
| Nome | Tipo | Descrição |
|---|---|---|
IsEnabled |
bool |
Um valor booliano que determina se a política de espelhamento está habilitada. O padrão é true. Quando a política de espelhamento é desabilitada e definida como false, os dados de espelhamento subjacentes são excluídos temporariamente e retidos no banco de dados. |
Observação
Quando a política de espelhamento está habilitada, as tabelas não podem ser renomeadas.
Exemplos
Espelhamento de política de tabela .alter
No exemplo a seguir, uma tabela chamada myTable é espelhada. Os dados são particionados primeiro por nome e depois por data.
.alter table myTable policy mirroring
partition by (Name: string=Name, Date: datetime= startofday(timestamp))
dataformat=parquet
with
(IsEnabled=true)