.drop table extent tags

  • Artigo

Remove marcas de extensão específicas de todas ou extensões específicas de uma tabela. O comando é executado no contexto de um banco de dados específico.

Observação

Os fragmentos de dados são chamados de extensões e todos os comandos usam "extensão" ou "extensões" como sinônimo. Para obter mais informações sobre extensões, consulte Visão geral de Extensões (Fragmentos de Dados).

Há duas maneiras de especificar quais marcas devem ser removidas de quais extensões:

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

Permissões

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

Syntax

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

.drop[async] tableTableNameextentextentCreatedOnFromtags(=withFromDate,=extentCreatedOnToToDate)<|Query

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
async string Se especificada, a operação é executada de forma assíncrona.
TableName string ✔️ O nome da tabela para a qual remover as marcas de extensão.
Tag string ✔️ Os nomes das marcas de extensão a serem soltas.
FromDate datetime O intervalo de datas de início.
Todate datetime O intervalo de datas de término.
Consulta string ✔️ Uma consulta de Linguagem de Consulta Kusto (KQL) que retorna as marcas de extensão a serem descartadas. Consulte Especificar extensões com uma consulta.

Observação

Para obter melhor desempenho, defina extentCreatedOnFrom e extentCreatedOnTo parâmetros para o menor intervalo possível.

Restrições

Todas as extensões devem estar no banco de dados de contexto e devem pertencer à mesma tabela.

Retornos

Uma GUID (ID da Operação) é retornada.

Dica

Especificar extensões com uma consulta

As extensões e as marcas a serem soltas são especificadas usando uma consulta Kusto. Ele retorna um conjunto de registros com uma coluna chamada "ExtentId" e uma coluna chamada "Tags".

Observação

Ao usar a biblioteca de clientes Kusto .NET, os seguintes métodos gerarão o comando necessário:

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

Saída de retorno

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

Exemplos

Remover uma marca

Remova a drop-by:Partition000 marca de qualquer extensão na tabela marcada com ela:

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

Remover várias marcas

Remova as marcas drop-by:20230312104500, a random tage drop-by:20230312 de qualquer extensão na tabela marcada 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 marcas em um intervalo de tempo de criação especificado

Remova todas as drop-by marcas de extensões na tabela MyTable em um 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 marcas que correspondem a regex específico

Remova todas as marcas que correspondem 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 Partição001 Partition002
2dfdef64-62a3-4950-a130-96b5b1083b5a 0fb7f3da-5e28-4f09-a000-e62eb41592df