Connection

Once you have installed the driver and set up an Ultipa instance, you can connect your application to the database.

You can establish a connection using the configurations from UltipaConfig. See UltipaConfig Attributes.

Creating a Connection

Creates a connection using Connection.NewConnection():

from ultipa import Connection, UltipaConfig

ultipaConfig = UltipaConfig()
# URI example: ultipaConfig.hosts = ["mqj4zouys.us-east-1.cloud.ultipa.com:60010"]
ultipaConfig.hosts = ["192.168.1.85:60061", "192.168.1.87:60061", "192.168.1.88:60061"]
ultipaConfig.username = "<username>"
ultipaConfig.password = "<password>"

Conn = Connection.NewConnection(defaultConfig=ultipaConfig)

# Tests the connection
isSuccess = Conn.test()
print("Connection succeeds:", isSuccess)

Connection succeeds: True

Using Configuration File

This example demonstrates how to use the configuration file .env to establish a connection:

import os
from pathlib import Path
from dotenv import dotenv_values, load_dotenv
from ultipa import Connection, UltipaConfig

# Loads the .env file and overrides system environment variables
env_path = Path('./.env')
env_dict = dotenv_values(dotenv_path=env_path)
load_dotenv(encoding='utf-8', override=True)

hosts = os.getenv("hosts").split(",")
username = os.getenv("username")
password = os.getenv("password")

ultipaConfig = UltipaConfig(hosts=hosts, username=username, password=password, heartbeat=10)
Conn = Connection.NewConnection(defaultConfig=ultipaConfig)

# Tests the connection
response = Conn.test()
print(response.status.code.name)

SUCCESS

Example of the .env file:

#hosts=mqj4zouys.us-east-1.cloud.ultipa.com:60010
hosts=192.168.1.85:60061,192.168.1.86:60061,192.168.1.87:60061
username=<username>
password=<password>
passwordEncrypt=MD5
defaultGraph=miniCircle
#crt=F:\\ultipa.crt
#maxRecvSize=10240

UltipaConfig Attributes

The UltipaConfig class includes the following attributes: