Directiva de creación de reflejo

Se aplica a: ✅Microsoft Fabric

Los comandos de directiva de creación de reflejo permiten ver, cambiar, particionar y eliminar la directiva de creación de reflejo de la tabla. También proporcionan una manera de comprobar la latencia de creación de reflejo revisando el estado de creación de reflejo de las operaciones.

Comandos de administración

• Use el comando .show table policy mirroring para mostrar la directiva de creación de reflejo actual de la tabla.
• Use el comando .alter-merge table policy mirroring para cambiar la directiva de creación de reflejo actual.
• Use el comando .delete table policy mirroring para eliminar temporalmente la directiva de creación de reflejo actual.
• Use el comando .show table mirroring operations para comprobar el estado de creación de reflejo de operaciones.
• Use el comando .show table mirroring artifacts exported artifacts para comprobar el estado de los artefactos exportados.
• Use errores de operaciones de creación de reflejo de tablas .show para comprobar el estado de error de creación de reflejo de operaciones.

El objeto de la directiva

La directiva de creación de reflejo incluye las siguientes propiedades:

Propiedad	Descripción	Valores	Valor predeterminado
Formato	El formato de los archivos reflejados.	El valor válido es parquet.	parquet
ConnectionStrings	Matriz de cadena de conexión que ayudan a configurar y establecer conexiones. Este valor se rellena automáticamente.
IsEnabled	Determina si la directiva de creación de reflejo está habilitada. Cuando la directiva de creación de reflejo está deshabilitada y se establece falseen , los datos de creación de reflejo subyacentes se conservan en la base de datos.	true, , false. null	null
Particiones	Lista separada por comas de columnas usadas para dividir los datos en particiones más pequeñas.	Consulte Formato de particiones.

Advertencia

Al eliminar o quitar la directiva de creación de reflejo de la tabla, se eliminará permanentemente la tabla delta en OneLake.

Nota:

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

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.

Asignación de tipos de datos

Para garantizar la compatibilidad y optimizar las consultas, asegúrese de que los tipos de datos están asignados correctamente a los tipos de datos parquet.

Asignación de tipos de datos delta parquet a Event house

Los tipos de datos de la casa de eventos se asignan a los tipos de datos delta Parquet mediante las siguientes reglas:

Tipo de datos de Event house	Tipo de datos 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 obtener más información sobre los tipos de datos de Event house, consulta Tipos de datos escalares.

Ejemplo de directiva

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