Etiquetas de extensión de tabla .drop

Quita etiquetas de extensión específicas de todas o extensiones específicas de una tabla. El comando se ejecuta en el contexto de una base de datos específica.

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).

Hay dos maneras de especificar qué etiquetas se deben quitar de qué extensiones:

• Especifique explícitamente las etiquetas que se deben quitar de todas las extensiones de la tabla especificada.
• Proporcione una consulta cuyos resultados especifiquen los identificadores de extensión de la tabla y, para cada extensión, las etiquetas que se deben quitar.

Permisos

Debe tener al menos permisos de table Administración para todas las tablas de origen y destino implicadas.

Syntax

.drop [async] tableTableNameextenttags(Tag [, ...])with(extentCreatedOnFrom=FromDate,extentCreatedOnTo=ToDate)

.drop[async] tableConsulta TableNameextent=tagswithextentCreatedOnFrom(FromDate,=extentCreatedOnToToDate )<|

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

Parámetros

Nombre	Tipo	Requerido	Descripción
async	string		Si se especifica, la operación se ejecuta de forma asincrónica.
TableName	string	✔️	Nombre de la tabla para la que se van a quitar las etiquetas de extensión.
Tag	string	✔️	Nombres de las etiquetas de extensión que se van a quitar.
FromDate	datetime		Intervalo de fechas de inicio.
ToDate	datetime		Intervalo de fechas de finalización.
Consultar	string	✔️	Consulta Lenguaje de consulta Kusto (KQL) que devuelve las etiquetas de extensión que se van a quitar. Consulte Especificar extensiones con una consulta.

Nota

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

Restricciones

Todas las extensiones deben estar en la base de datos de contexto y deben pertenecer a la misma tabla.

Devoluciones

Se devuelve un identificador de operación (GUID).

Sugerencia

• El estado de la operación se puede supervisar con el GUID. Use el comando .show operations.
• Use el .show operation details comando para recuperar los resultados de una ejecución correcta.

Especificación de extensiones con una consulta

Las extensiones y las etiquetas que se van a quitar se especifican mediante una consulta de Kusto. Devuelve un conjunto de registros con una columna denominada "ExtentId" y una columna denominada "Tags".

Nota

Al usar la biblioteca cliente de .NET de Kusto, los métodos siguientes generarán el comando necesario:

• CslCommandGenerator.GenerateExtentTagsDropByRegexCommand(string tableName, string regex)
• CslCommandGenerator.GenerateExtentTagsDropBySubstringCommand(string tableName, string substring)

Salida devuelta

Parámetro de salida	Tipo	Descripción
OriginalExtentId	string	Identificador único (GUID) para la extensión original cuyas etiquetas se han modificado. La extensión se quita como parte de la operación.
ResultExtentId	string	Identificador único (GUID) para la extensión del resultado que tiene etiquetas modificadas. La extensión se crea y se agrega como parte de la operación. Tras un error: "Error".
ResultExtentTags	string	La colección de etiquetas con las que se etiqueta la extensión del resultado, si existe, o "null" en caso de que se produzca un error en la operación.
Detalles	string	Incluye los detalles del error si se produce un error en la operación.

Ejemplos

Quitar una etiqueta

Quite la drop-by:Partition000 etiqueta de cualquier extensión de la tabla que se etiquete con ella:

.drop extent tags from table MyOtherTable ('drop-by:Partition000')

Quitar varias etiquetas

Quite las etiquetas drop-by:20230312104500, a random tagy drop-by:20230312 de cualquier extensión de la tabla etiquetada con cualquiera de ellas:

.drop table [My Table] extent tags ('drop-by:20230312104500','a random tag','drop-by:20230312') with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12))

Quitar todas las drop-by etiquetas en un intervalo de tiempo de creación especificado

Quite todas las drop-by etiquetas de las extensiones de la tabla MyTable en un intervalo de tiempo de creación especificado:

.drop table MyTable extent tags with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| 
  .show table MyTable extents 
  | where isnotempty(Tags)
  | extend Tags = split(Tags, '\r\n') 
  | mv-expand Tags to typeof(string)
  | where Tags startswith 'drop-by'

Quitar todas las etiquetas que coincidan con expresiones regulares específicas

Quite todas las etiquetas que coincidan con regex drop-by:StreamCreationTime_20160915(\d{6}) de extensiones de la tabla MyTable:

.drop table MyTable extent tags with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| 
  .show table MyTable extents 
  | where isnotempty(Tags)
  | extend Tags = split(Tags, '\r\n')
  | mv-expand Tags to typeof(string)
  | where Tags matches regex @"drop-by:StreamCreationTime_20160915(\d{6})"

Salida de ejemplo

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