Help Center/ Document Database Service/ User Guide/ Connecting to a DDS Instance/ Connecting to a Single Node Instance/ Connecting to a Single Node 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 connect to a single node instance using Python.

Prerequisites

  1. Ensure that the ECS can communicate with the DDS instance. To test the connectivity to the instance's IP address and port, run the curl command:

    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&directConnection=true"
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&directConnection=true"
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 Single Node Instance Using Program Code

Parent Topic: Connecting to a Single Node Instance Using Program Code