From eb1fd686446b6d9b669986d8fc87685ce53328e0 Mon Sep 17 00:00:00 2001 From: Kian-Tat Lim Date: Sun, 3 Mar 2024 07:54:06 -0800 Subject: [PATCH] Tell how to avoid bind collisions. --- doc/lsst.daf.butler/queries.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/lsst.daf.butler/queries.rst b/doc/lsst.daf.butler/queries.rst index 4814ef2f9c..81d88e27d2 100644 --- a/doc/lsst.daf.butler/queries.rst +++ b/doc/lsst.daf.butler/queries.rst @@ -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``: