Coverage for python/lsst/daf/butler/datastores/inMemoryDatastore.py: 90%
218 statements
« prev ^ index » next coverage.py v7.16.0, created at 2026-08-29 09:13 +0000
1# This file is part of daf_butler.
2#
3# Developed for the LSST Data Management System.
4# This product includes software developed by the LSST Project
5# (http://www.lsst.org).
6# See the COPYRIGHT file at the top-level directory of this distribution
7# for details of code ownership.
8#
9# This software is dual licensed under the GNU General Public License and also
10# under a 3-clause BSD license. Recipients may choose which of these licenses
11# to use; please see the files gpl-3.0.txt and/or bsd_license.txt,
12# respectively. If you choose the GPL option then the following text applies
13# (but note that there is still no warranty even if you opt for BSD instead):
14#
15# This program is free software: you can redistribute it and/or modify
16# it under the terms of the GNU General Public License as published by
17# the Free Software Foundation, either version 3 of the License, or
18# (at your option) any later version.
19#
20# This program is distributed in the hope that it will be useful,
21# but WITHOUT ANY WARRANTY; without even the implied warranty of
22# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23# GNU General Public License for more details.
24#
25# You should have received a copy of the GNU General Public License
26# along with this program. If not, see <http://www.gnu.org/licenses/>.
28"""In-memory datastore."""
30from __future__ import annotations
32__all__ = ("InMemoryDatastore", "StoredMemoryItemInfo")
34import logging
35import time
36from collections.abc import Collection, Iterable, Mapping
37from dataclasses import dataclass
38from typing import TYPE_CHECKING, Any
39from urllib.parse import urlencode
41from lsst.daf.butler import DatasetId, DatasetRef, StorageClass
42from lsst.daf.butler._exceptions import DatasetTypeNotSupportedError
43from lsst.daf.butler.datastore import DatasetRefURIs, DatastoreConfig
44from lsst.daf.butler.datastore.generic_base import GenericBaseDatastore, post_process_get
45from lsst.daf.butler.datastore.record_data import DatastoreRecordData
46from lsst.daf.butler.datastore.stored_file_info import StoredDatastoreItemInfo
47from lsst.daf.butler.utils import transactional
48from lsst.resources import ResourcePath, ResourcePathExpression
50if TYPE_CHECKING:
51 from lsst.daf.butler import Config, DatasetProvenance, DatasetType, LookupKey
52 from lsst.daf.butler.datastore import DatastoreOpaqueTable
53 from lsst.daf.butler.datastores.file_datastore.retrieve_artifacts import ArtifactIndexInfo
54 from lsst.daf.butler.registry.interfaces import DatasetIdRef, DatastoreRegistryBridgeManager
56log = logging.getLogger(__name__)
59@dataclass(frozen=True, slots=True)
60class StoredMemoryItemInfo(StoredDatastoreItemInfo):
61 """Internal InMemoryDatastore Metadata associated with a stored
62 DatasetRef.
63 """
65 timestamp: float
66 """Unix timestamp indicating the time the dataset was stored."""
68 storageClass: StorageClass
69 """StorageClass associated with the dataset."""
71 parentID: DatasetId
72 """ID of the parent `DatasetRef` if this entry is a concrete
73 composite. Not used if the dataset being stored is not a
74 virtual component of a composite
75 """
78class InMemoryDatastore(GenericBaseDatastore[StoredMemoryItemInfo]):
79 """Basic Datastore for writing to an in memory cache.
81 This datastore is ephemeral in that the contents of the datastore
82 disappear when the Python process completes. This also means that
83 other processes can not access this datastore.
85 Parameters
86 ----------
87 config : `DatastoreConfig` or `str`
88 Configuration.
89 bridgeManager : `DatastoreRegistryBridgeManager`
90 Object that manages the interface between `Registry` and datastores.
92 Notes
93 -----
94 InMemoryDatastore does not support any file-based ingest.
95 """
97 defaultConfigFile = "datastores/inMemoryDatastore.yaml"
98 """Path to configuration defaults. Accessed within the ``configs`` resource
99 or relative to a search path. Can be None if no defaults specified.
100 """
102 isEphemeral = True
103 """A new datastore is created every time and datasets disappear when
104 the process shuts down."""
106 datasets: dict[DatasetId, Any]
107 """Internal storage of datasets indexed by dataset ID."""
109 records: dict[DatasetId, StoredMemoryItemInfo]
110 """Internal records about stored datasets."""
112 def __init__(
113 self,
114 config: DatastoreConfig,
115 bridgeManager: DatastoreRegistryBridgeManager,
116 ):
117 super().__init__(config, bridgeManager)
119 # Name ourselves with the timestamp the datastore
120 # was created.
121 self.name = f"{type(self).__name__}@{time.time()}"
122 log.debug("Creating datastore %s", self.name)
124 # Storage of datasets, keyed by dataset_id
125 self.datasets: dict[DatasetId, Any] = {}
127 # Records is distinct in order to track concrete composite components
128 # where we register multiple components for a single dataset.
129 self.records: dict[DatasetId, StoredMemoryItemInfo] = {}
131 # Related records that share the same parent
132 self.related: dict[DatasetId, set[DatasetId]] = {}
134 self._trashedIds: set[DatasetId] = set()
136 @classmethod
137 def _create_from_config(
138 cls,
139 config: DatastoreConfig,
140 bridgeManager: DatastoreRegistryBridgeManager,
141 butlerRoot: ResourcePathExpression | None,
142 ) -> InMemoryDatastore:
143 return InMemoryDatastore(config, bridgeManager)
145 def clone(self, bridgeManager: DatastoreRegistryBridgeManager) -> InMemoryDatastore:
146 clone = InMemoryDatastore(self.config, bridgeManager)
147 # Sharing these objects is not thread-safe, but this class is only used
148 # in single-threaded test code.
149 clone.datasets = self.datasets
150 clone.records = self.records
151 clone.related = self.related
152 clone._trashedIds = self._trashedIds
153 return clone
155 @classmethod
156 def setConfigRoot(cls, root: str, config: Config, full: Config, overwrite: bool = True) -> None:
157 """Set any filesystem-dependent config options for this Datastore to
158 be appropriate for a new empty repository with the given root.
160 Does nothing in this implementation.
162 Parameters
163 ----------
164 root : `str`
165 Filesystem path to the root of the data repository.
166 config : `Config`
167 A `Config` to update. Only the subset understood by
168 this component will be updated. Will not expand
169 defaults.
170 full : `Config`
171 A complete config with all defaults expanded that can be
172 converted to a `DatastoreConfig`. Read-only and will not be
173 modified by this method.
174 Repository-specific options that should not be obtained
175 from defaults when Butler instances are constructed
176 should be copied from ``full`` to ``config``.
177 overwrite : `bool`, optional
178 If `False`, do not modify a value in ``config`` if the value
179 already exists. Default is always to overwrite with the provided
180 ``root``.
182 Notes
183 -----
184 If a keyword is explicitly defined in the supplied ``config`` it
185 will not be overridden by this method if ``overwrite`` is `False`.
186 This allows explicit values set in external configs to be retained.
187 """
188 return
190 def _get_stored_item_info(self, dataset_id: DatasetId) -> StoredMemoryItemInfo:
191 # Docstring inherited from GenericBaseDatastore.
192 return self.records[dataset_id]
194 def _remove_stored_item_info(self, dataset_id: DatasetId) -> None:
195 # Docstring inherited from GenericBaseDatastore.
196 # If a component has been removed previously then we can sometimes
197 # be asked to remove it again. Other datastores ignore this
198 # so also ignore here
199 if dataset_id not in self.records:
200 return
201 record = self.records[dataset_id]
202 del self.records[dataset_id]
203 self.related[record.parentID].remove(dataset_id)
205 def removeStoredItemInfo(self, ref: DatasetIdRef) -> None:
206 """Remove information about the file associated with this dataset.
208 Parameters
209 ----------
210 ref : `DatasetRef`
211 The dataset that has been removed.
213 Notes
214 -----
215 This method is actually not used by this implementation, but there are
216 some tests that check that this method works, so we keep it for now.
217 """
218 self._remove_stored_item_info(ref.id)
220 def _get_dataset_info(self, dataset_id: DatasetId) -> tuple[DatasetId, StoredMemoryItemInfo]:
221 """Check that the dataset is present and return the real ID and
222 associated information.
224 Parameters
225 ----------
226 dataset_id : `DatasetRef`
227 Target `DatasetRef`
229 Returns
230 -------
231 realID : `int`
232 The dataset ID associated with this ref that should be used. This
233 could either be the ID of the supplied `DatasetRef` or the parent.
234 storageInfo : `StoredMemoryItemInfo`
235 Associated storage information.
237 Raises
238 ------
239 FileNotFoundError
240 Raised if the dataset is not present in this datastore.
241 """
242 try:
243 storedItemInfo = self._get_stored_item_info(dataset_id)
244 except KeyError:
245 raise FileNotFoundError(f"No such file dataset in memory: {dataset_id}") from None
246 realID = dataset_id
247 if storedItemInfo.parentID is not None: 247 ↛ 250line 247 didn't jump to line 250 because the condition on line 247 was always true
248 realID = storedItemInfo.parentID
250 if realID not in self.datasets: 250 ↛ 251line 250 didn't jump to line 251 because the condition on line 250 was never true
251 raise FileNotFoundError(f"No such file dataset in memory: {dataset_id}")
253 return realID, storedItemInfo
255 def knows(self, ref: DatasetRef) -> bool:
256 """Check if the dataset is known to the datastore.
258 This datastore does not distinguish dataset existence from knowledge
259 of a dataset.
261 Parameters
262 ----------
263 ref : `DatasetRef`
264 Reference to the required dataset.
266 Returns
267 -------
268 exists : `bool`
269 `True` if the dataset is known to the datastore.
270 """
271 return self.exists(ref)
273 def exists(self, ref: DatasetRef) -> bool:
274 """Check if the dataset exists in the datastore.
276 Parameters
277 ----------
278 ref : `DatasetRef`
279 Reference to the required dataset.
281 Returns
282 -------
283 exists : `bool`
284 `True` if the entity exists in the `Datastore`.
285 """
286 try:
287 self._get_dataset_info(ref.id)
288 except FileNotFoundError:
289 return False
290 return True
292 def get(
293 self,
294 ref: DatasetRef,
295 parameters: Mapping[str, Any] | None = None,
296 storageClass: StorageClass | str | None = None,
297 ) -> Any:
298 """Load an InMemoryDataset from the store.
300 Parameters
301 ----------
302 ref : `DatasetRef`
303 Reference to the required Dataset.
304 parameters : `dict`
305 `StorageClass`-specific parameters that specify, for example,
306 a slice of the dataset to be loaded.
307 storageClass : `StorageClass` or `str`, optional
308 The storage class to be used to override the Python type
309 returned by this method. By default the returned type matches
310 the dataset type definition for this dataset. Specifying a
311 read `StorageClass` can force a different type to be returned.
312 This type must be compatible with the original type.
314 Returns
315 -------
316 inMemoryDataset : `object`
317 Requested dataset or slice thereof as an InMemoryDataset.
319 Raises
320 ------
321 FileNotFoundError
322 Requested dataset can not be retrieved.
323 TypeError
324 Return value from formatter has unexpected type.
325 ValueError
326 Formatter failed to process the dataset.
327 """
328 log.debug("Retrieve %s from %s with parameters %s", ref, self.name, parameters)
330 realID, storedItemInfo = self._get_dataset_info(ref.id)
332 # We have a write storage class and a read storage class and they
333 # can be different for concrete composites or if overridden.
334 if storageClass is not None:
335 ref = ref.overrideStorageClass(storageClass)
336 refStorageClass = ref.datasetType.storageClass
337 writeStorageClass = storedItemInfo.storageClass
339 component = ref.datasetType.component()
341 # Check that the supplied parameters are suitable for the type read
342 # If this is a derived component we validate against the composite
343 isDerivedComponent = False
344 if component in writeStorageClass.derivedComponents:
345 writeStorageClass.validateParameters(parameters)
346 isDerivedComponent = True
347 else:
348 refStorageClass.validateParameters(parameters)
350 inMemoryDataset = self.datasets[realID]
352 # if this is a read only component we need to apply parameters
353 # before we retrieve the component. We assume that the parameters
354 # will affect the data globally, before the derived component
355 # is selected.
356 if isDerivedComponent:
357 inMemoryDataset = writeStorageClass.delegate().handleParameters(inMemoryDataset, parameters)
358 # Then disable parameters for later
359 parameters = {}
361 # Check if we have a component.
362 if component:
363 # In-memory datastore must have stored the dataset as a single
364 # object in the write storage class. We therefore use that
365 # storage class delegate to obtain the component.
366 compositeStorageClass = writeStorageClass
367 if component not in writeStorageClass.allComponents():
368 # The component is defined by the storage class the caller is
369 # converting to rather than the one used to write, so the
370 # composite has to be converted before the component can be
371 # extracted from it.
372 parentStorageClass = ref.datasetType.parentStorageClass
373 if parentStorageClass is not None: 373 ↛ 376line 373 didn't jump to line 376 because the condition on line 373 was always true
374 compositeStorageClass = parentStorageClass
375 inMemoryDataset = parentStorageClass.coerce_type(inMemoryDataset)
376 inMemoryDataset = compositeStorageClass.delegate().getComponent(inMemoryDataset, component)
378 # Since there is no formatter to process parameters, they all must be
379 # passed to the assembler.
380 inMemoryDataset = post_process_get(
381 inMemoryDataset, refStorageClass, parameters, isComponent=component is not None
382 )
384 # Last minute type conversion.
385 return refStorageClass.coerce_type(inMemoryDataset)
387 def put(self, inMemoryDataset: Any, ref: DatasetRef, provenance: DatasetProvenance | None = None) -> None:
388 """Write a InMemoryDataset with a given `DatasetRef` to the store.
390 Parameters
391 ----------
392 inMemoryDataset : `object`
393 The dataset to store.
394 ref : `DatasetRef`
395 Reference to the associated Dataset.
396 provenance : `DatasetProvenance` or `None`, optional
397 Any provenance that should be attached to the serialized dataset.
399 Raises
400 ------
401 TypeError
402 Supplied object and storage class are inconsistent.
403 DatasetTypeNotSupportedError
404 The associated `DatasetType` is not handled by this datastore.
406 Notes
407 -----
408 If the datastore is configured to reject certain dataset types it
409 is possible that the put will fail and raise a
410 `DatasetTypeNotSupportedError`. The main use case for this is to
411 allow `ChainedDatastore` to put to multiple datastores without
412 requiring that every datastore accepts the dataset.
413 """
414 if not self.constraints.isAcceptable(ref):
415 # Raise rather than use boolean return value.
416 raise DatasetTypeNotSupportedError(
417 f"Dataset {ref} has been rejected by this datastore via configuration."
418 )
420 # May need to coerce the in memory dataset to the correct
421 # python type, otherwise parameters may not work.
422 try:
423 delegate = ref.datasetType.storageClass.delegate()
424 except TypeError:
425 # TypeError is raised when a storage class doesn't have a delegate.
426 delegate = None
427 if not delegate or not delegate.can_accept(inMemoryDataset):
428 inMemoryDataset = ref.datasetType.storageClass.coerce_type(inMemoryDataset)
430 # Update provenance.
431 if delegate: 431 ↛ 434line 431 didn't jump to line 434 because the condition on line 431 was always true
432 inMemoryDataset = delegate.add_provenance(inMemoryDataset, ref, provenance=provenance)
434 self.datasets[ref.id] = inMemoryDataset
435 log.debug("Store %s in %s", ref, self.name)
437 # Store time we received this content, to allow us to optionally
438 # expire it. Instead of storing a filename here, we include the
439 # ID of this datasetRef so we can find it from components.
440 itemInfo = StoredMemoryItemInfo(time.time(), ref.datasetType.storageClass, parentID=ref.id)
442 # We have to register this content with registry.
443 # Currently this assumes we have a file so we need to use stub entries
444 self.records[ref.id] = itemInfo
445 self.related.setdefault(itemInfo.parentID, set()).add(ref.id)
447 if self._transaction is not None:
448 self._transaction.registerUndo("put", self.remove, ref)
450 def put_new(self, in_memory_dataset: Any, ref: DatasetRef) -> Mapping[str, DatasetRef]:
451 # It is OK to call put() here because registry is not populating
452 # bridges as we return empty dict from this method.
453 self.put(in_memory_dataset, ref)
454 # As ephemeral we return empty dict.
455 return {}
457 def getURIs(self, ref: DatasetRef, predict: bool = False) -> DatasetRefURIs:
458 """Return URIs associated with dataset.
460 Parameters
461 ----------
462 ref : `DatasetRef`
463 Reference to the required dataset.
464 predict : `bool`, optional
465 If the datastore does not know about the dataset, controls whether
466 it should return a predicted URI or not.
468 Returns
469 -------
470 uris : `DatasetRefURIs`
471 The URI to the primary artifact associated with this dataset (if
472 the dataset was disassembled within the datastore this may be
473 `None`), and the URIs to any components associated with the dataset
474 artifact. (can be empty if there are no components).
476 Notes
477 -----
478 The URIs returned for in-memory datastores are not usable but
479 provide an indication of the associated dataset.
480 """
481 # Include the dataID as a URI query
482 query = urlencode(ref.dataId.required)
484 # if this has never been written then we have to guess
485 if not self.exists(ref):
486 if not predict:
487 raise FileNotFoundError(f"Dataset {ref} not in this datastore")
488 name = f"{ref.datasetType.name}"
489 fragment = "#predicted"
490 else:
491 realID, _ = self._get_dataset_info(ref.id)
492 name = f"{id(self.datasets[realID])}_{ref.id}"
493 fragment = ""
495 return DatasetRefURIs(ResourcePath(f"mem://{name}?{query}{fragment}"), {})
497 def getURI(self, ref: DatasetRef, predict: bool = False) -> ResourcePath:
498 """URI to the Dataset.
500 Always uses "mem://" URI prefix.
502 Parameters
503 ----------
504 ref : `DatasetRef`
505 Reference to the required Dataset.
506 predict : `bool`
507 If `True`, allow URIs to be returned of datasets that have not
508 been written.
510 Returns
511 -------
512 uri : `str`
513 URI pointing to the dataset within the datastore. If the
514 dataset does not exist in the datastore, and if ``predict`` is
515 `True`, the URI will be a prediction and will include a URI
516 fragment "#predicted".
517 If the datastore does not have entities that relate well
518 to the concept of a URI the returned URI string will be
519 descriptive. The returned URI is not guaranteed to be obtainable.
521 Raises
522 ------
523 FileNotFoundError
524 A URI has been requested for a dataset that does not exist and
525 guessing is not allowed.
526 AssertionError
527 Raised if an internal error occurs.
528 """
529 primary, _ = self.getURIs(ref, predict)
530 if primary is None:
531 # This should be impossible since this datastore does
532 # not disassemble. This check also helps mypy.
533 raise AssertionError(f"Unexpectedly got no URI for in-memory datastore for {ref}")
534 return primary
536 def ingest_zip(self, zip_path: ResourcePath, transfer: str | None, *, dry_run: bool = False) -> None:
537 raise NotImplementedError("Can only ingest a Zip into a file datastore.")
539 def retrieveArtifacts(
540 self,
541 refs: Iterable[DatasetRef],
542 destination: ResourcePath,
543 transfer: str = "auto",
544 preserve_path: bool = True,
545 overwrite: bool | None = False,
546 write_index: bool = True,
547 add_prefix: bool = False,
548 ) -> dict[ResourcePath, ArtifactIndexInfo]:
549 """Retrieve the file artifacts associated with the supplied refs.
551 Parameters
552 ----------
553 refs : `~collections.abc.Iterable` of `DatasetRef`
554 The datasets for which artifacts are to be retrieved.
555 A single ref can result in multiple artifacts. The refs must
556 be resolved.
557 destination : `lsst.resources.ResourcePath`
558 Location to write the artifacts.
559 transfer : `str`, optional
560 Method to use to transfer the artifacts. Must be one of the options
561 supported by `lsst.resources.ResourcePath.transfer_from`.
562 "move" is not allowed.
563 preserve_path : `bool`, optional
564 If `True` the full path of the artifact within the datastore
565 is preserved. If `False` the final file component of the path
566 is used.
567 overwrite : `bool`, optional
568 If `True` allow transfers to overwrite existing files at the
569 destination.
570 write_index : `bool`, optional
571 If `True` write a file at the top level containing a serialization
572 of a `ZipIndex` for the downloaded datasets.
573 add_prefix : `bool`, optional
574 If `True` and if ``preserve_path`` is `False`, apply a prefix to
575 the filenames corresponding to some part of the dataset ref ID.
576 This can be used to guarantee uniqueness.
578 Notes
579 -----
580 Not implemented by this datastore.
581 """
582 # Could conceivably launch a FileDatastore to use formatters to write
583 # the data but this is fraught with problems.
584 raise NotImplementedError("Can not write artifacts to disk from in-memory datastore.")
586 def forget(self, refs: Iterable[DatasetRef]) -> None:
587 # Docstring inherited.
588 refs = list(refs)
589 for ref in refs:
590 self._remove_stored_item_info(ref.id)
592 @transactional
593 def trash(self, ref: DatasetRef | Iterable[DatasetRef], ignore_errors: bool = False) -> None:
594 """Indicate to the Datastore that a dataset can be removed.
596 Parameters
597 ----------
598 ref : `DatasetRef` or iterable thereof
599 Reference to the required Dataset(s).
600 ignore_errors : `bool`, optional
601 Indicate that errors should be ignored.
603 Returns
604 -------
605 None
607 Raises
608 ------
609 FileNotFoundError
610 Attempt to remove a dataset that does not exist. Only relevant
611 if a single dataset ref is given.
613 Notes
614 -----
615 Concurrency should not normally be an issue for the in memory datastore
616 since all internal changes are isolated to solely this process and
617 the registry only changes rows associated with this process.
618 """
619 if isinstance(ref, DatasetRef):
620 # Check that this dataset is known to datastore
621 try:
622 self._get_dataset_info(ref.id)
623 except Exception as e:
624 if ignore_errors: 624 ↛ 625line 624 didn't jump to line 625 because the condition on line 624 was never true
625 log.warning(
626 "Error encountered moving dataset %s to trash in datastore %s: %s", ref, self.name, e
627 )
628 else:
629 raise
630 log.debug("Trash %s in datastore %s", ref, self.name)
631 ref_list = [ref]
632 else:
633 ref_list = list(ref)
634 log.debug("Bulk trashing of datasets in datastore %s", self.name)
636 def _rollbackMoveToTrash(refs: Iterable[DatasetIdRef]) -> None:
637 for ref in refs: 637 ↛ exitline 637 didn't return from function '_rollbackMoveToTrash' because the loop on line 637 didn't complete
638 self._trashedIds.remove(ref.id)
640 assert self._transaction is not None, "Must be in transaction"
641 with self._transaction.undoWith(f"Trash {len(ref_list)} datasets", _rollbackMoveToTrash, ref_list):
642 self._trashedIds.update(ref.id for ref in ref_list)
644 def emptyTrash(
645 self, ignore_errors: bool = False, refs: Collection[DatasetRef] | None = None, dry_run: bool = False
646 ) -> set[ResourcePath]:
647 """Remove all datasets from the trash.
649 Parameters
650 ----------
651 ignore_errors : `bool`, optional
652 Ignore errors.
653 refs : `collections.abc.Collection` [ `DatasetRef` ] or `None`
654 Explicit list of datasets that can be removed from trash. If listed
655 datasets are not already stored in the trash table they will be
656 ignored. If `None` every entry in the trash table will be
657 processed.
658 dry_run : `bool`, optional
659 If `True`, the trash table will be queried and results reported
660 but no artifacts will be removed.
662 Returns
663 -------
664 removed : `set` [ `lsst.resources.ResourcePath` ]
665 List of artifacts that were removed. Empty for this datastore.
667 Notes
668 -----
669 The internal tracking of datasets is affected by this method and
670 transaction handling is not supported if there is a problem before
671 the datasets themselves are deleted.
673 Concurrency should not normally be an issue for the in memory datastore
674 since all internal changes are isolated to solely this process and
675 the registry only changes rows associated with this process.
676 """
677 log.debug("Emptying trash in datastore %s", self.name)
679 trashed_ids = self._trashedIds
680 if refs: 680 ↛ 685line 680 didn't jump to line 685 because the condition on line 680 was always true
681 selected_ids = {ref.id for ref in refs}
682 if selected_ids is not None: 682 ↛ 685line 682 didn't jump to line 685 because the condition on line 682 was always true
683 trashed_ids = {tid for tid in trashed_ids if tid in selected_ids}
685 if dry_run: 685 ↛ 686line 685 didn't jump to line 686 because the condition on line 685 was never true
686 log.info(
687 "Would attempt remove %s dataset%s.", len(trashed_ids), "s" if len(trashed_ids) != 1 else ""
688 )
689 return set()
691 for dataset_id in trashed_ids:
692 try:
693 realID, _ = self._get_dataset_info(dataset_id)
694 except FileNotFoundError:
695 # Dataset already removed so ignore it
696 continue
697 except Exception as e:
698 if ignore_errors:
699 log.warning(
700 "Emptying trash in datastore %s but encountered an error with dataset %s: %s",
701 self.name,
702 dataset_id,
703 e,
704 )
705 continue
706 else:
707 raise
709 # Determine whether all references to this dataset have been
710 # removed and we can delete the dataset itself
711 allRefs = self.related[realID]
712 remainingRefs = allRefs - {dataset_id}
713 if not remainingRefs: 713 ↛ 718line 713 didn't jump to line 718 because the condition on line 713 was always true
714 log.debug("Removing artifact %s from datastore %s", realID, self.name)
715 del self.datasets[realID]
717 # Remove this entry
718 self._remove_stored_item_info(dataset_id)
720 # Empty the trash table
721 self._trashedIds = self._trashedIds - trashed_ids
722 return set()
724 def validateConfiguration(
725 self, entities: Iterable[DatasetRef | DatasetType | StorageClass], logFailures: bool = False
726 ) -> None:
727 """Validate some of the configuration for this datastore.
729 Parameters
730 ----------
731 entities : `~collections.abc.Iterable` [`DatasetRef` | `DatasetType`\
732 | `StorageClass`]
733 Entities to test against this configuration. Can be differing
734 types.
735 logFailures : `bool`, optional
736 If `True`, output a log message for every validation error
737 detected.
739 Returns
740 -------
741 None
743 Raises
744 ------
745 DatastoreValidationError
746 Raised if there is a validation problem with a configuration.
747 All the problems are reported in a single exception.
749 Notes
750 -----
751 This method is a no-op.
752 """
753 return
755 def _overrideTransferMode(self, *datasets: Any, transfer: str | None = None) -> str | None:
756 # Docstring is inherited from base class
757 return transfer
759 def validateKey(self, lookupKey: LookupKey, entity: DatasetRef | DatasetType | StorageClass) -> None:
760 # Docstring is inherited from base class
761 return
763 def getLookupKeys(self) -> set[LookupKey]:
764 # Docstring is inherited from base class
765 return self.constraints.getLookupKeys()
767 def needs_expanded_data_ids(
768 self,
769 transfer: str | None,
770 entity: DatasetRef | DatasetType | StorageClass | None = None,
771 ) -> bool:
772 # Docstring inherited.
773 return False
775 def import_records(self, data: Mapping[str, DatastoreRecordData]) -> None:
776 # Docstring inherited from the base class.
777 return
779 def export_records(self, refs: Iterable[DatasetIdRef]) -> Mapping[str, DatastoreRecordData]:
780 # Docstring inherited from the base class.
782 # In-memory Datastore records cannot be exported or imported
783 return {}
785 def export_predicted_records(self, refs: Iterable[DatasetIdRef]) -> dict[str, DatastoreRecordData]:
786 # Docstring inherited from the base class.
788 # In-memory Datastore records cannot be exported or imported
789 return {}
791 def get_opaque_table_definitions(self) -> Mapping[str, DatastoreOpaqueTable]:
792 # Docstring inherited from the base class.
793 return {}