Struct hdbconnect::ConnectParams

pub struct ConnectParams { /* private fields */ }

An immutable struct with all information necessary to open a new connection to a HANA database.

Instantiating a ConnectParams using the ConnectParamsBuilder

See ConnectParamsBuilder for details.

use hdbconnect::{ConnectParams, ServerCerts};
let certificate: String = read_certificate();
let connect_params = ConnectParams::builder()
   .hostname("the_host")
   .port(2222)
   .dbuser("my_user")
   .password("my_passwd")
   .tls_with(ServerCerts::Direct(certificate))
   .build()
   .unwrap();

Instantiating a ConnectParams from a URL

See module url for details about the supported URLs.

use hdbconnect::IntoConnectParams;
let conn_params = "hdbsql://my_user:my_passwd@the_host:2222"
    .into_connect_params()
    .unwrap();

Redirects

hdbconnect supports redirects. You can connect to an MDC tenant database by specifying the host and port of the system database, and the name of the database to which you want to be connected with url parameter “db” or with ConnectParamsBuilder::dbname.

Implementations

impl ConnectParams

pub fn builder() -> ConnectParamsBuilder

Returns a new builder for ConnectParams.

pub fn from_file<P>(path: P) -> Result<ConnectParams, HdbError>

where P: AsRef<Path>,

Reads a url from the given file and converts it into ConnectParams.

Errors

HdbError::ConnParams

pub fn server_certs(&self) -> Option<&Vec<ServerCerts>>

The ServerCerts.

pub fn host(&self) -> &str

The host.

pub fn addr(&self) -> &str

The socket address.

pub fn is_tls(&self) -> bool

Whether TLS or a plain TCP connection is to be used.

pub fn dbuser(&self) -> &str

The database user.

pub fn password(&self) -> &SecUtf8

The password.

pub fn clientlocale(&self) -> Option<&str>

The client locale.

pub fn dbname(&self) -> Option<&str>

The name of the (MDC) database.

pub fn network_group(&self) -> Option<&str>

The name of a network group.

pub fn precheck_certificates(&self) -> Result<Vec<String>, HdbError>

Provide detailed insight into acceptance of configured certificates

Trait Implementations

impl Clone for ConnectParams

fn clone(&self) -> ConnectParams

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ConnectParams

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ConnectParams

fn deserialize<D>( deserializer: D, ) -> Result<ConnectParams, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ConnectParams

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl IntoConnectParams for &ConnectParams

fn into_connect_params(self) -> Result<ConnectParams, HdbError>

Converts the value of self into a ConnectParams.

impl IntoConnectParams for ConnectParams

fn into_connect_params(self) -> Result<ConnectParams, HdbError>

Converts the value of self into a ConnectParams.

impl PartialEq for ConnectParams

fn eq(&self, other: &ConnectParams) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ConnectParams

impl StructuralPartialEq for ConnectParams