Struct Session 

pub struct Session { /* private fields */ }

A unified session binding an identity to a database engine.

Implementations

impl Session

pub fn from_token(engine: StandardEngine, info: &Token) -> Self

Create a session from a validated auth token (server path).

pub fn from_token_with_value(engine: StandardEngine, info: &Token) -> Self

Create a session from a validated auth token, preserving the token string.

pub fn trusted(engine: StandardEngine, identity: IdentityId) -> Self

Create a trusted session (embedded path, no authentication required).

pub fn anonymous(engine: StandardEngine) -> Self

Create an anonymous session.

pub fn with_retry(self, policy: RetryPolicy) -> Self

Set the retry policy for command and admin operations.

pub fn identity(&self) -> IdentityId

The identity associated with this session.

pub fn token(&self) -> Option<&str>

The auth token, if this session was created from a validated token.

pub fn is_authenticated(&self) -> bool

Whether this session was created from authenticated credentials.

pub fn query( &self, rql: &str, params: impl Into<Params>, ) -> Result<Vec<Frame>, Error>

Execute a read-only query.

pub fn command( &self, rql: &str, params: impl Into<Params>, ) -> Result<Vec<Frame>, Error>

Execute a transactional command (DML + Query) with retry on conflict.

pub fn admin( &self, rql: &str, params: impl Into<Params>, ) -> Result<Vec<Frame>, Error>

Execute an admin (DDL + DML + Query) operation with retry on conflict.