<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:11:55 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>[DOCS-15065] Rewrite &quot;Perform Long-Running Queries&quot; page to show intended use</title>
                <link>https://jira.mongodb.org/browse/DOCS-15065</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;This page:&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://docs.mongodb.com/manual/tutorial/long-running-queries/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/manual/tutorial/long-running-queries/&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;... shows how we internally implement the driver-server protocol for snapshot reads using the &quot;atClusterTime&quot; parameter. That parameter shouldn&apos;t be documented. Instead, we should show users the session-based driver API for using snapshot reads. Here&apos;s a good example for Python:&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://pymongo.readthedocs.io/en/stable/api/pymongo/client_session.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://pymongo.readthedocs.io/en/stable/api/pymongo/client_session.html&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Snapshot reads are extremely similar to causal consistency. For causal, we don&apos;t document the internal parameter &quot;afterClusterTime&quot;. Instead, we show examples with drivers:&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://docs.mongodb.com/manual/core/read-isolation-consistency-recency/#examples&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/manual/core/read-isolation-consistency-recency/#examples&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;We should do the same for snapshot reads: don&apos;t document &quot;atClusterTime&quot;, show drivers examples instead. We can collect drivers examples using a ticket like &lt;a href=&quot;https://jira.mongodb.org/browse/DRIVERS-547&quot; title=&quot;Causal Consistency Examples for the Manual&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DRIVERS-547&quot;&gt;DRIVERS-547&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;Also, I&apos;d replace the term &quot;snapshot time&quot; with &quot;read timestamp&quot; on that page. E.g., &lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;When MongoDB performs long-running queries using the default read concern of &quot;local&quot;, the read timestamp is subject to change. The read timestamp may move forward as the query runs, and the query may return inconsistent results.&lt;/p&gt;&lt;/blockquote&gt;</description>
                <environment></environment>
        <key id="1970951">DOCS-15065</key>
            <summary>Rewrite &quot;Perform Long-Running Queries&quot; page to show intended use</summary>
                <type id="3" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14718&amp;avatarType=issuetype">Task</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="jeffrey.allen@mongodb.com">Jeffrey Allen</assignee>
                                    <reporter username="jesse@mongodb.com">A. Jesse Jiryu Davis</reporter>
                        <labels>
                    </labels>
                <created>Tue, 25 Jan 2022 23:06:42 +0000</created>
                <updated>Mon, 30 Oct 2023 19:56:54 +0000</updated>
                            <resolved>Fri, 31 Mar 2023 22:04:52 +0000</resolved>
                                                    <fixVersion>Server_Docs_20231030</fixVersion>
                                    <component>manual</component>
                    <component>Server</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>1</watches>
                                                                                                                                                            <comments>
                            <comment id="4418859" author="jmikola@gmail.com" created="Thu, 17 Mar 2022 17:34:32 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=jeffrey.allen&quot; class=&quot;user-hover&quot; rel=&quot;jeffrey.allen&quot;&gt;jeffrey.allen&lt;/a&gt;: I&apos;m not sure if this is the correct place to report this, but I noticed a typo in &lt;a href=&quot;https://docs-mongodbcom-staging.corp.mongodb.com/docs/docsworker-xlarge/DOCS-15065/tutorial/long-running-queries/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs-mongodbcom-staging.corp.mongodb.com/docs/docsworker-xlarge/DOCS-15065/tutorial/long-running-queries/&lt;/a&gt;. A bullet under the first example reads &quot;Performs these actions for each database&quot; but it should likely say &quot;for each collection&quot;.&lt;/p&gt;</comment>
                            <comment id="4346593" author="jeffrey.allen" created="Wed, 9 Feb 2022 22:27:35 +0000"  >&lt;p&gt;Reviews are complete. Moving to Blocked while we wait for driver examples in &lt;a href=&quot;https://jira.mongodb.org/browse/DRIVERS-2181&quot; title=&quot;Snapshot Query Examples for the Manual&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DRIVERS-2181&quot;&gt;DRIVERS-2181&lt;/a&gt;.&lt;/p&gt;</comment>
                            <comment id="4336098" author="jeffrey.allen" created="Fri, 4 Feb 2022 15:32:32 +0000"  >&lt;p&gt;Resuming work to add a second example to this page.&lt;/p&gt;</comment>
                            <comment id="4325340" author="jeffrey.allen" created="Mon, 31 Jan 2022 18:09:33 +0000"  >&lt;p&gt;Moving to &quot;Blocked&quot; while we wait for driver examples. See &lt;a href=&quot;https://jira.mongodb.org/browse/DRIVERS-2181&quot; title=&quot;Snapshot Query Examples for the Manual&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DRIVERS-2181&quot;&gt;DRIVERS-2181&lt;/a&gt;.&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10011">
                    <name>Depends</name>
                                            <outwardlinks description="depends on">
                                        <issuelink>
            <issuekey id="1974315">DRIVERS-2181</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                            <issuelinktype id="10020">
                    <name>Gantt Dependency</name>
                                                                <inwardlinks description="has to be done after">
                                                        </inwardlinks>
                                    </issuelinktype>
                            <issuelinktype id="10520">
                    <name>Problem/Incident</name>
                                                                <inwardlinks description="is caused by">
                                                        </inwardlinks>
                                    </issuelinktype>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                            <outwardlinks description="related to">
                                                        </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                            <subtask id="1977212">DOCS-15090</subtask>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>4.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Mon, 31 Jan 2022 18:09:33 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        1 year, 46 weeks, 6 days ago
    
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_18254" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Dependencies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[<a href='https://jira.mongodb.org/browse/DRIVERS-2181'>DRIVERS-2181</a>]]></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_10857" key="com.pyxis.greenhopper.jira:gh-epic-link">
                        <customfieldname>Epic Link</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>DOCSP-11702</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_10057" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comment by Customer</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>true</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10056" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last commenter</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>emet.ozar@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            1 year, 46 weeks, 6 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>jesse@mongodb.com</customfieldvalue>
            <customfieldvalue>jeffrey.allen@mongodb.com</customfieldvalue>
            <customfieldvalue>jmikola@mongodb.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|i0i28v:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hr2x2n:</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>
                                                                                                                                                                                                                                                                    <customfield id="customfield_10557" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue id="5641">ServerDocs2022: Jan25 - Feb1</customfieldvalue>
    <customfieldvalue id="5841">ServerDocs2022: Apr5 - Apr12</customfieldvalue>
    <customfieldvalue id="5855">ServerDocs2022: Jan18 - Jan25</customfieldvalue>
    <customfieldvalue id="5873">ServerDocs2022: Feb1 - Feb7</customfieldvalue>
    <customfieldvalue id="5947">ServerDocs2022: Feb8 - Feb15</customfieldvalue>
    <customfieldvalue id="5987">ServerDocs2022: Feb22 - Mar01</customfieldvalue>
    <customfieldvalue id="5988">ServerDocs2022: Mar1 - Mar8</customfieldvalue>
    <customfieldvalue id="5989">ServerDocs2022: Mar8 - Mar15</customfieldvalue>
    <customfieldvalue id="6051">ServerDocs2022: Mar15 - Mar22</customfieldvalue>
    <customfieldvalue id="6082">ServerDocs2022: Mar22 - Mar29</customfieldvalue>
    <customfieldvalue id="6083">ServerDocs2022: Mar29 - Apr5</customfieldvalue>
    <customfieldvalue id="6106">ServerDocs2022: Apr12 - Apr19</customfieldvalue>
    <customfieldvalue id="6124">ServerDocs2022: Apr26 - May3</customfieldvalue>
    <customfieldvalue id="6127">ServerDocs2022: Jun1 - Jun14</customfieldvalue>
    <customfieldvalue id="6128">ServerDocs2022: Jun14 - Jun28</customfieldvalue>
    <customfieldvalue id="6138">ServerDocs2022: Apr19 - Apr26</customfieldvalue>
    <customfieldvalue id="6226">ServerDocs2022: May3-May10</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                        <customfield id="customfield_10555" key="com.atlassian.jira.plugin.system.customfieldtypes:float">
                        <customfieldname>Story Points</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>5.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_10053" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time In Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_14350" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>serverRank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|i0hoe7:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                </customfields>
    </item>
</channel>
</rss>