Skip to content

Commit

Permalink
Add news fragment
Browse files Browse the repository at this point in the history
  • Loading branch information
timj committed Sep 4, 2024
1 parent afba401 commit 9824f09
Showing 1 changed file with 10 additions and 0 deletions.
10 changes: 10 additions & 0 deletions doc/changes/DM-45872.feature.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
* A new query system and interface is now available using ``butler.query()`` as a context manager.
This new system is much more flexible and supports far more expressive queries, and no longer requires the results to be placed in a `set` to removed duplication.
* Added ``butler.query_datasets()``, ``butler.query_dimension_records()`` and ``butler.query_data_ids()`` as replacements for the ``butler.registry`` equivalents.
These use the new query system and are preferred over the old interfaces.
* The experimental collections querying interface is now public and called ``butler.collections.query_info`` and ``butler.collections.query``.
* The command line tools ``query-datasets``, ``associate``, ``retrieve-artifacts`` and ``transfer-datasets`` now support a ``--limit`` parameter.
The default for all except ``associate`` (which defaults to no limit) is to limit the number of results to 10,000.
A warning will be issued if the cap is hit.
* The command line tools ``query-datasets``, ``associate``, ``retrieve-artifacts`` and ``transfer-datasets`` now support ``--order-by`` to control the sorting in conjunction with ``--limit``.
For ``query-datasets`` this will also control the sorting of the reported tables.

0 comments on commit 9824f09

Please sign in to comment.