Compartilhar via


Comando .alter column policy encoding

Aplica-se a: ✅Microsoft FabricAzure Data Explorer

Altera a política de codificação. Para obter uma visão geral da política de codificação, consulte Política de codificação.

Observação

As alterações na política de codificação não afetam os dados que já foram ingeridos. Somente novas operações de ingestão serão executadas de acordo com a nova política.

Permissões

Você deve ter pelo menos permissões de Administrador de Tabela para executar este comando.

Sintaxe

.alter columnIdentificador de entidade policy encodingtype = [ EncodingPolicyType]

Observação

Se você omitir o type, o perfil de política de codificação existente será desmarcado, redefinido para o valor padrão.

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
Identificador de entidade string ✔️ O identificador da coluna.
EncodingPolicyType string O tipo de política de codificação a ser aplicada à coluna especificada. Consulte tipos de política de codificação para obter os valores possíveis.

Tipos de política de codificação

A tabela a seguir contém os valores possíveis para o parâmetro EncodingPolicyType .

Perfil de política de codificação Descrição
Identifier Adequado para colunas que têm dados que representam informações semelhantes a ID (por exemplo, guids). Essa política aplica o índice necessário para essa coluna para obter desempenho de consulta e reduzir o tamanho no armazenamento.
BigObject Adequado para colunas do tipo dinâmico ou string, que contém objetos grandes. Por exemplo, a saída da função de agregação hll. Essa política desabilita o índice dessa coluna e substitui MaxValueSize a propriedade na política de codificação para 2 MB.
BigObject32 Semelhante a BigObject em termos de cenários de destino. Substitui na política de MaxValueSize codificação para 32 MB.
Vector16 Este perfil foi projetado para armazenar vetores de números de ponto flutuante com precisão de 16 bits utilizando o Bfloat16 em vez dos 64 bits padrão. É altamente recomendado para armazenar incorporações de vetor ML, pois reduz os requisitos de armazenamento por um fator de 4 e acelera as funções de processamento vetorial, como series_dot_product() e series_cosine_similarity(), em ordens de magnitude.
Null Define a política de codificação padrão atual para a coluna e limpa o perfil de política de codificação anterior.

Exemplo

.alter column Logs.ActivityId policy encoding type='identifier'