Client - CyborgDB Docs

The cyborg::Client class manages storage configurations and acts as a factory for creating or loading encrypted indexes.

Constructor

cyborg::Client(const std::string& api_key,
               const DBConfig& index_location,
               const DBConfig& config_location,
               const DBConfig& items_location,
               const int cpu_threads,
               const bool gpu_accelerate);

Initializes a new instance of Client.

Parameters

Parameter	Type	Description
`api_key`	`std::string`	API key for your CyborgDB account.
`index_location`	`DBConfig`	Configuration for index storage location.
`config_location`	`DBConfig`	Configuration for index metadata storage.
`items_location`	`DBConfig`	Configuration intended to be used in a future release. Pass in a DBConfig with a Location of ‘None’.
`cpu_threads`	`int`	Number of CPU threads to use (e.g., `0` to use all available cores).
`gpu_accelerate`	`bool`	Whether to enable GPU acceleration (requires CUDA).

Exceptions

std::invalid_argument

Throws if the cpu_threads parameter is less than 0.
Throws if any DBConfig is invalid.
Throws if the GPU is not available when gpu_accelerate is true.

std::runtime_exception

Throws if the backing store is not available.
Throws if the Client could not be initialized.

Example Usage

#include "cyborgdb_core/client.hpp"

std::string api_key = "your_api_key_here";
cyborg::DBConfig index_location(Location::kMemory);
cyborg::DBConfig config_location(Location::kRedis, "index_metadata", "redis://localhost");
cyborg::DBConfig items_location(Location::kNone); // No item storage
int cpu_threads = 4;
bool use_gpu = true;

cyborg::Client client(api_key, index_location, config_location, items_location, cpu_threads, use_gpu);

⌘I