完成安装嬴图Python SDK，设置一个运行的嬴图实例后，可以开始将您的应用连接到嬴图图数据库。

创建驱动程序并根据以下方法中的一种或两种进行配置，以建立与嬴图数据库的连接：

• 代码配置连接：通过UltipaConfig类
• 文件配置连接：通过.env文件和UltipaConfig类

配置项的值优先由UltipaConfig决定，其次是.env。若配置项在两个配置方法中均未提及，则使用默认值。

代码配置连接

from ultipa import Connection, UltipaConfig

ultipaConfig = UltipaConfig()
# 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()
# The connection is successfully established if the code is 0
print("Code = ", response.status.code)

Code =  0

使用UltipaConfig配置的驱动程序创建完成。请参考配置项使用UltipaConfig为全部可配置项配置连接详情。

Connection.NewConnection()方法用于获取与嬴图数据库的连接。连接将使用配置项defaultGraph中指定的图集。

文件配置连接

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

# 加载 .env 文件中的环境变量，并覆盖系统环境变量
env_path = Path('./.env')
env_dict = dotenv_values(dotenv_path=env_path)
load_dotenv(encoding='utf-8', override=True)

# 获取环境变量
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

.env文件中指定的配置创建一个驱动程序。.env文件应该放置在项目的根目录下。

.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

若要查看所有可用于通过.env文件配置连接细节的选项，请查阅配置项 。

配置项

以下各项可通过UltipaConfig和.env文件配置：