Zero Instant Client.
Pure Rust. Oracle 12c+.

Connect to Oracle
in three steps.

cargo add oracle-tns

use oracle_tns::{ConnectConfig, OracleSession};

let config = ConnectConfig {
    host: "db.example.com".to_string(),
    port: 1521,
    service_name: "MYDB".to_string(),
    username: "myuser".to_string(),
    password: "mypassword".to_string(),
};

let mut session = OracleSession::connect(&config).await?;

let rows = session.query(
    "SELECT id, name, email FROM users WHERE department = :1",
    &[BindParam::varchar("Engineering")],
).await?;

for row in rows {
    let id: i64 = row.get("ID")?;
    let name: String = row.get("NAME")?;
    println!("{id}: {name}");
}

session.close().await?;

Full Oracle protocol
in pure Rust.

TNS proxy with authenticated pool.
Multiplex any OCI client.

The same crate ships OxGate: a TNS proxy that terminates the client's full O5LOGON handshake (including OCI 12.1 byte-perfect mimic) and bridges to a pool of pre-authenticated backend sessions. Clients connect normally; the database sees near-zero logon churn. Built on top of oracle-tns' own protocol implementation — no Instant Client, no DRCP licence, no CMAN.

One listener,
five wire dialects.

Oracle clients across versions speak slightly different wire dialects. OxGate detects each from CONNECT capabilities and dispatches the right templates and crypto path. Pool reuse and Phase 3b multiplex work for every flavor that has a configured backend pool.

oracle-tns vs the rest

Fuzz-tested.
48 million executions.

Every parser in oracle-tns is fuzz-tested with cargo-fuzz. Five targets covering TNS packet decoding, number parsing, date decoding, codec operations, and connection packet handling. Five bugs found and fixed before they reached production.

TNS from the wire up.

Key types and functions.

pub struct ConnectConfig {
    pub host: String,
    pub port: u16,
    pub service_name: String,
    pub username: String,
    pub password: String,
}

impl OracleSession {
    pub async fn connect(config: &ConnectConfig) -> Result<Self>;
    pub async fn query(&mut self, sql: &str, params: &[BindParam]) -> Result<Vec<Row>>;
    pub async fn execute(&mut self, sql: &str, params: &[BindParam]) -> Result<u64>;
    pub async fn call(&mut self, sql: &str, params: &mut [BindParam]) -> Result<()>;
    pub async fn ping(&mut self) -> Result<()>;
    pub async fn close(self) -> Result<()>;
}

impl BindParam {
    pub fn varchar(value: &str) -> Self;
    pub fn integer(value: i64) -> Self;
    pub fn out_varchar() -> Self;
    pub fn out_cursor() -> Self;
}

impl Cursor {
    pub fn fetch_all(&self) -> &[Row];
    pub fn columns(&self) -> &[ColumnInfo];
}

pub enum OracleValue {
    Varchar(String),
    Number(f64),
    Integer(i64),
    Date(NaiveDateTime),
    Raw(Vec<u8>),
    Null,
}