Merge pull request #2980 from abinav2307/field-update-third-pass-validation

Field update third pass validation

Author: Stacyrch140

articles/cosmos-db/.openpublishing.redirection.cosmos-db.json

@@ -655,6 +655,26 @@
       "redirect_url": "/azure/cosmos-db/mongodb/vcore/operators/date-expression/$year",
       "redirect_document_id": true
     },
+    {
+      "source_path_from_root": "/articles/cosmos-db/mongodb/vcore/operators/field-update/$max.md",
+      "redirect_url": "/azure/cosmos-db/mongodb/vcore/operators/accumulators/$max",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/cosmos-db/mongodb/vcore/operators/field-update/$min.md",
+      "redirect_url": "/azure/cosmos-db/mongodb/vcore/operators/accumulators/$min",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/cosmos-db/mongodb/vcore/operators/field-update/$set.md",
+      "redirect_url": "/azure/cosmos-db/mongodb/vcore/operators/aggregation/$set",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/cosmos-db/mongodb/vcore/operators/field-update/$unset.md",
+      "redirect_url": "/azure/cosmos-db/mongodb/vcore/operators/aggregation/$unset",
+      "redirect_document_id": true
+    },
     {
       "source_path_from_root": "/articles/cosmos-db/nosql/troubleshoot-dot-net-sdk-request-timeout.md",
       "redirect_url": "/azure/cosmos-db/nosql/troubleshoot-dotnet-sdk-request-timeout",

articles/cosmos-db/mongodb/vcore/operators/accumulators/$max.md

@@ -12,18 +12,41 @@ ms.date: 01/05/2025
 
 # $max
 
-The `$max` operator returns the maximum value of a set of input values. The max operator is particularly useful in identifying the highest value in a dataset, such as maximum sales, discounts, and other numerical comparisons.
+The `$max` operator returns the maximum value of a set of input values. 
+
+When used as a field update operator, the `$max` operator updates the value of a field to a specified value if the specified value is greater than the current value of the field. If the field does not exist, `$max` creates the field and sets it to the specified value.
 
 ## Syntax
+
 ```javascript
 $max: <expression>
 ```
 
+When used as a field update operator:
+
+```javascript
+{
+  $max: {
+    <field1>: <value1>,
+    <field2>: <value2>,
+    ...
+  }
+}
+```
+
+
 ## Parameters  
 | Parameter | Description |
 | --- | --- |
 | **`<expression>`** | Any valid expression that resolves to a value. The `$max` operator evaluates this expression to determine the maximum value. |
 
+When used as a field update operator:
+
+| Parameter | Description |
+| --- | --- |
+| **`field`** | The name of the field to update with the maximum value. |
+| **`value`** | The value to compare with the current field value. The field will be updated only if this value is larger. |
+
 ## Examples
 
 Consider this sample document from the stores collection.
@@ -289,6 +312,129 @@ The first three results returned by this query are:
 ]
 ```
 
+### Example 4: Setting maximum staff capacity (field update operator)
+
+To update the full time staff to 10 only if the current full time staff count is lower, use the $max operator on the field to perform the update. Since the current `fullTime` value is 3, and 10 is greater than 3, the field will be updated to 10.
+
+```javascript
+db.stores.updateOne(
+  { "_id": "f2a8c190-28e4-4e14-9d8b-0256e53dca66" },
+  {
+    $max: {
+      "staff.totalStaff.fullTime": 10
+    }
+  }
+)
+```
+
+### Example 5: Multiple field updates (field update operator)
+
+To update multiple fields with maximum values, use the $max operator with multiple fields and their corresponding max values to set.
+
+```javascript
+db.stores.updateOne(
+  { "_id": "f2a8c190-28e4-4e14-9d8b-0256e53dca66" },
+  {
+    $max: {
+      "staff.totalStaff.partTime": 1,
+      "sales.totalSales": 50000
+    }
+  }
+)
+```
+
+In this case:
+- `partTime` (2) will remain 2 since 1 < 2 (no change)
+- `totalSales` (31211) will be updated to 50000 since 50000 > 31211
+
+### Example 6: Creating new fields (field update operator)
+
+If a field doesn't exist, `$max` creates it with the specified value.
+
+```javascript
+db.stores.updateOne(
+  { "_id": "f2a8c190-28e4-4e14-9d8b-0256e53dca66" },
+  {
+    $max: {
+      "staff.maxStaffCapacity": 25,
+      "sales.peakSalesRecord": 100000
+    }
+  }
+)
+```
+
+### Example 7: Updating array elements (field update operator)
+
+Update maximum values within array elements using positional operators.
+
+```javascript
+db.stores.updateOne(
+  {
+    "_id": "f2a8c190-28e4-4e14-9d8b-0256e53dca66",
+    "sales.salesByCategory.categoryName": "Phone Mounts"
+  },
+  {
+    $max: {
+      "sales.salesByCategory.$.totalSales": 12000
+    }
+  }
+)
+```
+
+### Example 8: Tracking peak performance (field update operator)
+
+Set peak performance metrics that only update when exceeded.
+
+```javascript
+db.stores.updateOne(
+  { "_id": "f2a8c190-28e4-4e14-9d8b-0256e53dca66" },
+  {
+    $max: {
+      "performance.peakDailySales": 5000,
+      "performance.maxCustomersPerDay": 150,
+      "performance.highestSalesMonth": 45000
+    }
+  }
+)
+```
+
+After these field update operations, the updated document is:
+
+```json
+{
+  "_id": "f2a8c190-28e4-4e14-9d8b-0256e53dca66",
+  "name": "Fabrikam, Inc. | Car Accessory Outlet - West Adele",
+  "staff": {
+    "totalStaff": {
+      "fullTime": 10,
+      "partTime": 2
+    },
+    "maxStaffCapacity": 25
+  },
+  "sales": {
+    "totalSales": 50000,
+    "peakSalesRecord": 100000,
+    "salesByCategory": [
+      {
+        "categoryName": "Phone Mounts",
+        "totalSales": 12000
+      },
+      {
+        "categoryName": "Dash Cameras",
+        "totalSales": 22300
+      }
+    ]
+  },
+  "performance": {
+    "peakDailySales": 5000,
+    "maxCustomersPerDay": 150,
+    "highestSalesMonth": 45000
+  },
+  "lastPromotionDate": ISODate("2024-12-31T00:00:00.000Z"),
+  "inventoryDeadline": ISODate("2024-06-30T00:00:00.000Z")
+}
+```
+
 ## Related content
 
 [!INCLUDE[Related content](../includes/related-content.md)]

articles/cosmos-db/mongodb/vcore/operators/accumulators/$min.md

@@ -14,6 +14,8 @@ ms.date: 01/05/2025
 
 The `$min` operator is used within aggregation stages like `$group`, `$bucket`, `$bucketAuto`, or `$setWindowFields`. The min operator is particularly useful in summarizing data or finding the smallest value in a dataset.
 
+When used as a field update operator, `$min` operator updates the value of a field to a specified value if the specified value is less than the current value of the field. If the field does not exist, `$min` creates the field and sets it to the specified value.
+
 ## Syntax
 
 ```javascript
@@ -22,12 +24,31 @@ $min: <expression>
 
 The `<expression>` can be a field path or an aggregation expression that specifies the values to be considered for the minimum calculation.
 
+As a field update operator:
+
+```javascript
+{
+  $min: {
+    <field1>: <value1>,
+    <field2>: <value2>,
+    ...
+  }
+}
+```
+
 ## Parameters  
 
 | Parameter | Description |
 | --- | --- |
 | **`<expression>`** | Specifies the field or computed value to determine the minimum value. |
 
+As a field update operator:
+
+| Parameter | Description |
+| --- | --- |
+| **`field`** | The name of the field to update with the minimum value. |
+| **`value`** | The value to compare with the current field value. The field will be updated only if this value is smaller. |
+
 ## Examples
 
 Consider this sample document from the stores collection.
@@ -350,6 +371,123 @@ This query returns the following results.
 ]
 ```
 
+### Example 4: Setting minimum staff requirements (field update operator)
+
+To set a minimum staff requirement, update the full time stagg count only if the current value of the field is higher. Since the current `fullTime` value is 14, and 10 is less than 14, the field will be updated to 10.
+
+```javascript
+db.stores.updateOne(
+  { "_id": "26afb024-53c7-4e94-988c-5eede72277d5" },
+  {
+    $min: {
+      "staff.totalStaff.fullTime": 10
+    }
+  }
+)
+```
+
+### Example 5: Multiple field updates (field update operator)
+
+To update multiple fields with minimum values simultaneously, use the $min operator with multiple fields and corresponding min values.
+
+```javascript
+db.stores.updateOne(
+  { "_id": "26afb024-53c7-4e94-988c-5eede72277d5" },
+  {
+    $min: {
+      "staff.totalStaff.partTime": 12,
+      "sales.totalSales": 50000
+    }
+  }
+)
+```
+
+In this case:
+- `partTime` (8) will be updated to 8 since 12 > 8 (no change)
+- `totalSales` (83865) will be updated to 50000 since 50000 < 83865
+
+### Example 6: Creating new fields (field update operator)
+
+If a field doesn't exist, `$min` creates it with the specified value.
+
+```javascript
+db.stores.updateOne(
+  { "_id": "26afb024-53c7-4e94-988c-5eede72277d5" },
+  {
+    $min: {
+      "staff.minStaffRequired": 15,
+      "sales.minimumSalesTarget": 30000
+    }
+  }
+)
+```
+
+### Example 7: Working with Dates (field update operator)
+
+Set minimum dates for tracking earliest events.
+
+```javascript
+db.stores.updateOne(
+  { "_id": "26afb024-53c7-4e94-988c-5eede72277d5" },
+  {
+    $min: {
+      "lastInventoryCheck": new Date("2024-01-15"),
+      "firstSaleDate": new Date("2023-06-01")
+    }
+  }
+)
+```
+
+### Example 8: Updating array elements (field update operator)
+
+Update minimum values within array elements using positional operators.
+
+```javascript
+db.stores.updateOne(
+  {
+    "_id": "26afb024-53c7-4e94-988c-5eede72277d5",
+    "sales.salesByCategory.categoryName": "Lavalier Microphones"
+  },
+  {
+    $min: {
+      "sales.salesByCategory.$.totalSales": 40000
+    }
+  }
+)
+```
+
+After these field update operations, the updated document is:
+
+```json
+{
+  "_id": "26afb024-53c7-4e94-988c-5eede72277d5",
+  "name": "First Up Consultants | Microphone Bazaar - South Lexusland",
+  "staff": {
+    "totalStaff": {
+      "fullTime": 10,
+      "partTime": 8
+    },
+    "minStaffRequired": 15
+  },
+  "sales": {
+    "totalSales": 50000,
+    "minimumSalesTarget": 30000,
+    "salesByCategory": [
+      {
+        "categoryName": "Lavalier Microphones",
+        "totalSales": 40000
+      },
+      {
+        "categoryName": "Wireless Microphones",
+        "totalSales": 39691
+      }
+    ]
+  },
+  "lastInventoryCheck": ISODate("2024-01-15T00:00:00.000Z"),
+  "firstSaleDate": ISODate("2023-06-01T00:00:00.000Z")
+}
+```
+
 ## Related content
 
 [!INCLUDE[Related content](../includes/related-content.md)]