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) table TableName policy mirroring [partition by (Particiones)] dataformat = parquet
[with (IsEnabled=IsEnabledValue)]

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.

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 : = (startofyearstartofweek | | | startofdaystartofmonth) ( ColumnName ) Consulte la documentación sobre las funciones startofyear, startofmonth, startofweek o startofday .
Valor de columna = ( bin datetime truncado ColumnName , 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

Nombre Escribir 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.

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