EVICT

The EVICT operation removes one or more documents from the local Ditto store, deleting them entirely without flagging (tombstone) as deleted to remote peers:
DQL
EVICT FROM your_collection_name
WHERE [condition]
EVICT FROM your_collection_name
WHERE [condition]
﻿
In this syntax:
your_collection_name is the name of the collection from which you want to retrieve the data.
[condition] represents the condition or criteria that determine which documents should be evicted from the local peer.
Examples Deleting Documents
If using time-based replication, see Time-to-Live Eviction Strategy﻿.
Here, documents from the cars collection that have the document ID 123 get removed from the Ditto store:
DQL
EVICT FROM cars
WHERE _id = '123'
EVICT FROM cars
WHERE _id = '123'
﻿
As another example, the following snippet, once executed, results in the deletion of documents with timestamps greater than a certain value:
DQL
EVICT FROM cars
WHERE some_time_stamp > 1699888298000
EVICT FROM cars
WHERE some_time_stamp > 1699888298000
﻿
To remove a specific field from a document, use an UPDATE statement to tombstone that field. A tombstone is a flag signaling to remote peers that the DQL data type has been removed. (See UPDATE﻿)
﻿

Updated 02 Aug 2024

Did this page help you?

UPDATE

Types and Definitions