<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 09:00:45 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>MongoDB Jira</title>
    <link>https://jira.mongodb.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.7.1</version>
        <build-number>970001</build-number>
        <build-date>13-04-2023</build-date>
    </build-info>


<item>
            <title>[JAVA-3909] Add explain helpers</title>
                <link>https://jira.mongodb.org/browse/JAVA-3909</link>
                <project id="10006" key="JAVA">Java Driver</project>
                    <description>&lt;p&gt;Add explain helper methods for find and aggregate.&lt;/p&gt;

&lt;p&gt;A helper for explaining a find command is particularly important, as the 3.x driver supported explain via the &lt;tt&gt;$explain&lt;/tt&gt; modifier, which has been removed in 4.0. An explain helper will provide an upgrade path for applications that are relying on explain support via modifiers.&lt;/p&gt;</description>
                <environment></environment>
        <key id="1566882">JAVA-3909</key>
            <summary>Add explain helpers</summary>
                <type id="2" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14711&amp;avatarType=issuetype">New Feature</type>
                                            <priority id="3" iconUrl="https://jira.mongodb.org/images/icons/priorities/major.svg">Major - P3</priority>
                        <status id="6" iconUrl="https://jira.mongodb.org/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="13201">Fixed</resolution>
                                        <assignee username="jeff.yemin@mongodb.com">Jeffrey Yemin</assignee>
                                    <reporter username="jeff.yemin@mongodb.com">Jeffrey Yemin</reporter>
                        <labels>
                    </labels>
                <created>Mon, 14 Dec 2020 01:16:32 +0000</created>
                <updated>Sat, 28 Oct 2023 11:21:31 +0000</updated>
                            <resolved>Wed, 6 Jan 2021 21:11:27 +0000</resolved>
                                                    <fixVersion>4.2.0</fixVersion>
                                    <component>Query Operations</component>
                                        <votes>0</votes>
                                    <watches>2</watches>
                                                                                                                <comments>
                            <comment id="3562350" author="yann.simon.fr@gmail.com" created="Wed, 13 Jan 2021 14:21:37 +0000"  >&lt;blockquote&gt;&lt;p&gt;I am curious though about the circumstances in which you use explain. What sort of program uses it? My expectation is that it&apos;s used during development but not in production, but I&apos;d like to understand more about your use case.&lt;/p&gt;&lt;/blockquote&gt;
&lt;p&gt;You&apos;re right, we don&apos;t use it on production.&lt;/p&gt;

&lt;p&gt;Only when running the application locally or in some test environments, we check if a query is doing a collection scan, and we log it to be able to fix that.&lt;/p&gt;</comment>
                            <comment id="3562224" author="jeff.yemin" created="Wed, 13 Jan 2021 13:04:17 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=yann.simon.fr%40gmail.com&quot; class=&quot;user-hover&quot; rel=&quot;yann.simon.fr@gmail.com&quot;&gt;yann.simon.fr@gmail.com&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;I am curious though about the circumstances in which you use explain.  What sort of program uses it?  My expectation is that it&apos;s used during development but not in production, but I&apos;d like to understand more about your use case. &lt;/p&gt;</comment>
                            <comment id="3562222" author="jeff.yemin" created="Wed, 13 Jan 2021 13:01:15 +0000"  >&lt;p&gt;Hi &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=yann.simon.fr%40gmail.com&quot; class=&quot;user-hover&quot; rel=&quot;yann.simon.fr@gmail.com&quot;&gt;yann.simon.fr@gmail.com&lt;/a&gt;,&lt;/p&gt;

&lt;p&gt;We&apos;re really trying to hold the line on not doing another feature release on the 3.x branch, and adding new methods like this to the public API would require that.  I don&apos;t think explain support is quite enough to warrant it, but if we decide to release 3.13.0 for other reasons we will consider backporting this as well.&lt;/p&gt;</comment>
                            <comment id="3561923" author="yann.simon.fr@gmail.com" created="Wed, 13 Jan 2021 09:34:57 +0000"  >&lt;p&gt;Should we also have this helper in the 3.x driver to ease the upgrade process?&lt;/p&gt;</comment>
                            <comment id="3557437" author="xgen-internal-githook" created="Mon, 11 Jan 2021 14:08:41 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;Jeff Yemin&apos;, &apos;email&apos;: &apos;jeff.yemin@mongodb.com&apos;, &apos;username&apos;: &apos;jyemin&apos;}
&lt;p&gt;Message: Add reference docs for explain of find and aggregate (#626)&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-3909&quot; title=&quot;Add explain helpers&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-3909&quot;&gt;&lt;del&gt;JAVA-3909&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/commit/941dffeab499b6879b868605afffd98440257bb4&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/commit/941dffeab499b6879b868605afffd98440257bb4&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="3551440" author="xgen-internal-githook" created="Wed, 6 Jan 2021 21:03:22 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;Jeff Yemin&apos;, &apos;email&apos;: &apos;jeff.yemin@mongodb.com&apos;, &apos;username&apos;: &apos;jyemin&apos;}
&lt;p&gt;Message: Add Javadoc indicating which server version supports explain&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-3909&quot; title=&quot;Add explain helpers&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-3909&quot;&gt;&lt;del&gt;JAVA-3909&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/commit/277585c99e2ae3b8a96745074ba3f906610f499f&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/commit/277585c99e2ae3b8a96745074ba3f906610f499f&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="3551439" author="xgen-internal-githook" created="Wed, 6 Jan 2021 21:03:17 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;Jeff Yemin&apos;, &apos;email&apos;: &apos;jeff.yemin@mongodb.com&apos;, &apos;username&apos;: &apos;jyemin&apos;}
&lt;p&gt;Message: Fix broken explain tests&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-3909&quot; title=&quot;Add explain helpers&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-3909&quot;&gt;&lt;del&gt;JAVA-3909&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/commit/785d221821175abe927c666afd1a5acc074f9922&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/commit/785d221821175abe927c666afd1a5acc074f9922&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="3550419" author="xgen-internal-githook" created="Wed, 6 Jan 2021 14:15:22 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;Jeff Yemin&apos;, &apos;email&apos;: &apos;jeff.yemin@mongodb.com&apos;, &apos;username&apos;: &apos;jyemin&apos;}
&lt;p&gt;Message: Support explain for aggregate operations (#623)&lt;/p&gt;

&lt;p&gt;Support explain for aggregate using the explain command, &lt;br/&gt;
which started supporting explaining aggregate commands&lt;br/&gt;
in MongoDB 3.6.&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-3909&quot; title=&quot;Add explain helpers&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-3909&quot;&gt;&lt;del&gt;JAVA-3909&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/commit/c814e941d2aa42a084b7b2ac4797e2cb32863b57&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/commit/c814e941d2aa42a084b7b2ac4797e2cb32863b57&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="3549702" author="xgen-internal-githook" created="Tue, 5 Jan 2021 21:11:08 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;Jeff Yemin&apos;, &apos;email&apos;: &apos;jeff.yemin@mongodb.com&apos;, &apos;username&apos;: &apos;jyemin&apos;}
&lt;p&gt;Message: Fix explain tests on older server versions&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-3909&quot; title=&quot;Add explain helpers&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-3909&quot;&gt;&lt;del&gt;JAVA-3909&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/commit/bf685dab270fcf1af26a51e05bbd64690c06abe3&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/commit/bf685dab270fcf1af26a51e05bbd64690c06abe3&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="3549701" author="xgen-internal-githook" created="Tue, 5 Jan 2021 21:11:03 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;Jeff Yemin&apos;, &apos;email&apos;: &apos;jeff.yemin@mongodb.com&apos;, &apos;username&apos;: &apos;jyemin&apos;}
&lt;p&gt;Message: Remove extra whitespace&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-3909&quot; title=&quot;Add explain helpers&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-3909&quot;&gt;&lt;del&gt;JAVA-3909&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/commit/68e05dc8660b853eb16ee3edeefcab7c234b5925&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/commit/68e05dc8660b853eb16ee3edeefcab7c234b5925&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="3548448" author="xgen-internal-githook" created="Tue, 5 Jan 2021 12:35:38 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;name&apos;: &apos;Jeff Yemin&apos;, &apos;email&apos;: &apos;jeff.yemin@mongodb.com&apos;, &apos;username&apos;: &apos;jyemin&apos;}
&lt;p&gt;Message: Support explain for find operations (#620)&lt;/p&gt;

&lt;p&gt;Support is only for server versions 3.2+&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-3909&quot; title=&quot;Add explain helpers&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-3909&quot;&gt;&lt;del&gt;JAVA-3909&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/commit/e12c8e25f7206ea5416f1416e04c5a153a894f3b&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/commit/e12c8e25f7206ea5416f1416e04c5a153a894f3b&lt;/a&gt;&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10320">
                    <name>Documented</name>
                                                                <inwardlinks description="is documented by">
                                                        </inwardlinks>
                                    </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                        <customfield id="customfield_10011" key="com.atlassian.jira.plugin.system.customfieldtypes:radiobuttons">
                        <customfieldname>Backwards Compatibility</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="10011"><![CDATA[Minor Change]]></customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10257" key="com.atlassian.jira.plugin.system.customfieldtypes:radiobuttons">
                        <customfieldname>Documentation Changes</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="10250"><![CDATA[Needed]]></customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hr6tc7:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            </customfields>
    </item>
</channel>
</rss>