Política de espelhamento

Aplica-se a: ✅Microsoft Fabric

Os comandos de política de espelhamento permitem que você visualize, altere, particione e exclua sua política de espelhamento de tabela. Eles também fornecem uma maneira de verificar a latência de espelhamento examinando o status de espelhamento das operações.

Comandos de gerenciamento

• Use o comando .show table policy mirroring para mostrar a política de espelhamento atual da tabela.
• Use o comando .alter-merge table policy mirroring para alterar a política de espelhamento atual.
• Use o comando .delete table policy mirroring para excluir temporariamente a política de espelhamento atual.
• Use o comando .show table mirroring operations para verificar o status do espelhamento de operações.
• Use o comando .show table mirroring operations exported artifacts para verificar o status dos artefatos exportados das operações.
• Use .show table mirroring operations failures para verificar o status de falha de espelhamento de operações.

O objeto de política

A política de espelhamento inclui as seguintes propriedades:

Propriedade	Descrição	Valores	Padrão
Formato	O formato de seus arquivos espelhados.	O valor válido é parquet.	parquet
ConnectionStrings	Uma matriz de cadeias de conexão que ajudam a configurar e estabelecer conexões. Esse valor é preenchido automaticamente.
IsEnabled	Determina se a política de espelhamento está habilitada. Quando a política de espelhamento é desabilitada e definida como false, os dados de espelhamento subjacentes são retidos no banco de dados.	true, false, null.	null
Partições	Uma lista separada por vírgulas de colunas usadas para dividir os dados em partições menores.	Consulte Formatação de partições.

Aviso

Excluir ou descartar a política de espelhamento de tabela excluirá permanentemente a tabela delta no OneLake.

Observação

Quando a política de espelhamento está habilitada, as tabelas não podem ser renomeadas.

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.

Mapeamento de tipos de dados

Para garantir a compatibilidade e otimizar consultas, verifique se os tipos de dados estão mapeados corretamente para os tipos de dados do parquet.

Mapeamento de tipos de dados do Event house o Delta Parquet

Os tipos de dados da casa de eventos são mapeados para os tipos de dados Delta Parquet usando as seguintes regras:

Tipo de dados do Event house	Tipo de dados Delta
bool	boolean
datetime	timestamp OR date (for date-bound partition definitions)
dynamic	string
guid	string
int	integer
long	long
real	double
string	string
timespan	long
decimal	decimal(38,18)

Para obter mais informações sobre tipos de dados do Event house, consulte Tipos de dados escalares.

Política de exemplo

{
  "Format": "parquet",
  "IsEnabled": true,
  "Partitions": null,
}