Struct BatchOptions 

pub struct BatchOptions {
    pub multierror: bool,
    pub record_counts: bool,
    pub buffer_bytes: Option<u32>,
}

Opções de criação de um Batch (clumplets do op_batch_create).

Fields

multierror: bool

Se true, o servidor CONTINUA após uma linha falhar, executando as demais e reportando o erro de cada uma em BatchResult::errors. Para isso ele bracketa cada linha num savepoint interno — o que tem custo por linha.

Se false (padrão), o lote PARA na primeira linha que falha (fail-fast): é bem mais rápido (sem savepoint por linha) e é o que se quer quando a transação é “tudo ou nada” e qualquer erro aborta a operação inteira.

record_counts: bool

Se true (padrão), o servidor reporta a contagem de linhas afetadas por mensagem em BatchResult::update_counts (e portanto BatchResult::total_affected).

buffer_bytes: Option<u32>

Tamanho máximo (em bytes) do buffer de batch que o servidor aloca (TAG_BUFFER_BYTES_SIZE). None (padrão) deixa o servidor usar o seu default. Aumentar permite acumular mais mensagens/blobs por execute sem estourar o buffer (o estouro aparece como “invalid BLOB ID”); o servidor impõe um teto próprio (256 MiB no Firebird).

Implementations

impl BatchOptions

pub fn new() -> Self

Opções padrão (fail-fast, com contagens por linha).

pub fn multierror(self, on: bool) -> Self

Liga/desliga o modo multierro (continuar após erros por linha).

pub fn record_counts(self, on: bool) -> Self

Liga/desliga o reporte de contagens de linhas afetadas por mensagem.

pub fn buffer_bytes(self, bytes: u32) -> Self

Define o tamanho do buffer de batch do servidor (TAG_BUFFER_BYTES_SIZE), em bytes. Use para acomodar lotes maiores (mais mensagens/blobs por execute) sem estourar o buffer. O servidor impõe um teto (256 MiB no Firebird); valores acima são limitados por ele.

Trait Implementations

impl Clone for BatchOptions

fn clone(&self) -> BatchOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BatchOptions

impl Debug for BatchOptions

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

Formats the value using the given formatter.

impl Default for BatchOptions

fn default() -> Self

Returns the “default value” for a type.