Struct ReadOnlyConnection 

pub struct ReadOnlyConnection { /* private fields */ }

Read-only database connection

This connection type enforces read-only access at the API level. All write methods (put, delete, etc.) are not available on this type.

Use Case

Use this when you need concurrent read access while another process is writing to the database (e.g., Flowtrace App reading while a background script writes).

Example

use sochdb::ReadOnlyConnection;

// Open read-only connection (acquires shared lock)
let reader = ReadOnlyConnection::open("./data")?;

// Read operations work
let value = reader.get(b"key")?;
let items = reader.scan(b"prefix")?;

// Write operations are not available - compile error!
// reader.put(b"key", b"value"); // Error: no method named `put`

Implementations

impl ReadOnlyConnection

pub fn open(path: impl AsRef<Path>) -> Result<Self>

Open a read-only connection to the database.

Multiple read-only connections can be open simultaneously. Write operations are not available on this connection type.

pub fn begin_read_txn(&self) -> Result<u64>

Begin a read transaction for consistent snapshot reads

pub fn end_read_txn(&self) -> Result<()>

End the read transaction

pub fn get(&self, key: &[u8]) -> Result<Option<Vec<u8>>>

Get a value by key

pub fn scan(&self, prefix: &[u8]) -> Result<Vec<(Vec<u8>, Vec<u8>)>>

Scan keys with a prefix

pub fn get_path(&self, path: &str) -> Result<Option<Vec<u8>>>

Get a value by path

pub fn scan_path(&self, prefix: &str) -> Result<Vec<(String, Vec<u8>)>>

Scan by path prefix

pub fn resolve(&self, path: &str) -> Result<PathResolution>

Resolve a path (O(|path|) lookup)

pub fn queries_executed(&self) -> u64

Get query statistics

Trait Implementations

impl ReadableConnection for ReadOnlyConnection

fn get(&self, key: &[u8]) -> Result<Option<Vec<u8>>>

Get a value by key

fn scan(&self, prefix: &[u8]) -> Result<Vec<(Vec<u8>, Vec<u8>)>>

Scan keys with a prefix

fn get_path(&self, path: &str) -> Result<Option<Vec<u8>>>

Get a value by path

fn scan_path(&self, prefix: &str) -> Result<Vec<(String, Vec<u8>)>>

Scan by path prefix