You need to have write permission on the collection to be able to delete datapoints.
Deleting data by datapoint IDs
To delete data from a collection, use the delete method. This method accepts a list of datapoint IDs to delete.
from tilebox.datasets import Client
client = Client()
datasets = client.datasets()
collections = datasets.my_custom_dataset.collections()
collection = collections["Sensor-1"]
n_deleted = collection.delete([
"0195c87a-49f6-5ffa-e3cb-92215d057ea6",
"0195c87b-bd0e-3998-05cf-af6538f34957",
])
print(f"Deleted {n_deleted} data points.")
In python, delete not only takes a list of datapoint IDs as string, but supports a wide range of other useful input types as well.
See the delete API documentation for more details. Possible errors
NotFoundError: raised if one of the data points is not found in the collection. If any of the data points are not found,
nothing will be deletedValueError: raised if one of the specified ids is not a valid UUID
Deleting a time interval
One common way to delete all datapoints in a time interval is to first query it from a collection and then deleting those
found datapoints. For this use case it often is a good idea to query the datapoints with skip_data=True to avoid actually
loading the data fields, since only the datapoint IDs are required. See skipping data fields for more details.
to_delete = collection.query(temporal_extent=("2023-05-01", "2023-06-01"), skip_data=True)
n_deleted = collection.delete(to_delete)
print(f"Deleted {n_deleted} data points.")
Automatic batching
Tilebox automatically batches the delete requests for you, so you don’t have to worry about the maximum request size.
