Megosztás a következőn keresztül:


.delete table records – helyreállítható törlés parancs

Ha rendszer nélkül szeretne helyreállíthatóan törölni egyes rekordokat, akkor az alábbi paranccsal garantálhatja, hogy az ezeket a rekordokat tartalmazó tárolási összetevők is törlődnek. Ez a parancs töröltként jelöli meg a rekordokat, de nem feltétlenül törli az adatokat a tárolási összetevőkből. További információ: Helyreállítható törlés.

Az egyes rekordok rendszergaranciával történő törléséhez az ezeket a rekordokat tartalmazó tárolóösszetevők is törlődnek, lásd: Adattörlés.

Syntax

.delete [async] tableTableNamerecords [with(propertyName=propertyValue [, ...])] <|Predikátum

További információ a szintaxis konvenciókról.

Paraméterek

Név Típus Kötelező Leírás
async string Ha meg van adva, azt jelzi, hogy a parancs aszinkron módban fut.
TableName string ✔️ Annak a táblának a neve, amelyből rekordokat szeretne törölni.
propertyName, propertyValue string Kulcs-érték tulajdonságpárok vesszővel tagolt listája. Lásd a támogatott tulajdonságokat.
Predikátum string ✔️ Az a predikátum, amely a törölni kívánt rekordokat adja vissza, amely lekérdezésként van megadva. Lásd a megjegyzést.

Megjegyzés

A predikátumra a következő korlátozások vonatkoznak:

  • A predikátumnak legalább egy where operátorral kell rendelkeznie.
  • A predikátum csak a következő operátorokat használhatja: extend, where és project.
  • A predikátum nem használható externaldata.

Támogatott tulajdonságok

Név Típus Description
whatif bool Ha truea , az összes szegmensben törölt rekordok számát adja vissza anélkül, hogy ténylegesen törölne rekordokat. A mező alapértelmezett értéke: false.

Válaszok

A parancs kimenete információkat tartalmaz arról, hogy a rendszer mely mértékeket cserélte le.

Példa: adott felhasználó rekordjainak törlése

Egy adott felhasználó adatait tartalmazó összes rekord törlése:

.delete table MyTable records <| MyTable | where UserId == 'X'

Példa: ellenőrizze, hogy hány rekord törölhető egy táblából

Ha meg szeretné állapítani, hogy a művelet hány rekordot törölne anélkül, hogy ténylegesen törölné őket, ellenőrizze a RecordsMatchPredicate oszlop értékét, amikor a parancsot whatif módban futtatja:

.delete table MyTable records with (whatif=true) <| MyTable | where UserId == 'X'

.delete materialized-view records – helyreállítható törlés parancs

Ha a helyreállítható törlést materializált nézeteken hajtják végre, ugyanazok a fogalmak és korlátozások érvényesek.

Szintaxis – materializált nézetek

.delete [async] materialized-viewMaterializedViewNamerecords [with(propertyName=propertyValue [, ...])] <|Predikátum

További információ a szintaxis konvenciókról.

Paraméterek – materializált nézetek

Név Típus Kötelező Leírás
async string Ha meg van adva, azt jelzi, hogy a parancs aszinkron módban fut.
MaterializedViewName string ✔️ Annak a materializált nézetnek a neve, amelyből rekordokat szeretne törölni.
propertyName, propertyValue string Kulcs-érték tulajdonságpárok vesszővel tagolt listája. Lásd a támogatott tulajdonságokat.
Predikátum string ✔️ Az a predikátum, amely a törölni kívánt rekordokat adja vissza. Lekérdezésként van megadva.

Megjegyzés

A tábla predikátumára vonatkozó korlátozások itt is érvényesek. A helyreállítható törlés meghiúsulhat a háttérben futó materializálási folyamattal való ütközések esetén. Ebben az esetben a művelet újrapróbálása segíthet. Az ütközések elkerülése érdekében letilthatja a materializált nézetet a helyreállítható törlés végrehajtása előtt, és újra engedélyezheti a művelet befejezésekor. A predikátumban a materialized_view() függvény használata nem engedélyezett.

Támogatott tulajdonságok – materializált nézetek

Név Típus Description
whatif bool Ha truea , az összes szegmensben törölt rekordok számát adja vissza anélkül, hogy ténylegesen törölne rekordokat. A mező alapértelmezett értéke: false.

Példa – materializált nézetek

Az adott felhasználó adatait tartalmazó összes materializált nézetrekord törlése:

.delete materialized-view MyMaterializedView records <| MyMaterializedView | where UserId == 'X'

Példa: ellenőrizze, hogy hány rekordot törölne egy materializált nézetből

Ha meg szeretné állapítani, hogy a művelet hány rekordot törölne anélkül, hogy ténylegesen törölné őket, ellenőrizze az értéket a RecordsMatchPredicate oszlopban, miközben a parancsot whatif módban futtatja:

.delete materialized-view MyMaterializedView records with (whatif=true) <| MyMaterializedView | where UserId == 'X'