Comando .move extents

Se aplica a: ✅Azure Data Explorer

Este comando se ejecuta en el contexto de una base de datos específica. Mueve las extensiones especificadas de la tabla de origen a la tabla de destino.

Nota:

• Para obtener más información sobre las extensiones, consulte Información general sobre extensiones (particiones de datos).
• Un .move comando se completa o produce un error para todas las extensiones de origen. No hay resultados parciales.

Permisos

Debe tener al menos permisos de administrador de tablas para las tablas de origen y destino.

Restricciones

• Las tablas de origen y destino deben estar en la base de datos de contexto.
• Se espera que todas las columnas de la tabla de origen existan en la tabla de destino con el mismo nombre y tipo de datos.
• Si la tabla de destino es una tabla de origen de una vista materializada, es posible que se produzca un error en el comando, ya que la vista materializada no procesará los registros en las extensiones movidas. Consulte más detalles en la página de limitaciones de vistas materializadas. Puede solucionar este error estableciendo un nuevo tiempo de ingesta durante el comando move. Consulte setNewIngestionTime en las propiedades admitidas.

Sintaxis

Mover todas las extensiones:

.move[async] extents from table all sourceTableName table to DestinationTableName [ with(PropertyName = PropertyValue [, ...]])

Mover extensiones especificadas por el identificador:

.move[async] extents from table SourceTableName table to DestinationTableName [ with(PropertyName = PropertyValue [, ...]] ( )GUID [, ...])

Mover extensiones especificadas por los resultados de la consulta:

.move[async] extents table to DestinationTableName [ with(PropertyName = PropertyValue [,...]] <| )Consulta

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

Parámetros

Nombre	Type	Obligatorio	Descripción
async	string		Si se especifica, el comando se ejecuta de forma asincrónica.
SourceTableName	string	✔️	Nombre de la tabla que contiene las extensiones que se van a mover.
DestinationTableName	string	✔️	Nombre de la tabla a la que se van a mover las extensiones.
PropertyName, PropertyValue	string		Una o varias propiedades admitidas.
Consulta	string	✔️	Los resultados de esta consulta de Lenguaje de consulta Kusto (KQL) especifican la tabla de origen y los identificadores de extensión que se van a mover de ella. Debe devolver un conjunto de registros con columnas denominadas "ExtentId" y "TableName".

Propiedades admitidas

Nombre de propiedad	Type	Obligatorio	Descripción
setNewIngestionTime	bool		Si se establece trueen , se asigna un nuevo tiempo de ingesta a todos los registros en extensiones que se mueven. Esto resulta útil cuando las cargas de trabajo deben procesar los registros que dependen de cursores de base de datos, como vistas materializadas y exportación continua de datos.
extentCreatedOnFrom	datetime	✔️	Aplicar en extensiones creadas después de este momento dado.
extentCreatedOnTo	datetime	✔️	Aplicar en extensiones creadas antes de este momento dado.

Nota:

Para mejorar el rendimiento, establezca extentCreatedOnFrom los parámetros y extentCreatedOnTo en el intervalo más pequeño posible.

Devoluciones

Cuando el comando se ejecuta de forma sincrónica, se devuelve una tabla con el esquema siguiente.

Parámetro de salida	Tipo	Descripción
OriginalExtentId	string	Identificador único (GUID) para la extensión original de la tabla de origen, que se ha movido a la tabla de destino.
ResultExtentId	string	Identificador único (GUID) para la extensión del resultado que se ha movido de la tabla de origen a la tabla de destino. Tras un error: "Error".
Detalles	string	Incluye los detalles del error, en caso de que se produzca un error en la operación.

Cuando el comando se ejecuta de forma asincrónica, se devuelve un identificador de operación (GUID). Supervise el estado de la operación con el comando .show operations y recupere los resultados de una ejecución correcta con el comando .show operation details .

Ejemplos

Mover todas las extensiones

Mueva todas las extensiones de la tabla MyTable a la tabla MyOtherTable:

.move extents all from table MyTable to table MyOtherTable

Mover dos extensiones específicas en un intervalo de tiempo de creación especificado

Mueva dos extensiones específicas (por sus identificadores de extensión) en un intervalo de tiempo de creación especificado de la tabla MyTable a la tabla MyOtherTable:

.move extents from table MyTable to table MyOtherTable with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) (AE6CD250-BE62-4978-90F2-5CB7A10D16D7,399F9254-4751-49E3-8192-C1CA78020706)

Mover todas las extensiones en un intervalo de tiempo de creación especificado de tablas específicas

Mueva todas las extensiones de un intervalo de tiempo de creación especificado de tablas específicas (MyTable1, MyTable2) a la tabla MyOtherTable:

.move extents to table MyOtherTable with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| .show tables (MyTable1,MyTable2) extents

Mover todas las extensiones con el nuevo tiempo de ingesta establecido

.move extents all from table MyTable to table MyOtherTable with (setNewIngestionTime=true)

Salida de ejemplo

OriginalExtentId	ResultExtentId	Detalles
e133f050-a1e2-4dad-8552-1f5cf47cab69	0d96ab2d-9dd2-4d2c-a45e-b24c65aa6687
cdbeb35b-87ea-499f-b545-defbae091b57	a90a303c-8a14-4207-8f35-d8ea94ca45be
4fcb4598-9a31-4614-903c-0c67c286da8c	97aafea1-59ff-4312-b06b-08f42187872f
2dfdef64-62a3-4950-a130-96b5b1083b5a	0fb7f3da-5e28-4f09-a000-e62eb41592df