Compartir a través de


Comando .alter column policy encoding

Se aplica a: ✅Microsoft FabricAzure Data Explorer

Modifica la directiva de codificación. Para obtener información general sobre la directiva de codificación, consulte Directiva de codificación.

Nota:

Los cambios en la directiva de codificación no afectan a los datos que ya se han ingerido. Solo se realizarán nuevas operaciones de ingesta según la nueva directiva.

Permisos

Debe tener al menos permisos de administrador de tablas para ejecutar este comando.

Sintaxis

.alter columnEntityIdentifier policy encoding [type = EncodingPolicyType]

Nota:

Si omite type, el perfil de directiva de codificación existente se borra al valor predeterminado.

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Type Obligatorio Descripción
EntityIdentifier string ✔️ Identificador de la columna.
EncodingPolicyType string Tipo de la directiva de codificación que se va a aplicar a la columna especificada. Consulte codificación de tipos de directiva para conocer los valores posibles.

Tipos de directiva de codificación

La tabla siguiente contiene los valores posibles para el parámetro EncodingPolicyType .

Perfil de directiva de codificación Descripción
Identifier Adecuado para las columnas que tienen datos que representan información similar a identificador (por ejemplo, guid). Esta directiva aplica el índice necesario para esta columna para obtener el rendimiento de las consultas y reducir el tamaño en el almacenamiento.
BigObject Adecuado para columnas de tipo dinámico o de cadena, que contiene objetos grandes. Por ejemplo, la salida de la función de agregado hll. Esta directiva deshabilita el índice de esta columna e invalida MaxValueSize la propiedad en la directiva de codificación en 2 MB.
BigObject32 Similar a BigObject en términos de escenarios de destino. Invalida MaxValueSize la propiedad de la directiva de codificación en 32 MB.
Vector16 Este perfil está diseñado para almacenar vectores de números de punto flotante en precisión de 16 bits utilizando Bfloat16 en lugar de los 64 bits predeterminados. Se recomienda encarecidamente almacenar incrustaciones de vectores de APRENDIZAJE automático, ya que reduce los requisitos de almacenamiento en un factor de 4 y acelera las funciones de procesamiento de vectores, como series_dot_product() y series_cosine_similarity() por orden de magnitud.
Null Establece la directiva de codificación predeterminada actual en la columna y borra el perfil de directiva de codificación anterior.

Ejemplo

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