- \n
- rust<\/a>\u00a0installed on your machine<\/li>\n
- An Azure subscription<\/a><\/li>\n
- Azure Cosmos DB account<\/a><\/li>\n
- VS Code<\/a>, Sublime<\/a>, or your favorite code editor<\/li>\n<\/ol>\n
Clone the sample application<\/h3>\n
Clone the sample application from github<\/a> and update the connection string before you run the application.<\/p>\n
1. In your terminal or git bash on windows, run the following command to clone the github repo.<\/p>\n
\u00a0 git clone https:\/\/github.com\/Azure-Samples\/azure-cosmos-db-mongodb-rust-getting-started<\/code><\/p>\n2. Navigate to the sample application directory and build the code to download all the dependencies.\n
\u00a0 cargo build<\/code><\/p>\nNOTE: Do not run the application yet.<\/strong><\/p>\n
Update your connection string<\/h3>\n
Before running the application, replace the connection string in
main.rs<\/code> file.<\/p>\n1. To get the connection string for your Azure Cosmos DB account, navigate to Azure portal and go to your Azure Cosmos DB account.<\/p>\n
2. Click on Connection String in the left navigation menu, and then copy one of the connection strings as shown in the screenshot.<\/p>\n
NOTE: Double check if SSL is enabled (Azure Cosmos DB rejects insecure incoming connections).<\/strong><\/p>\n
![\"Azure](\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/04\/cosmosconnectionstring.png\")
Using Azure portal to find connection strings for Azure Cosmos DB<\/figcaption><\/figure><\/p>\n 3. In the sample application, open the
main.rs<\/code> file insrc\/<\/code> directory and update the connection string (from previous step), database name and collection name as shown in the following code snippet.<\/p>\nhttps:\/\/gist.github.com\/gdhuper\/e4716c7937af606edea273081e4e63b6<\/p>\n
4. Save the
main.rs<\/code> file.<\/p>\nReview the code<\/h3>\n
In this section, we are going to walk through some code snippets to learn how database resources are created in rust code.<\/p>\n
This rust application uses mongodb<\/a> rust driver and bson<\/a> (for serializing\/de-serializing data).<\/p>\n
Connecting the rust application to Azure Cosmos DB<\/h4>\n
The following code snippet (
src\/db.rs<\/code>) connects the rust application to Azure Cosmos DB using the connection string provided.<\/p>\nIn the following code snippet, the struct
MongoClient<\/code> has aconnect<\/code> function that takes a connection string and establishes connection to the Azure Cosmos DB server usingClientOptions<\/code><\/a> and Client<\/a>\u00a0structs from mongodb <\/a>rust driver.<\/p>\nhttps:\/\/gist.github.com\/gdhuper\/06e3d2800c32942630d9342e4930311a<\/p>\n
Optionally, you can specify which database and collection to store\/retrieve documents from in the
src\/main.rs<\/code> file.<\/p>\nhttps:\/\/gist.github.com\/gdhuper\/1a9032b6b43b9b0b900847c051682e86<\/p>\n
Create a document<\/h4>\n
The following code snippets shows how to create a document in the rust application.<\/p>\n
In
main.rs<\/code> initialize aInsertableTask<\/code> struct object with appropriate values.<\/p>\nhttps:\/\/gist.github.com\/gdhuper\/9db249a05e94fd9b91b4ac66b4783d85<\/p>\n
The code that inserts the document in the collection is defined in
src\/db.rs<\/code>. If successfully inserted, the function returns documentId of the new document created in the collection.<\/p>\nhttps:\/\/gist.github.com\/gdhuper\/33596a342212fa9a521ea02ded7d9d1e<\/p>\n
Read a document<\/h4>\n
The following code snippet shows how to read a document from a collection.<\/p>\n
In
main.rs,<\/code>\u00a0specify the key to filter the document on. In the example below, we are retrieving a document that contains the key “title” with value “Pay AmeX bill”.<\/p>\nhttps:\/\/gist.github.com\/gdhuper\/08316053695eed8a65506945f183e3d6<\/p>\n
In
db.rs<\/code>, read function takes a filter and returns the document if matched in the collection.<\/p>\nhttps:\/\/gist.github.com\/gdhuper\/3e3beb133204e9be8066f7a28f9a58c5<\/p>\n
Update a document<\/h4>\n
In
main.rs<\/code>, modify theInsertableTask<\/code> previously created and pass it to the update function.<\/p>\nhttps:\/\/gist.github.com\/gdhuper\/e67cec8623ae0c969cddb1a77fe61f75<\/p>\n
In
db.rs<\/code>, the update function takes a filter (for the document to update) and updated document as arguments. If successfully updated, the function returns count of documents updated.<\/p>\nhttps:\/\/gist.github.com\/gdhuper\/57f5f41433c63b48c131b26b72c83403<\/p>\n
Delete a document<\/h4>\n
In
main.rs<\/code>, specify the filter for the document to delete.<\/p>\nhttps:\/\/gist.github.com\/gdhuper\/347dcd3589bd78ed8ac9ba4dafadf039<\/p>\n
In
db.rs<\/code>, the delete function takes a document filter and returns number of documents deleted.<\/p>\nhttps:\/\/gist.github.com\/gdhuper\/850d0ed468314f183d0d815abcf5ad23<\/p>\n
Run the app<\/h3>\n
1. Ensure that rust is installed and is invokable from the terminal\/command prompt. Run
cargo build<\/code> to verify.\n2. The code inmain.rs<\/code> file runs all CRUD operations one after the other. So to make sure the app successfully inserts a document, comment out the code lines that deletes the document (lines 67-71).<\/strong>\n3. In your terminal\/command prompt, navigate to the root directory of the application whereCargo.toml<\/code> file is and run the following command:<\/p>\ncargo run<\/code><\/p>\nIf successful, the app will log result on the console.<\/p>\n
4. Review your documents in Azure Cosmos DB Data Explorer to ensure if the document was successfully inserted.<\/p>\n
![\"Azure](\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2020\/04\/cosmosdatapreview.png\")
Azure Data Explorer<\/figcaption><\/figure><\/p>\n","protected":false},"excerpt":{"rendered":" Rust is becoming increasingly popular both externally and internally at Microsoft due to its performance and safety, especially safe concurrency. In this tutorial, we are going to be writing a Rust application to perform create, read, update, and delete (CRUD) operations on data using Azure Cosmos DB’s API for MongoDB. Prerequisites: rust\u00a0installed on your machine […]<\/p>\n","protected":false},"author":24831,"featured_media":61,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[15,19],"tags":[963,740,499,940],"class_list":["post-899","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-mongodb-api","category-tips-and-tricks","tag-api-for-mongodb","tag-appdev","tag-azure-cosmos-db","tag-rust"],"acf":[],"blog_post_summary":"
Rust is becoming increasingly popular both externally and internally at Microsoft due to its performance and safety, especially safe concurrency. In this tutorial, we are going to be writing a Rust application to perform create, read, update, and delete (CRUD) operations on data using Azure Cosmos DB’s API for MongoDB. Prerequisites: rust\u00a0installed on your machine […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/posts\/899","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/users\/24831"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/comments?post=899"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/posts\/899\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/media\/61"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/media?parent=899"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/categories?post=899"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/tags?post=899"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- An Azure subscription<\/a><\/li>\n