Struct aws_sdk_dynamodb::input::execute_statement_input::Builder
source · pub struct Builder { /* private fields */ }
Expand description
A builder for ExecuteStatementInput
.
Implementations§
source§impl Builder
impl Builder
sourcepub fn statement(self, input: impl Into<String>) -> Self
pub fn statement(self, input: impl Into<String>) -> Self
The PartiQL statement representing the operation to run.
sourcepub fn set_statement(self, input: Option<String>) -> Self
pub fn set_statement(self, input: Option<String>) -> Self
The PartiQL statement representing the operation to run.
sourcepub fn parameters(self, input: AttributeValue) -> Self
pub fn parameters(self, input: AttributeValue) -> Self
Appends an item to parameters
.
To override the contents of this collection use set_parameters
.
The parameters for the PartiQL statement, if any.
sourcepub fn set_parameters(self, input: Option<Vec<AttributeValue>>) -> Self
pub fn set_parameters(self, input: Option<Vec<AttributeValue>>) -> Self
The parameters for the PartiQL statement, if any.
sourcepub fn consistent_read(self, input: bool) -> Self
pub fn consistent_read(self, input: bool) -> Self
The consistency of a read operation. If set to true
, then a strongly consistent read is used; otherwise, an eventually consistent read is used.
sourcepub fn set_consistent_read(self, input: Option<bool>) -> Self
pub fn set_consistent_read(self, input: Option<bool>) -> Self
The consistency of a read operation. If set to true
, then a strongly consistent read is used; otherwise, an eventually consistent read is used.
sourcepub fn next_token(self, input: impl Into<String>) -> Self
pub fn next_token(self, input: impl Into<String>) -> Self
Set this value to get remaining results, if NextToken
was returned in the statement response.
sourcepub fn set_next_token(self, input: Option<String>) -> Self
pub fn set_next_token(self, input: Option<String>) -> Self
Set this value to get remaining results, if NextToken
was returned in the statement response.
sourcepub fn return_consumed_capacity(self, input: ReturnConsumedCapacity) -> Self
pub fn return_consumed_capacity(self, input: ReturnConsumedCapacity) -> Self
Determines the level of detail about either provisioned or on-demand throughput consumption that is returned in the response:
-
INDEXES
- The response includes the aggregateConsumedCapacity
for the operation, together withConsumedCapacity
for each table and secondary index that was accessed.Note that some operations, such as
GetItem
andBatchGetItem
, do not access any indexes at all. In these cases, specifyingINDEXES
will only returnConsumedCapacity
information for table(s). -
TOTAL
- The response includes only the aggregateConsumedCapacity
for the operation. -
NONE
- NoConsumedCapacity
details are included in the response.
sourcepub fn set_return_consumed_capacity(
self,
input: Option<ReturnConsumedCapacity>
) -> Self
pub fn set_return_consumed_capacity(
self,
input: Option<ReturnConsumedCapacity>
) -> Self
Determines the level of detail about either provisioned or on-demand throughput consumption that is returned in the response:
-
INDEXES
- The response includes the aggregateConsumedCapacity
for the operation, together withConsumedCapacity
for each table and secondary index that was accessed.Note that some operations, such as
GetItem
andBatchGetItem
, do not access any indexes at all. In these cases, specifyingINDEXES
will only returnConsumedCapacity
information for table(s). -
TOTAL
- The response includes only the aggregateConsumedCapacity
for the operation. -
NONE
- NoConsumedCapacity
details are included in the response.
sourcepub fn limit(self, input: i32) -> Self
pub fn limit(self, input: i32) -> Self
The maximum number of items to evaluate (not necessarily the number of matching items). If DynamoDB processes the number of items up to the limit while processing the results, it stops the operation and returns the matching values up to that point, along with a key in LastEvaluatedKey
to apply in a subsequent operation so you can pick up where you left off. Also, if the processed dataset size exceeds 1 MB before DynamoDB reaches this limit, it stops the operation and returns the matching values up to the limit, and a key in LastEvaluatedKey
to apply in a subsequent operation to continue the operation.
sourcepub fn set_limit(self, input: Option<i32>) -> Self
pub fn set_limit(self, input: Option<i32>) -> Self
The maximum number of items to evaluate (not necessarily the number of matching items). If DynamoDB processes the number of items up to the limit while processing the results, it stops the operation and returns the matching values up to that point, along with a key in LastEvaluatedKey
to apply in a subsequent operation so you can pick up where you left off. Also, if the processed dataset size exceeds 1 MB before DynamoDB reaches this limit, it stops the operation and returns the matching values up to the limit, and a key in LastEvaluatedKey
to apply in a subsequent operation to continue the operation.
sourcepub fn build(self) -> Result<ExecuteStatementInput, BuildError>
pub fn build(self) -> Result<ExecuteStatementInput, BuildError>
Consumes the builder and constructs a ExecuteStatementInput
.
Examples found in repository?
3538 3539 3540 3541 3542 3543 3544 3545 3546 3547 3548 3549 3550 3551 3552 3553 3554 3555 3556 3557 3558 3559 3560 3561 3562 3563 3564 3565 3566 3567 3568 3569 3570 3571 3572 3573 3574 3575 3576 3577 3578 3579 3580
pub async fn customize(
self,
) -> std::result::Result<
crate::operation::customize::CustomizableOperation<
crate::operation::ExecuteStatement,
aws_http::retry::AwsResponseRetryClassifier,
>,
aws_smithy_http::result::SdkError<crate::error::ExecuteStatementError>,
> {
let handle = self.handle.clone();
let operation = self
.inner
.build()
.map_err(aws_smithy_http::result::SdkError::construction_failure)?
.make_operation(&handle.conf)
.await
.map_err(aws_smithy_http::result::SdkError::construction_failure)?;
Ok(crate::operation::customize::CustomizableOperation { handle, operation })
}
/// Sends the request and returns the response.
///
/// If an error occurs, an `SdkError` will be returned with additional details that
/// can be matched against.
///
/// By default, any retryable failures will be retried twice. Retry behavior
/// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
/// set when configuring the client.
pub async fn send(
self,
) -> std::result::Result<
crate::output::ExecuteStatementOutput,
aws_smithy_http::result::SdkError<crate::error::ExecuteStatementError>,
> {
let op = self
.inner
.build()
.map_err(aws_smithy_http::result::SdkError::construction_failure)?
.make_operation(&self.handle.conf)
.await
.map_err(aws_smithy_http::result::SdkError::construction_failure)?;
self.handle.client.call(op).await
}