.drop table extent tags

  • Artigo

Remove etiquetas de extensão específicas de todas ou de extensões específicas de uma tabela. O comando é executado no contexto de uma base de dados específica.

Nota

As partições horizontais de dados são denominadas extensões e todos os comandos utilizam "extensões" ou "extensões" como sinónimo. Para obter mais informações sobre extensões, veja Descrição Geral de Extensões (Fragmentos de Dados).

Existem duas formas de especificar que etiquetas devem ser removidas de que extensões:

  • Especifique explicitamente as etiquetas que devem ser removidas de todas as extensões na tabela especificada.
  • Forneça uma consulta cujos resultados especifiquem os IDs de extensão na tabela e, para cada extensão, as etiquetas que devem ser removidas.

Permissões

Tem de ter, pelo menos, permissões de tabela Administração para todas as tabelas de origem e destino envolvidas.

Syntax

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

.drop[async] tableConsulta TableNameextenttags=withextentCreatedOnFrom(FromDate,extentCreatedOnTo=ToDate)<|

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
async string Se especificado, a operação é executada de forma assíncrona.
TableName string ✔️ O nome da tabela para a qual pretende remover as etiquetas de extensão.
Tag string ✔️ Os nomes das etiquetas de extensão a largar.
DataDoDados datetime O intervalo de datas de início.
ToDate datetime O intervalo de datas de fim.
Query string ✔️ Uma consulta Linguagem de Pesquisa Kusto (KQL) que devolve as etiquetas de extensão a serem removidas. Veja Especificar extensões com uma consulta.

Nota

Para um melhor desempenho, defina extentCreatedOnFrom e extentCreatedOnTo parâmetros para o intervalo mais pequeno possível.

Restrições

Todas as extensões têm de estar na base de dados de contexto e têm de pertencer à mesma tabela.

Devoluções

É devolvido um ID da Operação (GUID).

Dica

Especificar extensões com uma consulta

As extensões e as etiquetas a remover são especificadas com uma consulta Kusto. Devolve um conjunto de registos com uma coluna denominada "ExtentId" e uma coluna chamada "Etiquetas".

Nota

Ao utilizar a biblioteca de cliente .NET do Kusto, os seguintes métodos irão gerar o comando necessário:

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

Devolver saída

Parâmetro de saída Tipo Description
OriginalExtentId string Um identificador exclusivo (GUID) para a extensão original cujas etiquetas foram modificadas. A extensão é removida como parte da operação.
ResultExtentId string Um identificador exclusivo (GUID) para a extensão do resultado que modificou as etiquetas. A extensão é criada e adicionada como parte da operação. Após a falha – "Falhou".
ResultExtentTags string A coleção de etiquetas com as quais a extensão do resultado é etiquetada, se existir alguma, ou "nula", caso a operação falhe.
Detalhes string Inclui os detalhes da falha se a operação falhar.

Exemplos

Remover uma etiqueta

Remova a drop-by:Partition000 etiqueta de qualquer extensão na tabela que está etiquetada com a mesma:

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

Remover várias etiquetas

Largue as etiquetas drop-by:20230312104500, a random tage drop-by:20230312 de qualquer extensão na tabela que esteja etiquetada com qualquer uma delas:

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

Remover todas as drop-by etiquetas num intervalo de tempo de criação especificado

Remova todas as drop-by etiquetas de extensões na tabela MyTable num intervalo de tempo de criação 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'

Remover todas as etiquetas correspondentes ao regex específico

Remova todas as etiquetas correspondentes ao regex drop-by:StreamCreationTime_20160915(\d{6}) de extensões na tabela 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})"

Saída de exemplo

OriginalExtentId ResultExtentId ResultExtentTags Detalhes
e133f050-a1e2-4dad-8552-1f5cf47cab69 0d96ab2d-9dd2-4d2c-a45e-b24c65aa6687 Partição001
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