Compartir a través de

Registros de tabla .delete: comando de eliminación temporal

  • Artículo

Se aplica a: ✅Azure Data Explorer

Para eliminar registros individuales sin un sistema garantiza que también se eliminen los artefactos de almacenamiento que contienen estos registros, use el siguiente comando. Este comando marca los registros como eliminados, pero no elimina necesariamente los datos de los artefactos de almacenamiento. Para más información, consulte Eliminación temporal.

Para eliminar registros individuales con una garantía del sistema de que también se eliminan los artefactos de almacenamiento que contienen estos registros, consulte Purga de datos.

Sintaxis

.delete[async] table TableName records [with ( propertyName = propertyValue [, ...]] <| )Predicado

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

Parámetros

Nombre Type Obligatorio Descripción
async string Si se especifica, indica que el comando se ejecuta en modo asincrónico.
TableName string ✔️ Nombre de la tabla de la que se van a eliminar registros.
propertyName, propertyValue string Lista separada por comas de pares de propiedades clave-valor. Consulte las propiedades admitidas.
Predicado string ✔️ Predicado que devuelve registros que se van a eliminar, que se especifican como una consulta. Ver nota.

Nota:

Las restricciones siguientes se aplican al predicado:

  • El predicado debe tener al menos un where operador.
  • El predicado solo puede usar los operadores siguientes: extend, where y project.
  • El predicado no puede usar externaldata.

Propiedades admitidas

Nombre Escribir Descripción
whatif bool Si truees , devuelve el número de registros que se eliminarán en cada partición, sin eliminar realmente ningún registro. El valor predeterminado es false.

Devoluciones

La salida del comando contiene información sobre qué extensiones se reemplazaron.

Ejemplo: eliminar registros de un usuario determinado

Para eliminar todos los registros que contienen datos de un usuario determinado:

.delete table MyTable records <| MyTable | where UserId == 'X'

Ejemplo: comprobación del número de registros que se eliminarían de una tabla

Para determinar el número de registros que eliminaría la operación sin eliminarlos realmente, compruebe el valor de la columna RecordsMatchPredicate al ejecutar el comando en whatif modo:

.delete table MyTable records with (whatif=true) <| MyTable | where UserId == 'X'

.delete materialized-view records : comando de eliminación temporal

Cuando la eliminación temporal se ejecuta en vistas materializadas, se aplican los mismos conceptos y limitaciones.

Sintaxis: vistas materializadas

.delete[async] materialized-view MaterializedViewName [with ( propertyName records = propertyValue [, ...]] <| )Predicado

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

Parámetros: vistas materializadas

Nombre Type Obligatorio Descripción
async string Si se especifica, indica que el comando se ejecuta en modo asincrónico.
MaterializedViewName string ✔️ Nombre de la vista materializada desde la que se van a eliminar registros.
propertyName, propertyValue string Lista separada por comas de pares de propiedades clave-valor. Consulte las propiedades admitidas.
Predicado string ✔️ Predicado que devuelve registros que se van a eliminar. Se especifica como una consulta.

Nota:

También se aplican las mismas restricciones en el predicado mencionado para la tabla. La eliminación temporal podría producir un error en caso de conflictos con el proceso de materialización que se ejecuta en segundo plano. Volver a intentar la operación puede ayudar en este caso. Para evitar conflictos, puede deshabilitar la vista materializada antes de ejecutar la eliminación temporal y volver a habilitarla cuando se complete la operación. No se permite el uso de la función materialized_view() en Predicate.

Propiedades admitidas: vistas materializadas

Nombre Escribir Descripción
whatif bool Si truees , devuelve el número de registros que se eliminarán en cada partición, sin eliminar realmente ningún registro. El valor predeterminado es false.

Ejemplo: vistas materializadas

Para eliminar todos los registros de vista materializados que contienen datos de un usuario determinado:

.delete materialized-view MyMaterializedView records <| MyMaterializedView | where UserId == 'X'

Ejemplo: comprobación del número de registros que se eliminarían de una vista materializada

Para determinar el número de registros que eliminaría la operación sin eliminarlos realmente, compruebe el valor de la columna RecordsMatchPredicate mientras ejecuta el comando en whatif modo:

.delete materialized-view MyMaterializedView records with (whatif=true) <| MyMaterializedView | where UserId == 'X'

Contenido relacionado