> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# new

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/gpudb.rs#L1699-L1703)
pub async fn [new](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/new.md#method.new)( urls: [Vec](https://doc.rust-lang.org/1.98.1/alloc/vec/struct.Vec.html)\<[String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html)>, options: [KineticaOptions](https://docs.kinetica.com/content/api/rust/gpudb/struct.KineticaOptions.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<Self, [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Creates a new Kinetica client instance with full initialization.This constructor performs the full initialization sequence:

<ul>
  <li>Parses and validates URLs</li>
  <li>Discovers cluster information (unless auto-discovery is disabled)</li>
  <li>Sets up HA failover configuration</li>
  <li>Checks connectivity: fails over from a first cluster that is not usable, then reads the server version from the cluster selected, and fails if either cannot be done</li>
</ul>

##### Arguments

<ul>
  <li>`urls` - List of URLs to connect to (e.g., `vec!["http://localhost:9191".to\_string()\]`)</li>
  <li>`options` - Configuration options including credentials and connection settings</li>
</ul>

##### Returns

Returns a fully initialized `Kinetica` instance or an error if initialization fails.

##### Example

```rust theme={null}
use gpudb_api::{Kinetica, KineticaOptions};
use std::sync::Arc;

let mut options = KineticaOptions::new();
options.set_username("admin")
       .set_password("password")
       .set_use_snappy(true);

let kinetica = Arc::new(
    Kinetica::new(vec!["http://localhost:9191".to_string()], options).await?
);
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.