Befehl „.drop extents“
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer
Legt Ausdehnungen aus einer angegebenen Datenbank oder Tabelle ab.
Dieser Befehl verfügt über mehrere Varianten: In einem werden die zu verworfenen Bereiche durch eine Kusto-Abfrage angegeben. In den anderen Varianten werden Soweit mithilfe einer unten beschriebenen Minisprache angegeben.
Hinweis
Datenshards werden als Erweiterungen bezeichnet, und alle Befehle verwenden "extent" oder "extents" als Synonym. Weitere Informationen zu Ausmaßen finden Sie unter "Extents(Data Shards)" (Übersicht).
Achtung
Wenn Sie eine Erweiterung löschen, werden alle Zeilen in diesem Umfang gelöscht. Verwenden Sie "Vorläufiges Löschen", um einzelne Datensätze zu löschen.
Berechtigungen
Wenn " TableName " angegeben ist, müssen Sie mindestens über Tabellenadministratorberechtigungen verfügen, um den Befehl auszuführen.
Wenn " TableName " nicht angegeben ist, müssen Sie mindestens über Datenbankadministratorberechtigungen verfügen, um den Befehl auszuführen.
Syntax
Drop-Erweiterungen mit einer Abfrage
.dropextents [whatif] <| Abfrage
Erfahren Sie mehr über Syntaxkonventionen.
Parameter
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
whatif |
string |
Wenn angegeben, werden die Ausmaße gemeldet, anstatt verworfen zu werden. | |
| Abfrage | string |
✔️ | Die Ergebnisse dieser Kusto-Abfragesprache -Abfrage (KQL) geben die Quelltabellen und den Umfang der verworfenen IDs an. Sollte ein Recordset mit Spalten namens "ExtentId" und "TableName" zurückgeben. |
Ablegen eines bestimmten oder mehrerer Ausmaße
.dropextents (ExtentIds) from TableName
Parameter
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| ExtentIds | guid |
✔️ | Mindestens ein durch Kommas getrennte eindeutiger Bezeichner der zu verworfenen Ausmaße. |
| TableName | string |
Der Name der Tabelle, in der sich das Verworfene befindet. |
Drop-Ausmaße durch angegebene Eigenschaften
.dropextents [older N (dayshours | )] from (TableName | tablesall ) [trim by ( | extentsizedatasize) Size (GB | bytesMB | )] [limit LimitCount]
Parameter
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| N | int |
✔️ | Drop-Ausmaße älter als N Tage/Stunden. |
| TableName | string |
Der Name der Tabelle, in der sich das Verworfene befindet | |
| Größe | int |
✔️ | Kürzen Sie die Daten in der Datenbank, bis die Summe der Ausdehnungen mit der erforderlichen Größe übereinstimmt (MaxSize). |
| LimitCount | int |
✔️ | Wird auf das erste LimitCount-Ausmaß angewendet. |
Der Befehl unterstützt den Emulationsmodus, der eine Ausgabe erzeugt, als würde der Befehl ausgeführt werden, ohne ihn tatsächlich auszuführen. Verwenden Sie .drop-pretend anstelle von .drop.
Gibt zurück
Der Befehl gibt eine Tabelle mit den folgenden Informationen zurück.
| Ausgabeparameter | Typ | Beschreibung |
|---|---|---|
| ExtentId | string |
ExtentId, die aufgrund des Befehls gelöscht wurde |
| TableName | string |
Tabellenname, wobei der Umfang gehört |
| CreatedOn | dateTime |
Zeitstempel, der Informationen darüber enthält, wann der Umfang ursprünglich erstellt wurde |
Der Rückgabewert eines Befehls könnte beispielsweise wie in der folgenden Tabelle aussehen.
| Umfangs-ID | Tabellenname | Erstellungszeitpunkt |
|---|---|---|
| 43c6e03f-1713-4ca7-a52a-5db8a4e8b87d | TestTable | 2015-01-12 12:48:49.4298178 |
Beispiele
Ablegen eines bestimmten Umfangs
Verwenden Sie eine Erweiterungs-ID, um ein bestimmtes Ausmaß zu löschen.
.drop extent 609ad1e2-5b1c-4b79-90c0-1dec262e9f46 from Table1
Mehrere Ausdehnungen ablegen
Verwenden Sie eine Liste der Erweiterungs-IDs, um mehrere Ausmaße abzulegen.
.drop extents (609ad1e2-5b1c-4b79-90c0-1dec262e9f46, 310a60c6-8529-4cdf-a309-fe6aa7857e1d) from Table1
Entfernen aller Ausmaße nach Erstellungszeit
Entfernen aller vor mehr als 10 Tagen erstellten Erweiterungen aus allen Tabellen in der Datenbank MyDatabase
.drop extents <| .show database MyDatabase extents | where CreatedOn < now() - time(10d)
Entfernen einiger Bereiche nach Erstellungszeit
Entfernen aller Ausdehnungen in Tabellen Table1 und Table2 deren Erstellungszeit vor mehr als 10 Tagen
.drop extents older 10 days from tables (Table1, Table2)
Entfernen eines Umfangs mithilfe von extent_id()
Entfernen Sie ein Ausmaß aus einer Tabelle mithilfe der integrierten extent_id() Funktion.
.drop extents <|
StormEvents
| where EventId == '66144'
| summarize by ExtentId = extent_id(), TableName = "StormEvents"
Emulationsmodus: Anzeigen, welche Erweiterungen durch den Befehl entfernt werden würden
Hinweis
Der Parameter "Extent ID" ist für diesen Befehl nicht anwendbar.
.drop-pretend extents older 10 days from all tables
Entfernen aller Ausdehnungen von "TestTable"
.drop extents from TestTable
Hinweis
Wenn die Aufnahme von Streaming aktiviert ist, werden nicht unbedingt alle Daten in der Tabelle entfernt. Um alle Daten einer Tabelle zu löschen, verwenden Sie .clear table data TestTable.