共用方式為

.delete 數據表記錄 - 虛刪除命令

  • 發行項

適用於： ✅Azure 數據總管

若要虛刪除個別記錄，但不保證包含這些記錄的記憶體成品也會被刪除，請使用下列命令。 此命令會將記錄標示為已刪除，但不一定會從儲存體成品中刪除數據。 如需詳細資訊，請參閱虛刪除。

若要刪除具有系統保證包含這些記錄的記憶體成品也會刪除個別記錄，請參閱 數據清除。

語法

.delete[async] table TableName [with ( propertyName records = propertyValue [, ...]] <| )謂語

深入瞭解 語法慣例。

參數

姓名 類型​​ 必要 描述
async string 如果指定，表示命令會以異步模式執行。
TableName string ✔️ 要從中刪除記錄的數據表名稱。
propertyName、 propertyValue string 索引鍵/值屬性組的逗號分隔清單。 請參閱 支持的屬性。
謂語 string ✔️ 傳回要刪除之記錄的述詞，其指定為查詢。 請參閱「注意」。

注意

下列限制適用於 述詞：

  • 述詞應該至少有一個 where 運算符。
  • 述詞只能使用下列運算子： extend、 where 和 project。
  • 述詞無法使用 externaldata。

支援的屬性

名稱 類型​​ 描述
whatif bool 如果 true為 ，則會傳回將在每個分區中刪除的記錄數目，而不會實際刪除任何記錄。 預設值為 false。

傳回

命令的輸出包含哪些範圍已取代的相關信息。

範例：刪除指定用戶的記錄

若要移除包含指定使用者資料的所有記錄：

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

範例：檢查數據表中刪除多少筆記錄

若要判斷作業將刪除的記錄數目，而不實際刪除這些記錄，請在模式中whatif執行命令時，檢查 RecordsMatchPredicate 資料行中的值：

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

.delete 具體化檢視記錄 - 虛刪除命令

在具體化檢視上執行虛刪除時，會套用相同的概念和限制。

語法 - 具體化檢視

.delete[async] materialized-view MaterializedViewName [with ( propertyName records = propertyValue [, ...]] <| )謂語

深入瞭解 語法慣例。

參數 - 具體化檢視

名稱 類型​​ 必要 描述
async string 如果指定，表示命令會以異步模式執行。
MaterializedViewName string ✔️ 要刪除記錄之具體化檢視的名稱。
propertyName、 propertyValue string 索引鍵/值屬性組的逗號分隔清單。 請參閱 支持的屬性。
謂語 string ✔️ 傳回要刪除之記錄的述詞。 指定為查詢。

注意

這裡也適用於針對數據表所提及述詞的相同限制。 虛刪除可能會在與 背景中執行的具體化程式 發生衝突時失敗。 在此情況下，重試作業可有所説明。 若要避免衝突，您可以在 執行虛刪除之前先停用具體化檢視 ，並在作業完成時重新啟用它。 述詞中不允許使用函式materialized_view（）。

支援的屬性 - 具體化檢視

名稱 類型​​ 描述
whatif bool 如果 true為 ，則會傳回將在每個分區中刪除的記錄數目，而不會實際刪除任何記錄。 預設值為 false。

範例 - 具體化檢視

若要移除包含指定使用者資料的所有具體化檢視記錄：

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

範例：檢查從具體化檢視中刪除多少筆記錄

若要判斷作業將刪除的記錄數目，而不實際刪除這些記錄，請在模式中whatif執行命令時，檢查 RecordsMatchPredicate 資料行中的值：

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

相關內容