Compartir a través de


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,
}