Skip to content

Commit 29ec8bc

Browse files
SnehaGundaSnehaGunda
committed
Splitting MongoDB FAQ
1 parent e484510 commit 29ec8bc

File tree

3 files changed

+43
-27
lines changed

3 files changed

+43
-27
lines changed

‎articles/cosmos-db/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -697,6 +697,8 @@
697697
href: mongodb-feature-support-36.md
698698
- name: Wire protocol support (3.2)
699699
href: mongodb-feature-support.md
700+
- name: FAQ
701+
href: mongodb-api-faq.md
700702
- name: How-to guides
701703
items:
702704
- name: Pre-migration guide

‎articles/cosmos-db/faq.md

Lines changed: 0 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -203,32 +203,5 @@ This is limitation of JavaScript. JavaScript uses double-precision floating-poin
203203

204204
Creating permissions by using ResourceTokens is allowed at the container level and its descendants (such as documents, attachments). This implies that trying to create a permission at the database or an account level isn't currently allowed.
205205

206-
## Azure Cosmos DB's API for MongoDB
207-
208-
### What is the Azure Cosmos DB's API for MongoDB?
209-
210-
The Azure Cosmos DB's API for MongoDB is a wire-protocol compatibility layer that allows applications to easily and transparently communicate with the native Azure Cosmos database engine by using existing, community-supported SDKs and drivers for MongoDB. Developers can now use existing MongoDB toolchains and skills to build applications that take advantage of Azure Cosmos DB. Developers benefit from the unique capabilities of Azure Cosmos DB, which include global distribution with multi-master replication, auto-indexing, backup maintenance, financially backed service level agreements (SLAs) etc.
211-
212-
### How do I connect to my database?
213-
214-
The quickest way to connect to a Cosmos database with Azure Cosmos DB's API for MongoDB is to head over to the [Azure portal](https://portal.azure.com). Go to your account and then, on the left navigation menu, click **Quick Start**. Quickstart is the best way to get code snippets to connect to your database.
215-
216-
Azure Cosmos DB enforces strict security requirements and standards. Azure Cosmos DB accounts require authentication and secure communication via TLS, so be sure to use TLSv1.2.
217-
218-
For more information, see [Connect to your Cosmos database with Azure Cosmos DB's API for MongoDB](connect-mongodb-account.md).
219-
220-
### Are there additional error codes that I need to deal with while using Azure Cosmos DB's API for MongoDB?
221-
222-
Along with the common MongoDB error codes, the Azure Cosmos DB's API for MongoDB has its own specific error codes:
223-
224-
| Error | Code | Description | Solution |
225-
|---------------------|-------|--------------|-----------|
226-
| TooManyRequests | 16500 | The total number of request units consumed is more than the provisioned request-unit rate for the container and has been throttled. | Consider scaling the throughput assigned to a container or a set of containers from the Azure portal or retrying again. |
227-
| ExceededMemoryLimit | 16501 | As a multi-tenant service, the operation has gone over the client's memory allotment. | Reduce the scope of the operation through more restrictive query criteria or contact support from the [Azure portal](https://portal.azure.com/?#blade/Microsoft_Azure_Support/HelpAndSupportBlade). <br><br>Example: <em>&nbsp;&nbsp;&nbsp;&nbsp;db.getCollection('users').aggregate([<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{$match: {name: "Andy"}}, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{$sort: {age: -1}}<br>&nbsp;&nbsp;&nbsp;&nbsp;])</em>) |
228-
229-
### Is the Simba driver for MongoDB supported for use with Azure Cosmos DB's API for MongoDB?
230-
231-
Yes, you can use Simba's Mongo ODBC driver with Azure Cosmos DB's API for MongoDB
232-
233206
[azure-portal]: https://portal.azure.com
234207
[query]: sql-api-sql-query.md

‎articles/cosmos-db/mongodb-api-faq.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
title: Frequently asked questions about the Azure Cosmos DB's API for MongoDB
3+
description: Get answers to Frequently asked questions about the Azure Cosmos DB's API for MongoDB
4+
author: SnehaGunda
5+
ms.service: cosmos-db
6+
ms.topic: conceptual
7+
ms.date: 04/28/2020
8+
ms.author: sngun
9+
---
10+
11+
# Frequently asked questions about the Azure Cosmos DB's API for MongoDB
12+
13+
The Azure Cosmos DB's API for MongoDB is a wire-protocol compatibility layer that allows applications to easily and transparently communicate with the native Azure Cosmos database engine by using existing, community-supported SDKs and drivers for MongoDB. Developers can now use existing MongoDB toolchains and skills to build applications that take advantage of Azure Cosmos DB. Developers benefit from the unique capabilities of Azure Cosmos DB, which include global distribution with multi-master replication, auto-indexing, backup maintenance, financially backed service level agreements (SLAs) etc.
14+
15+
## How do I connect to my database?
16+
17+
The quickest way to connect to a Cosmos database with Azure Cosmos DB's API for MongoDB is to head over to the [Azure portal](https://portal.azure.com). Go to your account and then, on the left navigation menu, click **Quick Start**. Quickstart is the best way to get code snippets to connect to your database.
18+
19+
Azure Cosmos DB enforces strict security requirements and standards. Azure Cosmos DB accounts require authentication and secure communication via TLS, so be sure to use TLSv1.2.
20+
21+
For more information, see [Connect to your Cosmos database with Azure Cosmos DB's API for MongoDB](connect-mongodb-account.md).
22+
23+
## Error codes while using Azure Cosmos DB's API for MongoDB?
24+
25+
Along with the common MongoDB error codes, the Azure Cosmos DB's API for MongoDB has its own specific error codes:
26+
27+
| Error | Code | Description | Solution |
28+
|---------------------|-------|--------------|-----------|
29+
| TooManyRequests | 16500 | The total number of request units consumed is more than the provisioned request-unit rate for the container and has been throttled. | Consider scaling the throughput assigned to a container or a set of containers from the Azure portal or retrying again. |
30+
| ExceededMemoryLimit | 16501 | As a multi-tenant service, the operation has gone over the client's memory allotment. | Reduce the scope of the operation through more restrictive query criteria or contact support from the [Azure portal](https://portal.azure.com/?#blade/Microsoft_Azure_Support/HelpAndSupportBlade). <br><br> Example: `db.getCollection('users').aggregate([{$match: {name: "Andy"}}, {$sort: {age: -1}}]))` |
31+
32+
## Supported drivers
33+
34+
### Is the Simba driver for MongoDB supported for use with Azure Cosmos DB's API for MongoDB?
35+
36+
Yes, you can use Simba's Mongo ODBC driver with Azure Cosmos DB's API for MongoDB
37+
38+
## Next steps
39+
40+
* [Build a .NET web app using Azure Cosmos DB's API for MongoDB](create-mongodb-dotnet.md)
41+
* [Create a console app with Java and the MongoDB API in Azure Cosmos DB](create-mongodb-java.md)

0 commit comments

Comments
 (0)