Struct oracle::Connector

pub struct Connector { /* fields omitted */ }

Connection Builder

Methods

impl Connector

fn new(username: &str, password: &str, connect_string: &str) -> Connector

Creates a connection builder.

fn connect(&self) -> Result<Connection>

Establishes a connection.

fn auth_mode<'a>(&'a mut self, auth_mode: AuthMode) -> &'a mut Connector

Sets a system privilege such as SYSDBA.

// same with `sqlplus system/manager as sysdba` on command line.
let connector = oracle::Connector::new("system", "manager", "");
connector.auth_mode(oracle::AuthMode::SYSDBA);
let conn = connector.connect().unwrap();

fn prelim_auth<'a>(&'a mut self, prelim_auth: bool) -> &'a mut Connector

Sets prelim_auth mode. This is required to connect to an idle instance.

This is required only when starting up a database.

fn events<'a>(&'a mut self, events: bool) -> &'a mut Connector

fn edition<'a>(&'a mut self, edition: &str) -> &'a mut Connector

fn new_password<'a>(&'a mut self, password: &str) -> &'a mut Connector

fn app_context<'a>(
    &'a mut self,
    namespace: &str,
    name: &str,
    value: &str
) -> &'a mut Connector

Sets an application context. See Oracle manual

This is same with DBMS_SESSION.SET_CONTEXT but this can set application contexts before a connection is established.

Examples:

let mut connector = oracle::Connector::new("scott", "tiger", "");
connector.app_context("CLIENTCONTEXT", "foo", "bar");
connector.app_context("CLIENTCONTEXT", "baz", "qux");
let conn = connector.connect().unwrap();
let mut stmt = conn.execute("select sys_context('CLIENTCONTEXT', 'baz') from dual", &()).unwrap();
let row = stmt.fetch().unwrap();
let val: String = row.get(0).unwrap(); // -> "qux"

fn driver_name<'a>(&'a mut self, name: &str) -> &'a mut Connector

Sets the driver name displayed in V$SESSION_CONNECT_INFO.CLIENT_DRIVER.

The default value is "rust-oracle : version number". Only the first 8 chracters "rust-ora" are displayed when the Oracle server version is lower than 12.0.1.2.