Struct Session

pub struct Session(pub Arc<SessionInner>);

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.

Tuple Fields

0: Arc<SessionInner>

Implementations

impl Session

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

Create a prepared statement with the given query.

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

Creates a statement with the given query.

pub fn execute_batch(&self, batch: &Batch) -> CassFuture<CassResult>

Execute a batch statement.

pub fn execute_batch_with_payloads( &self, batch: &Batch, ) -> CassFuture<(CassResult, HashMap<String, Vec<u8>>)>

Execute a batch statement and get any custom payloads from the response.

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

Executes a given query.

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

Creates a new batch that is bound to this session.

pub fn execute_with_payloads( &self, statement: &Statement, ) -> CassFuture<(CassResult, HashMap<String, Vec<u8>>)>

Execute a statement and get any custom payloads from the response.

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.

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Session

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

Formats the value using the given formatter.

impl Default for Session

fn default() -> Session

Returns the “default value” for a type.

impl PartialEq for Session

fn eq(&self, other: &Session) -> 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 Eq for Session

impl StructuralPartialEq for Session