<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 07:39:29 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-772] Documentation about what &quot;t&quot; and &quot;i&quot; fields mean in chunk to shard map</title>
                <link>https://jira.mongodb.org/browse/DOCS-772</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;In a sharded cluster, curious what the &quot;t&quot; and &quot;i&quot; stand for. I couldn&apos;t find it... I&apos;m a) curious what it stands for and b) think we should document it.&lt;/p&gt;

&lt;p&gt;If I just can&apos;t find it because i&apos;m looking in the wrong place, let me know - thanks!&lt;/p&gt;

&lt;p&gt;Sample:&lt;br/&gt;
{ &quot;_id&quot; : &lt;/p&gt;
{ $minKey : 1 }
&lt;p&gt; } --&amp;gt;&amp;gt; &lt;/p&gt;
{ &quot;_id&quot; : ObjectId(&quot;4e7bb4745fcc83a843000004&quot;) }
&lt;p&gt; on : rs_14 &lt;/p&gt;
{ &quot;t&quot; : 357000, &quot;i&quot; : 0 }
{ &quot;_id&quot; : ObjectId(&quot;4e7bb4745fcc83a843000004&quot;) }
&lt;p&gt; --&amp;gt;&amp;gt; &lt;/p&gt;
{ &quot;_id&quot; : ObjectId(&quot;4e800098d0eab3b756000003&quot;) }
&lt;p&gt; on : rs_18 &lt;/p&gt;
{ &quot;t&quot; : 355000, &quot;i&quot; : 0 }</description>
                <environment></environment>
        <key id="56868">DOCS-772</key>
            <summary>Documentation about what &quot;t&quot; and &quot;i&quot; fields mean in chunk to shard map</summary>
                <type id="4" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14710&amp;avatarType=issuetype">Improvement</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="2">Won&apos;t Fix</resolution>
                                        <assignee username="-1">Unassigned</assignee>
                                    <reporter username="kevinhanson">Kevin Hanson</reporter>
                        <labels>
                    </labels>
                <created>Mon, 19 Nov 2012 08:17:48 +0000</created>
                <updated>Mon, 26 Nov 2012 22:57:09 +0000</updated>
                            <resolved>Wed, 21 Nov 2012 21:03:43 +0000</resolved>
                                                                        <due></due>
                            <votes>0</votes>
                                    <watches>3</watches>
                                                                                                                <comments>
                            <comment id="196063" author="kevinhanson" created="Wed, 21 Nov 2012 21:09:20 +0000"  >&lt;p&gt;Got it - thanks, Scott. This customer has 30+ nodes in prod and is a pretty advanced user of MongoDB. He just wanted to know what those two fields meant, as we were exploring how chunks were migrating in a training class I was giving. He asked what those two fields meant, and I didn&apos;t know. Now I do.&lt;/p&gt;</comment>
                            <comment id="196058" author="scotthernandez" created="Wed, 21 Nov 2012 21:03:43 +0000"  >&lt;p&gt;...in the sharding chunk metadata this is the version marker where t = major and i = minor ...&lt;/p&gt;

&lt;p&gt;I would suggest you get an engineer to talk to the customer as explaining sharding internals is something for an experienced person to do. While I think that documenting internals is generally a good thing, in this case we don&apos;t need to, nor should, as we will be changing how things work in the very near future.&lt;/p&gt;

&lt;p&gt;We are working on defining how much of internal specs and design docs will be published (and which may become stale over time) and how much will be kept internal. In general most of this is all in jira, and of course all if it is in the code.&lt;/p&gt;</comment>
                            <comment id="196047" author="kevinhanson" created="Wed, 21 Nov 2012 20:40:51 +0000"  >&lt;p&gt;Also, it occurs to me that while your suggestion to take training was great, i didn&apos;t get an explicit definition about exactly what &quot;t&quot; and &quot;i&quot; were. I&apos;m looking to get back to a customer on this. &lt;/p&gt;</comment>
                            <comment id="196044" author="kevinhanson" created="Wed, 21 Nov 2012 20:34:29 +0000"  >&lt;p&gt;Hi Scott,&lt;/p&gt;

&lt;p&gt;Thanks for the suggestion on taking a training course. I looked at all the sharding presos I could find, and I didn&apos;t find one that reference those two specific fields. I also couldn&apos;t find any documentation on this on our website, hence my filing the ticket under &quot;Documentation.&quot; If I&apos;m incorrect, please point me to the right documentation. This was asked by a customer, and I think it would be nice to have this info available to them. Thanks!!!&lt;/p&gt;

&lt;p&gt;-Kevin&lt;/p&gt;</comment>
                            <comment id="196042" author="scotthernandez" created="Wed, 21 Nov 2012 20:30:21 +0000"  >&lt;p&gt;Kevin, I would suggest taking the sharding training to learn how these are used, and how the internals work in more detail.&lt;/p&gt;

&lt;p&gt;A quick summary is that is each chunk is versioned (when they are split or moved) and the max version across a namespace is kept on each member involved in a sharded cluster to invalid caches and make sure queries are not sent, nor data written, to the wrong shards.&lt;/p&gt;</comment>
                            <comment id="196027" author="kevinhanson" created="Wed, 21 Nov 2012 20:08:33 +0000"  >&lt;p&gt;Possible to get a bit more detail on this? Thanks!&lt;/p&gt;</comment>
                            <comment id="194543" author="kevinhanson" created="Tue, 20 Nov 2012 08:15:29 +0000"  >&lt;p&gt;Can I get a bit more clarity on &quot;version marker?&quot; Is it just that if i = 0, it indicates a minor version of MongoDB. And if flipped, it&apos;s a major version. And then if so, what does 355000 in the &quot;t&quot; field indicate? Which ints is it holding?&lt;/p&gt;</comment>
                            <comment id="193884" author="scotthernandez" created="Mon, 19 Nov 2012 17:12:14 +0000"  >&lt;p&gt;This is a Timestamp (type/value) where i = increment (counter) and t = time (sec since epoch UTC), but in the sharding chunk metadata this is the version marker where t = major and i = minor and has nothing to do with the Timestamp type really (except we use it to hold two ints). &lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>8.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Mon, 19 Nov 2012 14:50:06 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        11 years, 13 weeks 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_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>jess.mokrzecki@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            11 years, 13 weeks ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>kevinhanson</customfieldvalue>
            <customfieldvalue>scotthernandez</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hrs77r:</customfieldvalue>

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

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>34139</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|hryiiv:</customfieldvalue>

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