AWS documentdb documentation change

Service: documentdb · 2026-03-31 · Documentation low

File: documentdb/latest/developerguide/split.md

Summary

Added new documentation page for the $split aggregation operator in Amazon DocumentDB, including parameters, MongoDB shell example, and code examples in Node.js and Python

Security assessment

This change adds standard documentation for a database aggregation operator ($split) used for string manipulation. The content focuses on functionality examples and usage patterns without any mention of security vulnerabilities, patches, or security features. The code examples include standard TLS connection parameters but these are routine security best practices already documented elsewhere, not new security documentation.

Diff

diff --git a/documentdb/latest/developerguide/split.md b/documentdb/latest/developerguide/split.md
index 8b1378917..3dc380623 100644
--- a//documentdb/latest/developerguide/split.md
+++ b//documentdb/latest/developerguide/split.md
@@ -0,0 +1 @@
+[](/pdfs/documentdb/latest/developerguide/developerguide.pdf#split "Open PDF")
@@ -1,0 +3,108 @@
+[Documentation](/index.html)[Amazon DocumentDB](/documentdb/index.html)[Developer Guide](what-is.html)
+
+Example (MongoDB Shell)Code examples
+
+# $split
+
+The `$split` aggregation operator in Amazon DocumentDB is used to split a string into an array of substrings, based on a specified delimiter. This can be useful for parsing complex string fields and extracting individual components for further processing.
+
+**Parameters**
+
+  * `string`: The string to be split.
+
+  * `delimiter`: The character or string used to split the input string.
+
+
+
+
+## Example (MongoDB Shell)
+
+In this example, we use `$split` to separate the components of a "Desk" field into an array, making it easier to process the data.
+
+**Create sample documents**
+    
+    
+    db.people.insertMany([
+      { "_id": 1, "Desk": "Düsseldorf-BVV-021" },
+      { "_id": 2, "Desk": "Munich-HGG-32a" },
+      { "_id": 3, "Desk": "Cologne-ayu-892.50" },
+      { "_id": 4, "Desk": "Dortmund-Hop-78" }
+    ]);
+
+**Query example**
+    
+    
+    db.people.aggregate([
+      { $project: { parts: { $split: ["$Desk", "-"] } } }
+    ]);
+
+**Output**
+    
+    
+    { "_id" : 1, "parts" : [ "Düsseldorf", "BVV", "021" ] }
+    { "_id" : 2, "parts" : [ "Munich", "HGG", "32a" ] }
+    { "_id" : 3, "parts" : [ "Cologne", "ayu", "892.50" ] }
+    { "_id" : 4, "parts" : [ "Dortmund", "Hop", "78" ] }
+
+The output of `$split` creates an array that can be used in the application to display the information for the employees.
+
+## Code examples
+
+To view a code example for using the `$split` command, choose the tab for the language that you want to use:
+
+Node.js
+    
+    
+    
+    const { MongoClient } = require('mongodb');
+    
+    async function example() {
+      const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
+      const db = client.db('test');
+      const result = await db.collection('people').aggregate([
+        { $project: { parts: { $split: ['$Desk', '-'] } } }
+      ]).toArray();
+      console.log(result);
+      await client.close();
+    }
+    
+    example();
+
+Python
+    
+    
+    
+    from pymongo import MongoClient
+    
+    def example():
+        client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
+        db = client.test
+        result = list(db.people.aggregate([
+            { '$project': { 'parts': { '$split': ['$Desk', '-'] } } }
+        ]))
+        print(result)
+        client.close()
+    
+    example()
+
+![Warning](https://d1ge0kk1l5kms0.cloudfront.net/images/G/01/webservices/console/warning.png) **Javascript is disabled or is unavailable in your browser.**
+
+To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.
+
+[Document Conventions](/general/latest/gr/docconventions.html)
+
+$sort
+
+$sqrt
+
+Did this page help you? - Yes
+
+Thanks for letting us know we're doing a good job!
+
+If you've got a moment, please tell us what we did right so we can do more of it.
+
+Did this page help you? - No
+
+Thanks for letting us know this page needs work. We're sorry we let you down.
+
+If you've got a moment, please tell us how we can make the documentation better.