<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:01:33 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-10863] Unclear documentation on use of reserved words in MongoDB shell</title>
                <link>https://jira.mongodb.org/browse/DOCS-10863</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;There doesn&apos;t appear to be any documentation on the use of restricted words in collection names in the MongoDB shell, including some commonly used words.&lt;/p&gt;

&lt;p&gt;Example keywords that might be commonly used for collections:&lt;/p&gt;
&lt;div class=&quot;panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;panelContent&quot;&gt;
&lt;p&gt;group&lt;br/&gt;
auth&lt;br/&gt;
stats&lt;br/&gt;
version&lt;br/&gt;
password&lt;br/&gt;
prototype&lt;/p&gt;
&lt;/div&gt;&lt;/div&gt;


&lt;p&gt;When attempting, e.g. an insert into &lt;b&gt;db.stats&lt;/b&gt; the error&lt;br/&gt;
&lt;tt&gt;&lt;b&gt;db.stats.insert is not a function&lt;/b&gt;&lt;/tt&gt; is returned&lt;/p&gt;</description>
                <environment></environment>
        <key id="439938">DOCS-10863</key>
            <summary>Unclear documentation on use of reserved words in MongoDB shell</summary>
                <type id="3" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14718&amp;avatarType=issuetype">Task</type>
                                            <priority id="4" iconUrl="https://jira.mongodb.org/images/icons/priorities/minor.svg">Minor - P4</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="stephen.steneker@mongodb.com">Stennie Steneker</assignee>
                                    <reporter username="steffan.mejia@mongodb.com">Steffan Mejia</reporter>
                        <labels>
                    </labels>
                <created>Wed, 4 Oct 2017 01:45:12 +0000</created>
                <updated>Mon, 30 Oct 2023 22:23:10 +0000</updated>
                            <resolved>Fri, 13 Oct 2017 05:17:11 +0000</resolved>
                                                    <fixVersion>Server_Docs_20231030</fixVersion>
                                    <component>tools</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>2</watches>
                                                                                                                <comments>
                            <comment id="1697965" author="xgen-internal-githook" created="Fri, 13 Oct 2017 03:43:15 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;email&apos;: &apos;stennie@cpan.org&apos;, &apos;name&apos;: &apos;Stephen Steneker&apos;, &apos;username&apos;: &apos;stennie&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-10863&quot; title=&quot;Unclear documentation on use of reserved words in MongoDB shell&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-10863&quot;&gt;&lt;del&gt;DOCS-10863&lt;/del&gt;&lt;/a&gt;: Improve documentation on use of reserved words in MongoDB shell&lt;br/&gt;
Branch: v3.4&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/52e5ac62037c61c2df0eaf9dbec083c0900a5d7c&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/52e5ac62037c61c2df0eaf9dbec083c0900a5d7c&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1697964" author="xgen-internal-githook" created="Fri, 13 Oct 2017 03:42:59 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{&apos;email&apos;: &apos;stennie@cpan.org&apos;, &apos;name&apos;: &apos;Stephen Steneker&apos;, &apos;username&apos;: &apos;stennie&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-10863&quot; title=&quot;Unclear documentation on use of reserved words in MongoDB shell&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-10863&quot;&gt;&lt;del&gt;DOCS-10863&lt;/del&gt;&lt;/a&gt;: Improve documentation on use of reserved words in MongoDB shell&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/08a59721fbc3294ae5be451dc7964e0755262f95&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/08a59721fbc3294ae5be451dc7964e0755262f95&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1688962" author="steffan.mejia" created="Wed, 4 Oct 2017 14:59:32 +0000"  >&lt;p&gt;I suggest the mongo shell introduction: &lt;a href=&quot;https://docs.mongodb.com/manual/mongo/#working-with-the-mongo-shell&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/manual/mongo/#working-with-the-mongo-shell&lt;/a&gt; be amended:&lt;/p&gt;


&lt;div class=&quot;panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;panelHeader&quot; style=&quot;border-bottom-width: 1px;&quot;&gt;&lt;b&gt;Original&lt;/b&gt;&lt;/div&gt;&lt;div class=&quot;panelContent&quot;&gt;
&lt;p&gt;If the mongo shell does not accept the name of the collection, for instance if the name contains a space, hyphen, or starts with a number, you can use an alternate syntax to refer to the collection, as in the following&lt;/p&gt;
&lt;/div&gt;&lt;/div&gt;

&lt;p&gt;to&lt;/p&gt;

&lt;div class=&quot;panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;panelHeader&quot; style=&quot;border-bottom-width: 1px;&quot;&gt;&lt;b&gt;Suggested&lt;/b&gt;&lt;/div&gt;&lt;div class=&quot;panelContent&quot;&gt;
&lt;p&gt;If the mongo shell does not accept the name of the collection, for instance if the name contains a space, hyphen, &lt;b&gt;conflicts with a built-in function,&lt;/b&gt; or starts with a number, you can use an alternate syntax to refer to the collection, as in the following&lt;/p&gt;
&lt;/div&gt;&lt;/div&gt;</comment>
                            <comment id="1688919" author="stennie" created="Wed, 4 Oct 2017 14:39:20 +0000"  >&lt;p&gt;These names aren&apos;t actually restricted from use, but conflicts with built-in &lt;tt&gt;mongo&lt;/tt&gt; shell helpers/functions will make them less intuitively accessible. There is a reasonably long list but most functions use camel case so are less likely to conflict. You can preview by doing &lt;tt&gt;db.&amp;lt;tab&amp;gt;&amp;lt;tab&amp;gt;&lt;/tt&gt; to autocomplete top-level functions for the &lt;tt&gt;db&lt;/tt&gt; object in an database without any collections.&lt;/p&gt;

&lt;p&gt;If you want to avoid internal name clashes or use collection names that aren&apos;t valid JavaScript identifiers (i.e. those with an embedded space/hyphen or leading digit) there is a &lt;tt&gt;db.getCollection()&lt;/tt&gt; shell helper: &lt;a href=&quot;https://docs.mongodb.com/manual/reference/method/db.getCollection/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/manual/reference/method/db.getCollection/&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;This is also mentioned in the &lt;tt&gt;mongo&lt;/tt&gt; shell introduction: &lt;a href=&quot;https://docs.mongodb.com/manual/mongo/#working-with-the-mongo-shell&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/manual/mongo/#working-with-the-mongo-shell&lt;/a&gt;.&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>4.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Wed, 4 Oct 2017 14:39:20 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        6 years, 17 weeks, 6 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_10040" key="com.atlassian.jira.plugin.system.customfieldtypes:select">
                        <customfieldname>Estimate</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="10042"><![CDATA[Small]]></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>
                            6 years, 17 weeks, 6 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>xgen-internal-githook</customfieldvalue>
            <customfieldvalue>steffan.mejia@mongodb.com</customfieldvalue>
            <customfieldvalue>stephen.steneker@mongodb.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|htgxfj:</customfieldvalue>

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

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