<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:03:07 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-11561] Docs for SERVER-33818: Add &apos;startAtOperationTime&apos; as an option in $changeStream</title>
                <link>https://jira.mongodb.org/browse/DOCS-11561</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;h1&gt;&lt;a name=&quot;DocumentationRequestSummary%3A&quot;&gt;&lt;/a&gt;Documentation Request Summary: &lt;/h1&gt;

&lt;p&gt;No documentation summary in engineering ticket&lt;/p&gt;

&lt;h1&gt;&lt;a name=&quot;EngineeringTicketDescription%3A&quot;&gt;&lt;/a&gt;Engineering Ticket Description:&lt;/h1&gt;

&lt;p&gt;This will make it more clear that we support this option.&lt;/p&gt;</description>
                <environment></environment>
        <key id="524170">DOCS-11561</key>
            <summary>Docs for SERVER-33818: Add &apos;startAtOperationTime&apos; as an option in $changeStream</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="kay.kim@mongodb.com">Kay Kim</assignee>
                                    <reporter username="kay.kim@mongodb.com">Kay Kim</reporter>
                        <labels>
                    </labels>
                <created>Mon, 9 Apr 2018 15:32:23 +0000</created>
                <updated>Sun, 29 Oct 2023 13:58:04 +0000</updated>
                            <resolved>Sun, 24 Jun 2018 17:32:56 +0000</resolved>
                                                    <fixVersion>3.7.4</fixVersion>
                                        <due></due>
                            <votes>0</votes>
                                    <watches>5</watches>
                                                                                                                <comments>
                            <comment id="1929900" author="xgen-internal-githook" created="Sun, 24 Jun 2018 17:29:59 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;username&apos;: &apos;kay-kim&apos;, &apos;name&apos;: &apos;kay&apos;, &apos;email&apos;: &apos;kay.kim@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-11561&quot; title=&quot;Docs for SERVER-33818: Add &amp;#39;startAtOperationTime&amp;#39; as an option in $changeStream&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-11561&quot;&gt;&lt;del&gt;DOCS-11561&lt;/del&gt;&lt;/a&gt;,&lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-11760&quot; title=&quot;Docs for SERVER-34314: Ensure change stream can resume between entries in applyOps entry&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-11760&quot;&gt;&lt;del&gt;DOCS-11760&lt;/del&gt;&lt;/a&gt;: startAtOperationTime, ``txnNumber`` and the ``lsid`` fields&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/62e8fee82f48037778f557ecd5975873dff4f799&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/62e8fee82f48037778f557ecd5975873dff4f799&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1906796" author="ian@10gen.com" created="Thu, 31 May 2018 15:29:12 +0000"  >&lt;p&gt;just a note that we changed the summary to &quot;Add &apos;startAtOperationTime&apos; as an option in $changeStream&quot;&lt;/p&gt;</comment>
                            <comment id="1862802" author="charlie.swanson" created="Thu, 12 Apr 2018 18:29:46 +0000"  >&lt;p&gt;You cannot use both of them at once - sorry if my wording was unclear. When I say &quot;just&quot; the cluster time, I mean that a resume token includes the cluster time, so a resume token is strictly more specific than a clusterTime.&lt;/p&gt;</comment>
                            <comment id="1862793" author="ravind.kumar" created="Thu, 12 Apr 2018 18:20:43 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=charlie.swanson&quot; class=&quot;user-hover&quot; rel=&quot;charlie.swanson&quot;&gt;charlie.swanson&lt;/a&gt; is that to say you can specify this option &lt;em&gt;without&lt;/em&gt; a resume token? Can it also be used &lt;em&gt;with&lt;/em&gt; a resume token? Or are the two options mutually exclusive. &lt;/p&gt;</comment>
                            <comment id="1862786" author="charlie.swanson" created="Thu, 12 Apr 2018 18:16:32 +0000"  >&lt;p&gt;Agreed, we should not encourage usages of this. But I think we should certainly document that it&apos;s useful if you want to be able to resume your stream before any changes are seen. I would also like if we included some wording and warning about how if you just use the cluster time, there may be multiple things that happened at that cluster time in a sharded cluster, so you could get duplicate entries.&lt;/p&gt;</comment>
                            <comment id="1861933" author="nicholas.zolnierz" created="Wed, 11 Apr 2018 20:44:32 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=ravind.kumar&quot; class=&quot;user-hover&quot; rel=&quot;ravind.kumar&quot;&gt;ravind.kumar&lt;/a&gt; your understanding is mostly correct, except the format is the &lt;a href=&quot;https://docs.mongodb.com/manual/reference/bson-types/#document-bson-type-timestamp&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;internal BSON timestamp&lt;/a&gt;, which is included in the response of some (most?) commands. The basic use case for the drivers is specified nicely in the design doc, I&apos;ll paste it here for reference:&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;Obtain a cluster time from the cluster. Any command (e.g. ismaster) will return the cluster time in the $clusterTime field.&lt;/li&gt;
	&lt;li&gt;Start all change streams with a &apos;startAtClusterTime&apos;, and remember that time.&lt;/li&gt;
	&lt;li&gt;As soon as the first change (with the first resume token) is returned, they no longer have to track that time, instead remembering the resume token as they do today.&lt;/li&gt;
	&lt;li&gt;If there is an error before the first change, they should resume with &apos;startAtClusterTime&apos; and the original cluster time. If there is an error after the first change, they should resume with &apos;resumeAfter&apos; and the resume token.&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;If I understand correctly, I don&apos;t think we want to advise end users to use this interface directly but instead to use a resume token if possible. &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=charlie.swanson&quot; class=&quot;user-hover&quot; rel=&quot;charlie.swanson&quot;&gt;charlie.swanson&lt;/a&gt; do you agree?&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10320">
                    <name>Documented</name>
                                            <outwardlinks description="documents">
                                        <issuelink>
            <issuekey id="509856">SERVER-33818</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                            <issuelinktype id="10010">
                    <name>Duplicate</name>
                                                                <inwardlinks description="is duplicated by">
                                        <issuelink>
            <issuekey id="545733">DOCS-11715</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                                                <inwardlinks description="is related to">
                                        <issuelink>
            <issuekey id="527459">DOCS-11616</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="545733">DOCS-11715</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>6.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Wed, 11 Apr 2018 20:22:44 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        5 years, 33 weeks, 3 days ago
    
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_18254" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Dependencies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[]]></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>DOCS-11003</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>luke.bonanomi@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            5 years, 33 weeks, 3 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>charlie.swanson@mongodb.com</customfieldvalue>
            <customfieldvalue>xgen-internal-githook</customfieldvalue>
            <customfieldvalue>ian@mongodb.com</customfieldvalue>
            <customfieldvalue>kay.kim@mongodb.com</customfieldvalue>
            <customfieldvalue>nicholas.zolnierz@mongodb.com</customfieldvalue>
            <customfieldvalue>ravind.kumar</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|htuqvb:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|htly9j:</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_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|htud3j:</customfieldvalue>

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