Struct hdbconnect::ConnectParams

pub struct ConnectParams { /* private fields */ }

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

An instance of ConnectParams can be created in various ways:

• using the builder
• using an implementation of IntoConnectParams
  • implementations are provided for URLs that are represented as String or as Url
• the shortcut ConnectParams::from_file reads the URL from a file

The URL is supposed to have the form

<scheme>://<username>:<password>@<host>:<port>[<options>]

where

<scheme> = hdbsql | hdbsqls
<username> = the name of the DB user to log on
<password> = the password of the DB user
<host> = the host where HANA can be found
<port> = the port at which HANA can be found on <host>
<options> = ?<key> = <value> [{&<key> = <value>}]

Special option keys are:

client_locale: <value> is used to specify the client’s locale
client_locale_from_env: if <value> is 1, the client’s locale is read from the environment variabe LANG
tls_certificate_dir: the <value> points to a folder with pem files that contain the server’s certificates; all pem files in that folder are evaluated
tls_certificate_env: the <value> denotes the environment variable that contains the server’s certificate

The client locale is used in language-dependent handling within the SAP HANA database calculation engine.

If you want to provide the server certificate directly, then

Example

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

Implementations

impl ConnectParams

pub fn builder() -> ConnectParamsBuilder

Returns a new builder for ConnectParams.

pub fn from_file<P: AsRef<Path>>(path: P) -> HdbResult<ConnectParams>

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

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

The ServerCerts.

pub fn host(&self) -> &str

The host.

pub fn addr(&self) -> &str

The socket address.

pub fn use_tls(&self) -> bool

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

pub fn dbuser(&self) -> &String

The database user.

pub fn password(&self) -> &SecStr

The password.

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

The client locale.

pub fn options(&self) -> &[(String, String)]

Options to be passed to HANA.

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

Formats the value using the given formatter.

impl IntoConnectParams for ConnectParams

fn into_connect_params(self) -> HdbResult<ConnectParams>

Converts the value of self into a ConnectParams.