Comando de espelhamento de política de tabela .alter-merge

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 usada 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	Nome da partição : (datetime | string)	Leia mais em Colunas virtuais.
Valor da coluna de cadeia de caracteres	Nome da Partição = : string ColumnName
Valor da coluna de cadeia de caracteres hash()	PartitionName hash(long = : Número ColumnName, )	O hash é o número do módulo.
Coluna datetime truncada (valor)	PartitionName datetime = : (startofmonthstartofweek | | startofyearstartofday | ) ( ColumnName )	Consulte a documentação sobre as funções de início de ano, início de mês, início de semana ou início de dia .
Coluna datetime truncada (valor)	PartitionName bin = datetime ( : ColumnName , TimeSpan )	Saiba mais sobre a função de lixeira .

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 sem distinção entre maiúsculas e minúsculas, tanto entre outros nomes de partição quanto os nomes de coluna da tabela espelhada.

Propriedades

Nome	Tipo	Descrição
IsEnabled	bool	Um valor booleano que determina se a diretiva 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 e retidos no banco de dados.

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)

Conteúdo relacionado

• 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.

Não há suporte para esse recurso.