Comando .drop extents
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer
Descarta extensões de um banco de dados ou tabela especificada.
Esse comando tem várias variantes: Em uma, as extensões a serem descartadas são especificadas por uma consulta Kusto. Nas outras variantes, as extensões são especificadas usando uma minilinguagem descrita abaixo.
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).
Cuidado
Se você descartar uma extensão, todas as linhas nessa extensão serão excluídas. Para excluir registros individuais, use Exclusão reversível.
Permissões
Se o TableName for especificado, você deverá ter pelo menos permissões de Administrador de Tabela para executar o comando.
Se o TableName não for especificado, você deverá ter pelo menos permissões de administrador de banco de dados para executar o comando.
Sintaxe
Descartar extensões com uma consulta
.dropextents [whatif] <| Consulta
Saiba mais sobre as convenções de sintaxe.
Parâmetros
| Nome | Digitar | Obrigatória | Descrição |
|---|---|---|---|
whatif |
string |
Se especificado, as extensões serão relatadas em vez de serem descartadas. | |
| Consulta | string |
✔️ | Os resultados dessa consulta KQL (Kusto Query Language) especificam as tabelas de origem e as IDs de extensão a serem descartadas. Deve retornar um conjunto de registros com colunas chamadas "ExtentId" e "TableName". |
Descartar uma extensão específica ou múltipla
.dropextents (ExtentIds Nome da) from tabela
Parâmetros
| Nome | Digitar | Obrigatória | Descrição |
|---|---|---|---|
| ExtentIds | guid |
✔️ | Um ou mais identificadores exclusivos separados por vírgulas das extensões a serem descartadas. |
| TableName | string |
O nome da tabela em que a extensão a ser descartada está localizada. |
Eliminar extensões por propriedades especificadas
.dropextents older[ N (days | hours)] from (TableName tablesall | ) [trim by ( | extentsizedatasize) Tamanho (GB | bytes | MB)] [limit LimitCount]
Parâmetros
| Nome | Digitar | Obrigatória | Descrição |
|---|---|---|---|
| N | int |
✔️ | Extensões de descarte com mais de N dias/horas. |
| TableName | string |
O nome da tabela em que a extensão a ser descartada está localizada | |
| Tamanho | int |
✔️ | Corte os dados no banco de dados até que a soma das extensões corresponda ao tamanho necessário (MaxSize). |
| Contagem de limites | int |
✔️ | Aplicado às primeiras extensões LimitCount . |
O comando dá suporte ao modo de emulação que produz uma saída como se o comando tivesse sido executado, mas sem realmente executá-lo. Use .drop-pretend em vez de .drop.
Devoluções
O comando retorna uma tabela com as informações a seguir.
| Parâmetro de saída | Tipo | Descrição |
|---|---|---|
| ExtentId | string |
ExtentId que foi descartado por causa do comando |
| TableName | string |
Nome da tabela, onde a extensão pertencia |
| CreatedOn | dateTime |
Carimbo de data/hora que contém informações sobre quando a extensão foi criada inicialmente |
Por exemplo, o valor retornado de um comando pode ser semelhante à tabela a seguir.
| ID da extensão | Nome da Tabela | Data da criação |
|---|---|---|
| 43c6e03f-1713-4ca7-a52a-5db8a4e8b87d | TestTable | 2015-01-12 12:48:49.4298178 |
Exemplos
Descartar uma extensão específica
Use uma ID de Extensão para descartar uma extensão específica.
.drop extent 609ad1e2-5b1c-4b79-90c0-1dec262e9f46 from Table1
Descartar várias extensões
Use uma lista de IDs de Extensão para descartar várias extensões.
.drop extents (609ad1e2-5b1c-4b79-90c0-1dec262e9f46, 310a60c6-8529-4cdf-a309-fe6aa7857e1d) from Table1
Remover todas as extensões por tempo de criação
Remova todas as extensões criadas há mais de 10 dias, de todas as tabelas no banco de dados MyDatabase
.drop extents <| .show database MyDatabase extents | where CreatedOn < now() - time(10d)
Remover algumas extensões por tempo de criação
Remover todas as extensões em tabelas Table1 e Table2 cujo tempo de criação foi superior a 10 dias atrás
.drop extents older 10 days from tables (Table1, Table2)
Remover uma extensão usando extent_id()
Remova uma extensão de uma tabela usando a função interna extent_id() .
.drop extents <|
StormEvents
| where EventId == '66144'
| summarize by ExtentId = extent_id(), TableName = "StormEvents"
Modo de emulação: Mostre quais extensões seriam removidas pelo comando
Observação
O parâmetro ID de extensão não é aplicável a esse comando.
.drop-pretend extents older 10 days from all tables
Remover todas as extensões de 'TestTable'
.drop extents from TestTable
Observação
A remoção de todas as extensões não exclui necessariamente todos os dados da tabela, se a ingestão de streaming estiver habilitada. Para limpar todos os dados de uma tabela, use .clear table data TestTable.