pub struct BulkOperation<B> { /* private fields */ }
Expand description

A bulk operation consists of a header that indicates the bulk action and the related metadata for the action, and an optional source document.

A collection of bulk operations can be sent to the Bulk API in the body of the API call.

For serializing a collection of bulk operations that model the source document of each bulk operation using different structs, take a look at BulkOperations.

Example

Using serde_json’s json! macro to constuct serde_json::Value from JSON literals, for the source document of each bulk operation

let mut ops: Vec<BulkOperation<Value>> = Vec::with_capacity(4);
ops.push(BulkOperation::index(json!({
        "user": "kimchy",
        "post_date": "2009-11-15T00:00:00Z",
        "message": "Trying out Elasticsearch, so far so good?"
    }))
    .id("1")
    .pipeline("process_tweet")
    .into()
);
ops.push(BulkOperation::create("2", json!({
        "user": "forloop",
        "post_date": "2020-01-08T00:00:00Z",
        "message": "Indexing with the rust client, yeah!"
    }))
    .pipeline("process_tweet")
    .into()
);
ops.push(BulkOperation::update("3", json!({
        "doc": {
            "message": "Tweets are _meant_ to be immutable!"
        },
        "doc_as_upsert": true
    }))
    .into()
);
ops.push(BulkOperation::delete("4")
    .index("old_tweets")
    .into()
);

let bulk_response = client.bulk(BulkParts::Index("tweets"))
    .body(ops)
    .send()
    .await?;

Implementations§

source§

impl<B> BulkOperation<B>
where B: Serialize,

source

pub fn create<S>(id: S, source: B) -> BulkCreateOperation<B>
where S: Into<String>,

Creates a new instance of a bulk create operation

source

pub fn index(source: B) -> BulkIndexOperation<B>

Creates a new instance of a bulk index operation

source

pub fn delete<S>(id: S) -> BulkDeleteOperation<B>
where S: Into<String>,

Creates a new instance of a bulk delete operation

source

pub fn update<S>(id: S, source: B) -> BulkUpdateOperation<B>
where S: Into<String>,

Creates a new instance of a bulk update operation

Trait Implementations§

source§

impl<B> Body for BulkOperation<B>
where B: Serialize,

source§

fn write(&self, bytes: &mut BytesMut) -> Result<(), Error>

Write to a buffer that will be written to the request stream
source§

fn bytes(&self) -> Option<Bytes>

An existing immutable buffer that can be used to avoid having to write to another buffer that will then be written to the request stream. Read more
source§

impl<B> From<BulkCreateOperation<B>> for BulkOperation<B>

source§

fn from(b: BulkCreateOperation<B>) -> Self

Converts to this type from the input type.
source§

impl<B> From<BulkDeleteOperation<B>> for BulkOperation<B>

source§

fn from(b: BulkDeleteOperation<B>) -> Self

Converts to this type from the input type.
source§

impl<B> From<BulkIndexOperation<B>> for BulkOperation<B>

source§

fn from(b: BulkIndexOperation<B>) -> Self

Converts to this type from the input type.
source§

impl<B> From<BulkUpdateOperation<B>> for BulkOperation<B>

source§

fn from(b: BulkUpdateOperation<B>) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

§

impl<B> RefUnwindSafe for BulkOperation<B>
where B: RefUnwindSafe,

§

impl<B> Send for BulkOperation<B>
where B: Send,

§

impl<B> Sync for BulkOperation<B>
where B: Sync,

§

impl<B> Unpin for BulkOperation<B>
where B: Unpin,

§

impl<B> UnwindSafe for BulkOperation<B>
where B: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

source§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more