QueryBase¶
- class lsst.daf.butler.queries.QueryBase(driver: QueryDriver, tree: QueryTree)¶
Bases:
ABC
Common base class for
Query
and allQueryResult
objects.This class should rarely be referenced directly; it is public only because it provides public methods to its subclasses.
- Parameters:
- driver
QueryDriver
Implementation object that knows how to actually execute queries.
- tree
QueryTree
Description of the query as a tree of joins and column expressions.
- driver
Methods Summary
any
(*[, execute, exact])Test whether the query would return any rows.
explain_no_results
([execute])Return human-readable messages that may help explain why the query yields no results.
where
(*args[, bind])Return a query with a boolean-expression filter on its rows.
Methods Documentation
- any(*, execute: bool = True, exact: bool = True) bool ¶
Test whether the query would return any rows.
- Parameters:
- execute
bool
, optional If
True
, execute at least aLIMIT 1
query if it cannot be determined prior to execution that the query would return no rows.- exact
bool
, optional If
True
, run the full query and perform post-query filtering if needed, until at least one result row is found. IfFalse
, the returned result does not account for post-query filtering, and hence may beTrue
even when all result rows would be filtered out.
- execute
- Returns:
- explain_no_results(execute: bool = True) Iterable[str] ¶
Return human-readable messages that may help explain why the query yields no results.
- abstract where(*args: str | Predicate | DataCoordinate | Mapping[str, Any], bind: Mapping[str, Any] | None = None, **kwargs: int | str) Self ¶
Return a query with a boolean-expression filter on its rows.
- Parameters:
- *args
Constraints to apply, combined with logical AND. Arguments may be
str
expressions to parse,Predicate
objects (these are typically constructed viaexpression_factory
) or data IDs.- bind
Mapping
Mapping from string identifier appearing in a string expression to a literal value that should be substituted for it. This is recommended instead of embedding literals directly into the expression, especially for strings, timespans, or other types where quoting or formatting is nontrivial.
- **kwargs
Data ID key value pairs that extend and override any present in
*args
.
- Returns:
- query
QueryBase
A new query object with the given row filters (as well as any already present in
self
). All row filters are combined with logical AND.
- query
Notes
If an expression references a dimension or dimension element that is not already present in the query, it will be joined in, but dataset searches must already be joined into a query in order to reference their fields in expressions.
Data ID values are not checked for consistency; they are extracted from
args
and thenkwargs
and combined, with later values overriding earlier ones.