Compartir a través de

Comando .alter-merge table policy mirroring

  • Artículo

Se aplica a: ✅Microsoft Fabric

Cambia la directiva de creación de reflejo de las tablas. La directiva de creación de reflejo crea una copia lógica de tablas en la base de datos en formato parquet delta y le permite particionar los archivos para mejorar la velocidad de las consultas. Cada partición se representa como una columna independiente mediante PartitionName que se muestra en la lista Particiones. Esto significa que hay más columnas en el destino que en la tabla de origen.

Sintaxis

(.alter | .alter-merge) tabletableNamepolicy mirroring [partitionby (Partitions)] dataformat = parquet [with(propertyName=propertyValue [, ...])]

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

Parámetros

Nombre Type Obligatorio Descripción
TableName string ✔️ Nombre de tabla que cumple las reglas de nombres de entidad.
Particiones string Lista separada por comas de columnas usadas para dividir los datos en particiones más pequeñas. Consulte Formato de particiones.
propertyName, propertyValue string Lista separada por comas de pares de propiedades clave-valor. Consulte propiedades admitidas.

Formato de particiones

La lista de particiones es cualquier combinación de columnas de partición, especificada mediante uno de los formularios que se muestran en la tabla siguiente.

Tipo de partición Sintaxis Notas
Columna virtual PartitionName: (datetime | string) Obtenga más información sobre las columnas virtuales.
Valor de columna de cadena PartitionName:string=ColumnName
Hash de valor de columna de cadena() PartitionName:long=hash( ColumnName Number,) El hash es modulo Number.
Columna datetime truncada (valor) PartitionName:datetime= (startofyear | startofmonth | startofweek | startofday) (ColumnName) Consulte la documentación sobre las funciones startofyear, startofmonth, startofweek o startofday .
Valor de columna =bin(,TimeSpan) Obtenga más información sobre la función bin .

Nota:

Cada partición se representa como una columna independiente mediante PartitionName que se muestra en la lista Particiones. PartitionName debe ser una cadena única que no distingue mayúsculas de minúsculas, tanto entre otros nombres de partición como los nombres de columna de la tabla reflejada.

Propiedades admitidas

Nombre Type Descripción
IsEnabled bool Valor booleano que determina si la directiva de creación de reflejo está habilitada. El valor predeterminado es true. Cuando la directiva de creación de reflejo está deshabilitada y se establece falseen , los datos de creación de reflejo subyacentes se eliminan temporalmente y se conservan en la base de datos.
TargetLatencyInMinutes int Retraso de la operación de escritura en minites. De forma predeterminada, la operación de escritura puede tardar hasta 3 horas o hasta que haya 256 MB de datos disponibles. Puede ajustar el retraso a un valor entre 5 minutos y 3 horas.

Nota:

Cuando la directiva de creación de reflejo está habilitada, no se puede cambiar el nombre de las tablas.

Ejemplos

Creación de reflejo de directivas .alter table

En el ejemplo siguiente, se refleja una tabla denominada myTable . Los datos se particionan primero por nombre y, a continuación, por fecha.

.alter table myTable policy mirroring
  partition by (Name: string=Name, Date: datetime= startofday(timestamp))
  dataformat=parquet
  with
  (IsEnabled=true)

Contenido relacionado