Struct cassandra_cpp::Session

pub struct Session(pub *mut _Session);

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: *mut _Session

Implementations

impl Session

pub fn new() -> Session

Create a new Cassanda session. It’s recommended to use Cluster.connect() instead

pub fn connect(self, cluster: &Cluster) -> CassFuture<()>

Connects a session.

pub fn connect_keyspace(
    &self,
    cluster: &Cluster,
    keyspace: &str
) -> Result<CassFuture<()>>

Connects a session and sets the keyspace.

pub fn close(self) -> CassFuture<()>

Closes the session instance, outputs a close future which can be used to determine when the session has been terminated. This allows in-flight requests to finish.

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

Create a prepared statement.

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

Execute a batch statement.

pub fn execute(&self, statement: &Statement) -> CassFuture<CassResult>

Execute a statement.

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 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 Drop for Session

fn drop(&mut self)

Frees a session instance. If the session is still connected it will be synchronously closed before being deallocated.

impl Send for Session

impl Sync for Session