[DRIVERS-2252] Add explain helper or options Created: 30/Mar/22  Updated: 04/Apr/22

Status: Backlog
Project: Drivers
Component/s: None
Fix Version/s: None

Type: New Feature Priority: Minor - P4
Reporter: Benji Rewis (Inactive) Assignee: Unassigned
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Depends
is depended on by GODRIVER-2356 Add support for $explain Closed
Related
is related to DRIVERS-164 Support changes to explain in MongoDB... Closed
Driver Changes: Not Needed

 Description   

Summary

The CRUD spec does not currently outline an explain function or explain options for find / aggregate . The CRUD spec Q/A states

Explain has been determined to be not a normal use-case for a driver. We'd like users to use the shell for this purpose.

We recently got a request in the Go driver to add explain support as exposed API. I'm curious if we still want users to rely on the shell for explain functionality, or whether we'd reconsider adding helpers. I believe Node already supports a similar helper.

Motivation

Users who want to use a driver's API to explain the processes of their queries could do so.

How does this affect the end user?

Running $explain through runCommand or as part of the find filter is a slight pain.

How likely is it that this problem or use case will occur?

From a quick look through Jira, we haven't had a ton of requests for this functionality.

If the problem does occur, what are the consequences and how severe are they?

Minor annoyance at using runCommand or adding your own $explain stage.

Is this issue urgent?

No.

Is this ticket required by a downstream team?

No.

Is this ticket only for tests?

No.


Generated at Thu Feb 08 08:25:07 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.