Struct DatabaseHandle 

pub struct DatabaseHandle { /* private fields */ }

A lightweight caller-specific handle onto one shared [DatabaseCore] (spec §10.1, S1A-001).

Obtained from crate::manager::DatabaseManager::open_shared. Cloning or dropping a handle has no storage side effects; storage closes when the last core reference drops or Self::shutdown runs.

Implementations

impl DatabaseHandle

pub fn identity(&self) -> &HandleIdentity

The identity bound to this handle.

pub fn access(&self) -> HandleAccess

The access restriction bound to this handle.

pub fn shares_core_with(&self, other: &Self) -> bool

Whether two handles reference the exact same process-local core.

pub fn lifecycle_state(&self) -> LifecycleState

The current lifecycle state of the shared core (S1A-004).

pub fn operation_guard(&self) -> Result<OperationGuard>

Admit one operation against the shared core (S1A-004). The RAII guard releases the operation slot on drop; new operations are rejected once the core leaves LifecycleState::Open.

pub fn query( &self, table: &str, query: &Query, projection: Option<&[u16]>, ) -> Result<Vec<Row>>

Execute an authorized native query with live roles, RLS, masks, and column grants.

pub fn count(&self, table: &str) -> Result<u64>

Count rows visible to this handle after live authorization and RLS.

pub fn rows(&self, table: &str) -> Result<Vec<Row>>

Return all rows visible to this handle after RLS and masks.

pub fn create_table(&self, name: &str, schema: Schema) -> Result<u64>

Create a table through this handle’s live principal.

pub fn put(&self, table: &str, cells: Vec<(u16, Value)>) -> Result<Option<i64>>

Atomically insert one row through this handle’s live principal.

pub fn delete(&self, table: &str, row_id: RowId) -> Result<()>

Atomically delete one row through this handle’s live principal.

pub fn create_user(&self, username: &str, password: &str) -> Result<UserEntry>

Create a catalog user. Admin only.

pub fn drop_user(&self, username: &str) -> Result<()>

Drop a catalog user. Admin only.

pub fn create_role(&self, role: &str) -> Result<RoleEntry>

Create a role. Admin only.

pub fn grant_role(&self, username: &str, role: &str) -> Result<()>

Grant a role to a catalog user. Admin only.

pub fn revoke_role(&self, username: &str, role: &str) -> Result<()>

Revoke a role from a catalog user. Admin only.

pub fn grant_permission(&self, role: &str, permission: Permission) -> Result<()>

Grant one permission to a role. Admin only.

pub fn revoke_permission( &self, role: &str, permission: Permission, ) -> Result<()>

Revoke one permission from a role. Admin only.

pub fn shutdown(&self, drain_deadline: Duration) -> Result<()>

Shut the shared core down (spec §10.1, S1A-004): drain in-flight operations within drain_deadline, sync durable state, release the file lock, and mark the core Closed. Every handle — including this one — then rejects further operations. Dropping a handle never closes storage; only this method or the last core drop does.

Trait Implementations

impl Debug for DatabaseHandle

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

Formats the value using the given formatter.