Connect to Database

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

Create a Connection

Creates a connection by instantiating NewUltipaDriver() with UltipaConfig, which holds the configuration details required to connect to the database.

See more connection configuration options →

Go
package main

import (
	"log"

	"github.com/ultipa/ultipa-go-driver/v5/sdk"
	"github.com/ultipa/ultipa-go-driver/v5/sdk/configuration"
)

func main() {
	config := &configuration.UltipaConfig{
        // URI example: Hosts: []string{"xxxx.us-east-1.cloud.ultipa.com:60010"},
		Hosts:    []string{"10.xx.xx.xx:60010"},
		Username: "<username>",
		Password: "<password>",
	}

	driver, err := sdk.NewUltipaDriver(config)
	if err != nil {
		log.Fatalln("Failed to connect to Ultipa:", err)
	}

    // Tests the connection
	isSuccess, _ := driver.Test(nil)
	println("Connection succeeds:", isSuccess)
}

Output
Connection succeeds: true

Use Configuration File

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

Go
package main

import (
	"log"

	"github.com/ultipa/ultipa-go-driver/v5/sdk"
	"github.com/ultipa/ultipa-go-driver/v5/sdk/configuration"
)

func main() {
	config, _ := configuration.LoadConfigFromYAML("./config.yml")

	driver, err := sdk.NewUltipaDriver(config)
	if err != nil {
		log.Fatalln("Failed to connect to Ultipa:", err)
	}

	// Tests the connection
	isSuccess, _ := driver.Test(nil)
	println("Connection succeeds:", isSuccess)
}

Output
Connection succeeds: true

Example of the config.yml file:

config.yml
# hosts: ["mqj4zouys.us-east-1.cloud.ultipa.com:60010"]
hosts: 
  - "10.xx.xx.xx:60010"
  - "10.xx.xx.xx:60010"
  - "10.xx.xx.xx:60010"
username: "<username>"
password: "<password>"
default_graph: "miniCircle"
crt: 
max_recv_size: 

See more connection configuration options →

Connection Configuration

UltipaConfig or a configuration file can include the following fields: