Struct Session

pub struct Session<T = Bound>(/* private fields */);

A session object is used to execute queries and maintains cluster state through the control connection. The control connection is used to auto-discover nodes and monitor cluster changes (topology and schema). Each session also maintains multiple /pools of connections to cluster nodes which are used to query the cluster.

Instances of the session object are thread-safe to execute queries.

Implementations

impl<S> Session<S>

where S: SessionScope,

pub fn statement(&self, query: impl AsRef<str>) -> Statement<S>

Creates a statement with the given query.

pub async fn execute(&self, query: impl AsRef<str>) -> Result<CassResult>

Executes a given query.

pub fn batch(&self, batch_type: BatchType) -> Batch<S>

Creates a new batch that is bound to this session.

pub fn get_schema_meta(&self) -> SchemaMeta

Gets a snapshot of this session’s schema metadata. The returned snapshot of the schema metadata is not updated. This function must be called again to retrieve any schema changes since the previous call.

pub fn get_metrics(&self) -> SessionMetrics

Gets a copy of this session’s performance/diagnostic metrics.

pub async fn prepare( &self, query: impl AsRef<str>, ) -> Result<PreparedStatement<S>>

Create a prepared statement with the given query.

impl Session<Bound>

pub fn keyspace(&self) -> &str

Returns the keyspace that the session is bound to.

Trait Implementations

impl<T: Clone> Clone for Session<T>

fn clone(&self) -> Session<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for Session<T>

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

Formats the value using the given formatter.

impl Default for Session<Unbound>

fn default() -> Session<Unbound>

Returns the “default value” for a type.

impl<T> PartialEq for Session<T>

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

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> Eq for Session<T>

impl<T: Send> Send for Session<T>

impl<T: Sync> Sync for Session<T>