Comando .drop extents
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer
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 "extensiones" o "extensiones" 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 administrador de tablas para ejecutar el comando .
Si no se especifica TableName, debe tener al menos permisos de administrador de base de datos para ejecutar el comando.
Sintaxis
Quitar extensiones con una consulta
.dropextents [whatif] <| Consulta
Obtenga más información sobre las convenciones de sintaxis.
Parámetros
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
whatif |
string |
Si se especifica, se notificarán las extensiones en lugar de quitarse. | |
| Consulta | 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 extensiones
.dropextents (ExtentIds) from TableName
Parámetros
| Nombre | Type | Obligatorio | 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 [older N (days | hours)] from (TableName | tablesall ) [trim by (extentsize | datasize) Size (MB | bytes | GB)] [limit LimitCount]
Parámetros
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
| N. | int |
✔️ | Quitar 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. Usa .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 pertenece la extensión |
| 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 tabla | Creado 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 se encontraba hace más de 10 días
.drop extents older 10 days from tables (Table1, Table2)
Quitar 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 id. de extensión no es aplicable para este comando.
.drop-pretend extents older 10 days from all tables
Quitar todas las extensiones de "TestTable"
.drop extents from TestTable
Nota:
Al quitar todas las extensiones no necesariamente se eliminan 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.