Après l'installation du SDK Ultipa Python et la mise en place d'une instance Ultipa en cours d'exécution, vous devriez pouvoir connecter votre application à la base de données graph Ultipa.

La connexion à Ultipa peut être établie en créant un pilote avec des configurations spécifiées en utilisant les méthodes suivantes :

• Connexion via Configuration de Code : via la classe UltipaConfig
• Connexion via Configuration de Fichier : via le fichier .env et la classe UltipaConfig

Les valeurs des éléments de configuration sont préférentiellement déterminées par UltipaConfig, suivies par .env. Si un élément n'est trouvé dans aucune configuration, la valeur par défaut est utilisée.

Connexion via Configuration de Code

from ultipa import Connection, UltipaConfig

ultipaConfig = UltipaConfig()
# Exemple d'URI : 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)

response = Conn.test()
# La connexion est établie avec succès si le code est 0
print("Code = ", response.status.code)

Code =  0

Un pilote est créé avec les configurations spécifiées en utilisant UltipaConfig. Veuillez vous référer aux Éléments de Configuration pour tous les éléments disponibles pour configurer les détails de connexion avec UltipaConfig.

La méthode Connection.NewConnection() obtient une connexion à Ultipa. Le graphset identifié par l'élément de configuration defaultGraph sera utilisé.

Connexion via Configuration de Fichier

import os
from dotenv import load_dotenv, dotenv_values
from pathlib import Path
from ultipa import Connection, UltipaConfig
from ultipa.utils.logger import LoggerConfig

# Charge le fichier .env dans l'environnement, et remplace les variables d'environnement système
env_path = Path('./.env')
env_dict = dotenv_values(dotenv_path=env_path)
load_dotenv(encoding='utf-8', override=True)

# Récupère les variables d'environnement
env_config = {
    "hosts": os.getenv("hosts"),
    "username": os.getenv("username"),
    "password": os.getenv("password"),
    "defaultGraph": os.getenv("defaultGraph")
}

def getConn():
    hosts = env_config.get("hosts", "").split(",")
    username = env_config.get("username", "")
    password = env_config.get("password", "")
    defaultGraph = env_config.get("defaultGraph", "")

    uqlLoggerConfig = LoggerConfig(name="testLog", fileName="../intergration_tests/Logs/test.log", isWriteToFile=True, isStream=True)
    defaultConfig = UltipaConfig(hosts=hosts, username=username, password=password, heartBeat=10, uqlLoggerConfig=uqlLoggerConfig)
    Conn = Connection.NewConnection(defaultConfig)
    return Conn

response = getConn().test()
print("Code = ", response.status.code)

2024-08-19 10:21:00,347 - INFO: Test Welcome To Ultipa!
2024-08-19 10:21:00,357 - INFO: Test Welcome To Ultipa!
2024-08-19 10:21:00,370 - INFO: Test Welcome To Ultipa!
2024-08-19 10:21:00,374 - INFO: Test Welcome To Ultipa!
Code =  1000

Un pilote est créé avec les configurations spécifiées en utilisant le fichier .env. Le fichier .env doit être placé sous le chemin racine du projet.

Exemple du fichier .env :

#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=PasswordEncrypt.MD5
timeoutWithSeconds=300
consistency=true
#crtFilePath=F:\ultipa.crt
#maxRecvSize=10240
defaultGraph=miniCircle
#timeZone=Asia/Tokyo
#timeZoneOffset=+0700
#responseWithRequestInfo=false
#debug=false

Veuillez vous référer aux Éléments de Configuration pour tous les éléments disponibles pour configurer les détails de connexion avec le fichier .env.

Éléments de Configuration

Voici tous les éléments de configuration disponibles pour UltipaConfig et le fichier .env :