Uploaded image for project: 'Documentation'
  1. Documentation
  2. DOCS-11201

Docs for SERVER-32173: Add deprecation warning to "snapshot" option on queries

    • Type: Icon: Task Task
    • Resolution: Fixed
    • Priority: Icon: Major - P3 Major - P3
    • 3.7.1, 3.6.1
    • Affects Version/s: None
    • Component/s: None
    • Labels:
      None

      Documentation Request Summary:

      This change causes the server to log the following warning message:

      The snapshot option is deprecated. See http://dochub.mongodb.org/core/snapshot-deprecation

      This dochub link currently points to https://docs.mongodb.com/manual/release-notes/3.6-compatibility/#general-compatibility-changes. It should be changed to point specifically to a note about snapshot's deprecation.

      As part of this note, we should explain how users should migrate their application off the deprecated option. Those users who are on MMAPv1 should instead issue a hint on the _id index. Users on other storage engines should issue a $natural hint. Under the hood, snapshot was simply implemented as one of these two hints, which results in a plan that will never return the same document twice. Therefore, issuing a hint directly should achieve the same effect.

      This option is being deprecated because it never offered true snapshot isolation.

      Engineering Ticket Description:

      The old snapshot option is being deprecated, need to add warning to the logs.

            Assignee:
            kay.kim@mongodb.com Kay Kim (Inactive)
            Reporter:
            kay.kim@mongodb.com Kay Kim (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved:
              5 years, 46 weeks, 6 days ago