Struct ExecuteBatchDmlRequest 

#[non_exhaustive]
pub struct ExecuteBatchDmlRequest {
    pub session: String,
    pub transaction: Option<TransactionSelector>,
    pub statements: Vec<Statement>,
    pub seqno: i64,
    pub request_options: Option<RequestOptions>,
    pub last_statements: bool,
    /* private fields */
}

The request for ExecuteBatchDml.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

session: String

Required. The session in which the DML statements should be performed.

transaction: Option<TransactionSelector>

Required. The transaction to use. Must be a read-write transaction.

To protect against replays, single-use transactions are not supported. The caller must either supply an existing transaction ID or begin a new transaction.

statements: Vec<Statement>

Required. The list of statements to execute in this batch. Statements are executed serially, such that the effects of statement i are visible to statement i+1. Each statement must be a DML statement. Execution stops at the first failed statement; the remaining statements are not executed.

Callers must provide at least one statement.

seqno: i64

Required. A per-transaction sequence number used to identify this request. This field makes each request idempotent such that if the request is received multiple times, at most one succeeds.

The sequence number must be monotonically increasing within the transaction. If a request arrives for the first time with an out-of-order sequence number, the transaction might be aborted. Replays of previously handled requests yield the same response as the first execution.

request_options: Option<RequestOptions>

Common options for this request.

last_statements: bool

Optional. If set to true, this request marks the end of the transaction. After these statements execute, you must commit or abort the transaction. Attempts to execute any other requests against this transaction (including reads and queries) are rejected.

Setting this option might cause some error reporting to be deferred until commit time (for example, validation of unique constraints). Given this, successful execution of statements shouldn’t be assumed until a subsequent Commit call completes successfully.

Implementations

impl ExecuteBatchDmlRequest

pub fn new() -> Self

Creates a new default instance.

pub fn set_session<T: Into<String>>(self, v: T) -> Self

Sets the value of session.

pub fn set_transaction<T>(self, v: T) -> Self

where T: Into<TransactionSelector>,

Sets the value of transaction.

pub fn set_or_clear_transaction<T>(self, v: Option<T>) -> Self

where T: Into<TransactionSelector>,

Sets or clears the value of transaction.

pub fn set_statements<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<Statement>,

Sets the value of statements.

pub fn set_seqno<T: Into<i64>>(self, v: T) -> Self

Sets the value of seqno.

pub fn set_request_options<T>(self, v: T) -> Self

where T: Into<RequestOptions>,

Sets the value of request_options.

pub fn set_or_clear_request_options<T>(self, v: Option<T>) -> Self

where T: Into<RequestOptions>,

Sets or clears the value of request_options.

pub fn set_last_statements<T: Into<bool>>(self, v: T) -> Self

Sets the value of last_statements.

Trait Implementations

impl Clone for ExecuteBatchDmlRequest

fn clone(&self) -> ExecuteBatchDmlRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExecuteBatchDmlRequest

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

Formats the value using the given formatter.

impl Default for ExecuteBatchDmlRequest

fn default() -> ExecuteBatchDmlRequest

Returns the “default value” for a type.

impl Message for ExecuteBatchDmlRequest

fn typename() -> &'static str

The typename of this message.

impl PartialEq for ExecuteBatchDmlRequest

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