[DOCS-10521] Docs for SERVER-29912: $pop update modifier should validate that its argument is either 1 or -1 Created: 13/Jul/17  Updated: 29/Oct/23  Resolved: 27/Jul/17

Status: Closed
Project: Documentation
Component/s: Server
Affects Version/s: None
Fix Version/s: 3.5.10

Type: Task Priority: Major - P3
Reporter: Emily Hall Assignee: Kay Kim (Inactive)
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Documented
documents SERVER-29912 $pop update modifier should validate ... Closed
Participants:
Days since reply: 6 years, 28 weeks, 6 days ago
Epic Link: DOCS: 3.6 Server

 Description   

Documentation Request Summary:

We need to document this minor breaking change in the compatibility notes for 3.6. The title and description of this ticket should be self-explanatory but please reach out to me with any questions.

Engineering Ticket Description:

In 3.6.x versions, the argument to the $pop mode will be validated more strictly once the featureCompatibilityVersion is set to "3.6".

Old behavior

The past behavior was that any BSON element was allowed in place of elt below:

db.collection.update({}, {$pop: {"array": <elt>}});

If <elt> was numeric and less than zero, then the $pop would remove the first element of the array. On the other hand, if <elt> was any non-numeric type or was a number greater than or equal to zero, $pop would remove the last element of the array.

New behavior

$pop will now fail at parse time if elt is either a non-numeric type, or is a number which is not equal to 1 or -1. All numeric BSON types are allowed (NumberInt, NumberLong, NumberDouble, NumberDecimal), but if the number is not an exact representation of 1 or -1, then $pop will fail to parse.



 Comments   
Comment by Githook User [ 27/Jul/17 ]

Author:

{'email': 'kay.kim@10gen.com', 'username': 'kay-kim', 'name': 'kay'}

Message: DOCS-10521 pop restricted to 1 or -1
Branch: master
https://github.com/mongodb/docs/commit/8f22733a4ceac639e2fd3d32dd7dc82e824aabff

Generated at Thu Feb 08 08:00:45 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.