AWS documentdb documentation change
Summary
Added new documentation page for the $toLower operator in Amazon DocumentDB, including syntax, parameters, examples in MongoDB Shell, Node.js, and Python with connection examples.
Security assessment
This change adds routine documentation for a string manipulation operator ($toLower). The code examples include standard TLS connection parameters (tls=true, tlsCAFile) which are security best practices for DocumentDB connections, but this is standard documentation for a non-security feature. No evidence of addressing a specific security vulnerability or incident.
Diff
diff --git a/documentdb/latest/developerguide/toLower.md b/documentdb/latest/developerguide/toLower.md index 8b1378917..a0bef96fa 100644 --- a//documentdb/latest/developerguide/toLower.md +++ b//documentdb/latest/developerguide/toLower.md @@ -0,0 +1 @@ +[](/pdfs/documentdb/latest/developerguide/developerguide.pdf#toLower "Open PDF") @@ -1,0 +3,109 @@ +[Documentation](/index.html)[Amazon DocumentDB](/documentdb/index.html)[Developer Guide](what-is.html) + +Example (MongoDB Shell)Code examples + +# $toLower + +The `$toLower` operator in Amazon DocumentDB is used to convert a string to lowercase. + +**Parameters** + + * `expression`: The string expression to convert to lowercase. + + + + +## Example (MongoDB Shell) + +The following example demonstrates how to use the `$toLower` operator to convert the `Desk` field to lowercase. + +**Create sample documents** + + + db.locations.insertMany([ + { "_id": 1, "Desk": "Düsseldorf-BVV-021" }, + { "_id": 2, "Desk": "Munich-HGG-32a" } + ]); + +**Query example** + + + db.locations.aggregate([ + { $project: { item: { $toLower: "$Desk" } } } + ]); + +**Output** + + + { "_id" : 1, "item" : "düsseldorf-bvv-021" } + { "_id" : 2, "item" : "munich-hgg-32a" } + +## Code examples + +To view a code example for using the `$toLower` command, choose the tab for the language that you want to use: + +Node.js + + + + const { MongoClient } = require("mongodb"); + + async function main() { + 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 collection = db.collection("locations"); + + const result = await collection.aggregate([ + { $project: { item: { $toLower: "$Desk" } } } + ]).toArray(); + + console.log(result); + + await client.close(); + } + + main(); + +Python + + + + from pymongo import MongoClient + + def main(): + client = MongoClient("mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false") + db = client["test"] + collection = db["locations"] + + result = list(collection.aggregate([ + { "$project": { "item": { "$toLower": "$Desk" } } } + ])) + + print(result) + + client.close() + + if __name__ == "__main__": + main() + + **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) + +$toLong + +$toObjectId + +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.