Comando .drop extents

Quita extensiones de una base de datos o tabla especificadas.

Este comando tiene varias variantes: en una, las extensiones que se van a quitar se especifican mediante una consulta de Kusto. En las otras variantes, las extensiones se especifican mediante un mini-lenguaje que se describe a continuación.

Nota

Las particiones de datos se denominan extensiones y todos los comandos usan "extent" o "extents" como sinónimo. Para obtener más información sobre las extensiones, consulte Información general sobre extensiones (particiones de datos).

Precaución

Si quita una extensión, se eliminarán todas las filas de esa extensión. Para eliminar registros individuales, use eliminación temporal.

Permisos

Si se especifica TableName, debe tener al menos permisos de table Administración para ejecutar el comando.

Si no se especifica TableName, debe tener al menos permisos de base de datos Administración para ejecutar el comando.

Syntax

Quitar extensiones con una consulta

.dropextents [whatif] <|Consulta

Más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Tipo	Requerido	Descripción
whatif	string		Si se especifica, se notificarán las extensiones en lugar de quitarse.
Consultar	string	✔️	Los resultados de esta consulta de Lenguaje de consulta Kusto (KQL) especifican las tablas de origen y los identificadores de extensión que se van a quitar. Debe devolver un conjunto de registros con columnas denominadas "ExtentId" y "TableName".

Quitar una extensión específica o varias

.dropextents(ExtentIds)fromTablename

Parámetros

Nombre	Tipo	Requerido	Descripción
ExtentIds	guid	✔️	Uno o varios identificadores únicos separados por comas de las extensiones que se van a quitar.
TableName	string		Nombre de la tabla donde se encuentra la extensión que se va a quitar.

Quitar extensiones por propiedades especificadas

.dropextents[olderN (days | hours)] from (TableName | tablesall) [trimby (extentsizedatasize | ) Size (MB | GBbytes | )] [limitLimitCount]

Parámetros

Nombre	Tipo	Requerido	Descripción
N.	int	✔️	Quite las extensiones anteriores a N días/horas.
TableName	string		Nombre de la tabla donde se encuentra la extensión que se va a quitar.
Tamaño	int	✔️	Recorte los datos de la base de datos hasta que la suma de extensiones coincida con el tamaño necesario (MaxSize).
LimitCount	int	✔️	Se aplica a las primeras extensiones limitCount .

El comando admite el modo de emulación que genera una salida como si el comando se hubiera ejecutado, pero sin ejecutarlo realmente. Use .drop-pretend en lugar de .drop.

Devoluciones

El comando devuelve una tabla con la siguiente información.

Parámetro de salida	Tipo	Descripción
ExtentId	string	ExtentId que se quitó debido al comando
TableName	string	Nombre de tabla, donde la extensión pertenecía
CreatedOn	dateTime	Marca de tiempo que contiene información sobre cuándo se creó inicialmente la extensión

Por ejemplo, el valor devuelto de un comando podría ser similar a la tabla siguiente.

Id. de extensión	Nombre de la tabla	Creada el
43c6e03f-1713-4ca7-a52a-5db8a4e8b87d	TestTable	2015-01-12 12:48:49.4298178

Ejemplos

Quitar una extensión específica

Use un identificador de extensión para quitar una extensión específica.

.drop extent 609ad1e2-5b1c-4b79-90c0-1dec262e9f46 from Table1

Quitar varias extensiones

Use una lista de identificadores de extensión para quitar varias extensiones.

.drop extents (609ad1e2-5b1c-4b79-90c0-1dec262e9f46, 310a60c6-8529-4cdf-a309-fe6aa7857e1d) from Table1

Quitar todas las extensiones por hora creadas

Quitar todas las extensiones creadas hace más de 10 días, de todas las tablas de la base de datos MyDatabase

.drop extents <| .show database MyDatabase extents | where CreatedOn < now() - time(10d)

Quitar algunas extensiones por tiempo creadas

Quitar todas las extensiones de las tablas Table1 y Table2 cuyo tiempo de creación era hace más de 10 días

.drop extents older 10 days from tables (Table1, Table2)

Eliminación de una extensión mediante extent_id()

Quite una extensión de una tabla mediante la función integrada extent_id() .

.drop extents  <|
    StormEvents
    | where EventId == '66144'
    | summarize by ExtentId = extent_id(), TableName = "StormEvents"

Modo de emulación: mostrar qué extensiones se quitarían mediante el comando

Nota

El parámetro de identificador de extensión no es aplicable a este comando.

.drop-pretend extents older 10 days from all tables

Quitar todas las extensiones de "TestTable"

.drop extents from TestTable

Nota

La eliminación de todas las extensiones no elimina necesariamente todos los datos de la tabla, si la ingesta de streaming está habilitada. Para borrar todos los datos de una tabla, use .clear table data TestTable.