---
title: "Connect using Python for Public Cloud Databases for MongoDB"
description: "Connect to your Public Cloud Databases for MongoDB using the Python programming language"
url: https://docs.ovhcloud.com/es/guides/public-cloud/databases/mongodb-connect-python
lang: es
lastUpdated: 2023-09-12
---
# Connect using Python for Public Cloud Databases for MongoDB

## Objective

Public Cloud Databases allow you to focus on building and deploying cloud applications while OVHcloud takes care of the database infrastructure and maintenance in operational conditions.

**This guide explains how to connect to a MongoDB database instance with one of the world's most famous programming language: Python.**

You can find an example on the [Github examples repository](https://github.com/ovh/public-cloud-databases-examples/tree/main/databases/mongodb/python/hello-world).

## Requirements

- A [Public Cloud project](https://www.ovhcloud.com/es-es/public-cloud/) in your OVHcloud account
- A MongoDB database running on your OVHcloud Public Cloud Databases ([this guide](/es/guides/public-cloud/databases/getting-started.md) can help you to meet this requirement)
- [Configure your MongoDB instance](/es/guides/public-cloud/databases/mongodb-manage-control-panel.md) to accept incoming connections
- A Python environment with a stable version and public network connectivity (Internet). This guide was made using Python 3.9.5.

## Concept

A MongoDB instance can be managed through multiple ways.
One of the easiest, yet powerful, is to use a Command Line Interface (CLI), as shown in our guide : [Connect to MongoDB with CLI](/es/guides/public-cloud/databases/mongodb-connect-cli.md).

Another way is to interact directly using a programming language, such as Python.
Python is one of the major programming languages in the world, especially in the Data ecosystem.
MongoDB provides official Python drivers, allowing us to connect and manage a MongoDB instance from code.

In order to do so, we will need to set up our Python environment with MongoDB drivers, then configure our Public Cloud Databases for MongoDB instances to accept incoming connections, and finally code in Python to perform a few example actions.

## Instructions

### Set up your Python environment

:::info
Some useful tools, such as Conda, allow you to create and use specific Python environments in the same machine, like your computer.
Conda will allow you to build a specific environment when working with MongoDB, without impacting your existing configurations. For more information please visit [https://www.conda.io](https://www.conda.io).
:::

To interact with your MongoDB instance using Python, your development environment needs to be configured with:

- A compatible version of Python.
- MongoDB official driver, called PyMongo, or Motor, when working asynchonously with MongoDB.

This guide will focus on the use of **PyMongo**, which covers most of the use cases.

Please follow the official [MongoDB documentation for Python drivers](https://docs.mongodb.com/drivers/python/) to get the latest information.

At the end of the documentation page for PyMongo, you will find a **compatibility matrix** between Python versions and PyMongo driver.
Follow this accordingly.

Once your Python environment is set up and you begin executing a **python --version** in your command line interface (CLI), you should see information about the version as shown below :

```python
laptop$ python --version
Python 3.9.5
```

In the same console, by typing **pip list | grep pymongo** check if **pymongo** is correctly installed :

```python
laptop$ pip list | grep pymongo
pymongo    4.2.0
```

In our case, we can find **Python 3.9.5**, and **PyMongo 4.2**. Based on the official MongoDB compatibility matrix linked previously, we will be able to connect to MongoDB instances in versions 4.x, 5.0 and 6.0.
This is compliant with our current MongoDB 5.0 instance.

### Configure your MongoDB instance to accept incoming connections

In order to be able to connect to your MongoDB instance, you will need to configure your instance to accept incoming connections from the IP address of your Python environment.
If you don't know how to retrieve your IP, please visit a website such as [myip.ovh](https://myip.ovh/) from the station hosting the Python environment.

Once you know the IP address, follow the steps from this guide : [Configure your MongoDB instance to accept incoming connections](/es/guides/public-cloud/databases/mongodb-manage-control-panel.md).

We will now follow the official MongoDB documentation to perform our first connection with Python.

### Connect with Python

In your Python environment, let's try a connection. To be sure that we are indeed connected, we will insert two objects.
Create a file called **basic\_insert.py**. Insert the code below with your own credentials.

As shown in the code, we use the **PyMongo** official driver. Use the official PyMongo documentation for exhaustive command list : [https://docs.mongodb.com/drivers/pymongo/](https://docs.mongodb.com/drivers/pymongo/).

```python
from pymongo import MongoClient
from pymongo.errors import ConnectionFailure

# Establishing connection
try:
    # MongoClient('mongodb://username:password@hostnameOrReplicaset/?tls=True') replica by your own Service URI
    uri = 'mongodb+srv://`<username>`:<password>@mongodb-e49d02ee-o2626ab53.database.cloud.ovh.net/admin?replicaSet=replicaset'
    connect = MongoClient(uri)
    print("MongoDB cluster is reachable")
    print(connect)
except ConnectionFailure as e:
    print("Could not connect to MongoDB")
    print(e)
```

After executing your Python code, result shown in the CLI should be like this :

```python
laptop$ python basic_insert.py
MongoDB cluster is reachable
MongoClient(host=['node1-123456789.database.cloud.ovh.net:27017'], document_class=dict, tz_aware=False, connect=True, ssl=True)
```

If not, your CLI should give you more details about the issue, for example :

- _Authentication failed_ : could be an error with your user login or password;
- _nodename nor servname provided, or not known_ : could be a wrongly typed hostname;
- _Connection reset by peer_ : usually due to connection without secure TLS mode. use _tls=true_ parameter.

Once connected, you can perform multiple operations, for example a few inserts and a **find()** inside a collection :

```python
# Connecting or switching to the database
db = connect.myDb

# Creating or switching to demoCollection
collection = db.demoCollection

#first document
document1 = {
        "name":"John",
        "age":24,
        "location":"New York"
        }
#second document
document2 = {
        "name":"Marianne",
        "age":21,
        "location":"Paris"
        }

# Inserting both documents one by one
collection.insert_one(document1)
collection.insert_one(document2)

# Printing the data inserted
cursor = collection.find()
for record in cursor:
    print(record)
```

In this example, we insert 2 objects inside a collection called **demoCollection**, then we perform a **find()** operations in this collection, looking for all the objects.

The result here is for the **print(record)** :

```python
{'_id': ObjectId('6140b59fd68c16b38fe677ba'), 'name': 'John', 'age': 24, 'location': 'New York'}
{'_id': ObjectId('6140b5a0d68c16b38fe677bb'), 'name': 'Marianne', 'age': 21, 'location': 'Paris'}
```

This code correctly found the two previously inserted objects. It means that here we were able to connect to the MongoDB instance, insert data, and look for this data.
Congratulations! Everything is working properly.

## Go further

[MongoDB capabilities](/es/guides/public-cloud/databases/mongodb-concept-capabilities.md)

[Configuring vRack for Public Cloud](/es/guides/public-cloud/network-services/vrack.md)

Visit our dedicated Discord channel: [https://discord.gg/ovhcloud](https://discord.gg/ovhcloud). Ask questions, provide feedback and interact directly with the team that builds our databases services.

If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](https://www.ovhcloud.com/es-es/professional-services/) to get a quote and ask our Professional Services experts for a custom analysis of your project.

Join our [community of users](https://community.ovhcloud.com/).