Help Center/ Document Database Service/ User Guide/ Connecting to a DDS Instance/ Connecting to a Cluster Instance/ Connecting to a Cluster Instance Using Program Code/ Python
Updated on 2026-08-04 GMT+08:00
View PDF
Share

Python

Scenarios

DDS allows you to perform data operations using Python. You can connect to a DB instance through an SSL connection or a non-SSL connection. SSL connections provide stronger security.

By default, SSL is disabled for new DDS instances. For details about how to enable SSL, see Configuring SSL.

This section describes how to use the MongoDB client in Python to connect to a cluster instance.

Prerequisites

  1. To connect an ECS to a DDS instance, run the following command to connect to the IP address and port of the instance server to test the network connectivity.

    curl ip:port

    If the message "It looks like you are trying to access MongoDB over HTTP on the native driver port." is displayed, the ECS and DDS instance can communicate with each other.

  2. Install Python and third-party installation package pymongo on the ECS. Pymongo 2.8 is recommended.
  3. If SSL is enabled, you need to download the root certificate and upload it to the ECS.

Enabling and Disabling SSL

import ssl
from pymongo import MongoClient
conn_urls="mongodb://rwuser:rwuserpassword@ip:port/{mydb}?authSource=admin"
connection = MongoClient(conn_urls,connectTimeoutMS=5000,ssl=True, ssl_cert_reqs=ssl.CERT_REQUIRED,ssl_match_hostname=False,ssl_ca_certs=${path to certificate authority file})
dbs = connection.database_names()
print "connect database success! database names is %s" % dbs
import ssl
from pymongo import MongoClient
conn_urls="mongodb://rwuser:rwuserpassword@ip:port/{mydb}?authSource=admin"
connection = MongoClient(conn_urls,connectTimeoutMS=5000)
dbs = connection.database_names()
print "connect database success! database names is %s" % dbs
  • The authentication database in the URL must be admin. That means setting authSource to admin.

  • In SSL mode, you need to manually generate the trustStore file.

  • The authentication database must be admin, and then switch to the service database.

Helpful Links

Enabling or Disabling SSL

Connecting to a Cluster Instance Using Program Code

Parent Topic: Connecting to a Cluster Instance Using Program Code