Partilhar via


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)
  • Para verificar as operações de espelhamento, consulte o comando .show table mirroring operations.
  • Para excluir operações de espelhamento, consulte o comando de espelhamento de política de tabela .delete.