Skip to content

Commit

Permalink
Tell how to avoid bind collisions.
Browse files Browse the repository at this point in the history
  • Loading branch information
ktlim authored and timj committed Nov 1, 2024
1 parent 6cb0823 commit eb1fd68
Showing 1 changed file with 1 addition and 0 deletions.
1 change: 1 addition & 0 deletions doc/lsst.daf.butler/queries.rst
Original file line number Diff line number Diff line change
Expand Up @@ -167,6 +167,7 @@ filter query results based on that property of datasets.

Registry methods accepting user expressions also accept a ``bind`` parameter, which is a mapping from identifier name to its corresponding value.
Identifiers appearing in user expressions will be replaced with the corresponding value from this mapping.
Choose bind identifiers that are distinct and not the same as a dimension or dimension attribute name.
Using the ``bind`` parameter is encouraged when possible to simplify rendering of the query strings.
A partial example of comparing two approaches, without and with ``bind``:

Expand Down

0 comments on commit eb1fd68

Please sign in to comment.