Skip to content

DOCS-877 cleanup of faq snapshot and tutorial cursor info #466

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Dec 12, 2012
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions source/faq/developers.txt
Original file line number Diff line number Diff line change
Expand Up @@ -549,12 +549,12 @@ the data returned by the query will reflect a single moment in time

.. warning::

You **cannot** use :method:`snapshot() <cursor.snapshot()>` with
:term:`sharded collections <sharding>`.
- You **cannot** use :method:`snapshot() <cursor.snapshot()>` with
:term:`sharded collections <sharding>`.

You **cannot** use :method:`snapshot() <cursor.snapshot()>` with
:method:`sort() <cursor.sort()>` or :method:`hint()
<cursor.hint()>` cursor methods.
- You **cannot** use :method:`snapshot() <cursor.snapshot()>` with
:method:`sort() <cursor.sort()>` or :method:`hint()
<cursor.hint()>` cursor methods.


As an alternative, if your collection has a field or fields that are
Expand All @@ -571,6 +571,6 @@ explicitly force the query to use that index.
query; then the cursor will return the same document more than
once.

.. [#id-is-immutable] MongoDB does permit changes to the value of the
``_id`` field, it is not possible for a cursor that transverses
.. [#id-is-immutable] MongoDB does not permit changes to the value of the
``_id`` field; it is not possible for a cursor that transverses
this index to pass the same document more than once.
16 changes: 8 additions & 8 deletions source/tutorial/getting-started.txt
Original file line number Diff line number Diff line change
Expand Up @@ -344,14 +344,14 @@ the following procedure:

{ "_id" : ObjectId("4c220a42f3924d31102bd858"), "x" : 4, "j" : 3 }

When you access documents in a cursor using on its indexed position
in an array, :program:`mongo` must iterate all documents with lower
index values.

For example, if you access the document at ``c[4]``,
:program:`mongo` must load and iterate through the documents at
``c[0]`` through ``c[3]`` in addition to ``c[4]``. For very large
result sets, :program:`mongo` may run out of available memory.
When you access documents in a cursor using the array index
notation, :program:`mongo` first calls the ``cursor.toArray()``
method and loads into RAM all documents returned by the cursor. The
index is then applied to the resulting array. This operation
iterates the cursor completely and exhausts the cursor.

For very large result sets, :program:`mongo` may run out of
available memory.

For more information on the cursor, see :ref:`crud-read-cursor`.

Expand Down