Struct aws_sdk_dynamodb::output::query_output::Builder
source · pub struct Builder { /* private fields */ }
Expand description
A builder for QueryOutput
.
Implementations§
source§impl Builder
impl Builder
sourcepub fn items(self, input: HashMap<String, AttributeValue>) -> Self
pub fn items(self, input: HashMap<String, AttributeValue>) -> Self
Appends an item to items
.
To override the contents of this collection use set_items
.
An array of item attributes that match the query criteria. Each element in this array consists of an attribute name and the value for that attribute.
sourcepub fn set_items(
self,
input: Option<Vec<HashMap<String, AttributeValue>>>
) -> Self
pub fn set_items(
self,
input: Option<Vec<HashMap<String, AttributeValue>>>
) -> Self
An array of item attributes that match the query criteria. Each element in this array consists of an attribute name and the value for that attribute.
Examples found in repository?
3323 3324 3325 3326 3327 3328 3329 3330 3331 3332 3333 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 3360 3361 3362 3363 3364 3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375 3376 3377 3378 3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391 3392 3393 3394 3395 3396
pub(crate) fn deser_operation_crate_operation_query(
value: &[u8],
mut builder: crate::output::query_output::Builder,
) -> Result<
crate::output::query_output::Builder,
aws_smithy_json::deserialize::error::DeserializeError,
> {
let mut tokens_owned =
aws_smithy_json::deserialize::json_token_iter(crate::json_deser::or_empty_doc(value))
.peekable();
let tokens = &mut tokens_owned;
aws_smithy_json::deserialize::token::expect_start_object(tokens.next())?;
loop {
match tokens.next().transpose()? {
Some(aws_smithy_json::deserialize::Token::EndObject { .. }) => break,
Some(aws_smithy_json::deserialize::Token::ObjectKey { key, .. }) => {
match key.to_unescaped()?.as_ref() {
"Items" => {
builder = builder.set_items(
crate::json_deser::deser_list_com_amazonaws_dynamodb_item_list(tokens)?,
);
}
"Count" => {
builder = builder.set_count(
aws_smithy_json::deserialize::token::expect_number_or_null(
tokens.next(),
)?
.map(i32::try_from)
.transpose()?,
);
}
"ScannedCount" => {
builder = builder.set_scanned_count(
aws_smithy_json::deserialize::token::expect_number_or_null(
tokens.next(),
)?
.map(i32::try_from)
.transpose()?,
);
}
"LastEvaluatedKey" => {
builder = builder.set_last_evaluated_key(
crate::json_deser::deser_map_com_amazonaws_dynamodb_key(tokens)?,
);
}
"ConsumedCapacity" => {
builder = builder.set_consumed_capacity(
crate::json_deser::deser_structure_crate_model_consumed_capacity(
tokens,
)?,
);
}
_ => aws_smithy_json::deserialize::token::skip_value(tokens)?,
}
}
other => {
return Err(
aws_smithy_json::deserialize::error::DeserializeError::custom(format!(
"expected object key or end object, found: {:?}",
other
)),
)
}
}
}
if tokens.next().is_some() {
return Err(
aws_smithy_json::deserialize::error::DeserializeError::custom(
"found more JSON tokens after completing parsing",
),
);
}
Ok(builder)
}
sourcepub fn count(self, input: i32) -> Self
pub fn count(self, input: i32) -> Self
The number of items in the response.
If you used a QueryFilter
in the request, then Count
is the number of items returned after the filter was applied, and ScannedCount
is the number of matching items before the filter was applied.
If you did not use a filter in the request, then Count
and ScannedCount
are the same.
sourcepub fn set_count(self, input: Option<i32>) -> Self
pub fn set_count(self, input: Option<i32>) -> Self
The number of items in the response.
If you used a QueryFilter
in the request, then Count
is the number of items returned after the filter was applied, and ScannedCount
is the number of matching items before the filter was applied.
If you did not use a filter in the request, then Count
and ScannedCount
are the same.
Examples found in repository?
3323 3324 3325 3326 3327 3328 3329 3330 3331 3332 3333 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 3360 3361 3362 3363 3364 3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375 3376 3377 3378 3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391 3392 3393 3394 3395 3396
pub(crate) fn deser_operation_crate_operation_query(
value: &[u8],
mut builder: crate::output::query_output::Builder,
) -> Result<
crate::output::query_output::Builder,
aws_smithy_json::deserialize::error::DeserializeError,
> {
let mut tokens_owned =
aws_smithy_json::deserialize::json_token_iter(crate::json_deser::or_empty_doc(value))
.peekable();
let tokens = &mut tokens_owned;
aws_smithy_json::deserialize::token::expect_start_object(tokens.next())?;
loop {
match tokens.next().transpose()? {
Some(aws_smithy_json::deserialize::Token::EndObject { .. }) => break,
Some(aws_smithy_json::deserialize::Token::ObjectKey { key, .. }) => {
match key.to_unescaped()?.as_ref() {
"Items" => {
builder = builder.set_items(
crate::json_deser::deser_list_com_amazonaws_dynamodb_item_list(tokens)?,
);
}
"Count" => {
builder = builder.set_count(
aws_smithy_json::deserialize::token::expect_number_or_null(
tokens.next(),
)?
.map(i32::try_from)
.transpose()?,
);
}
"ScannedCount" => {
builder = builder.set_scanned_count(
aws_smithy_json::deserialize::token::expect_number_or_null(
tokens.next(),
)?
.map(i32::try_from)
.transpose()?,
);
}
"LastEvaluatedKey" => {
builder = builder.set_last_evaluated_key(
crate::json_deser::deser_map_com_amazonaws_dynamodb_key(tokens)?,
);
}
"ConsumedCapacity" => {
builder = builder.set_consumed_capacity(
crate::json_deser::deser_structure_crate_model_consumed_capacity(
tokens,
)?,
);
}
_ => aws_smithy_json::deserialize::token::skip_value(tokens)?,
}
}
other => {
return Err(
aws_smithy_json::deserialize::error::DeserializeError::custom(format!(
"expected object key or end object, found: {:?}",
other
)),
)
}
}
}
if tokens.next().is_some() {
return Err(
aws_smithy_json::deserialize::error::DeserializeError::custom(
"found more JSON tokens after completing parsing",
),
);
}
Ok(builder)
}
sourcepub fn scanned_count(self, input: i32) -> Self
pub fn scanned_count(self, input: i32) -> Self
The number of items evaluated, before any QueryFilter
is applied. A high ScannedCount
value with few, or no, Count
results indicates an inefficient Query
operation. For more information, see Count and ScannedCount in the Amazon DynamoDB Developer Guide.
If you did not use a filter in the request, then ScannedCount
is the same as Count
.
sourcepub fn set_scanned_count(self, input: Option<i32>) -> Self
pub fn set_scanned_count(self, input: Option<i32>) -> Self
The number of items evaluated, before any QueryFilter
is applied. A high ScannedCount
value with few, or no, Count
results indicates an inefficient Query
operation. For more information, see Count and ScannedCount in the Amazon DynamoDB Developer Guide.
If you did not use a filter in the request, then ScannedCount
is the same as Count
.
Examples found in repository?
3323 3324 3325 3326 3327 3328 3329 3330 3331 3332 3333 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 3360 3361 3362 3363 3364 3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375 3376 3377 3378 3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391 3392 3393 3394 3395 3396
pub(crate) fn deser_operation_crate_operation_query(
value: &[u8],
mut builder: crate::output::query_output::Builder,
) -> Result<
crate::output::query_output::Builder,
aws_smithy_json::deserialize::error::DeserializeError,
> {
let mut tokens_owned =
aws_smithy_json::deserialize::json_token_iter(crate::json_deser::or_empty_doc(value))
.peekable();
let tokens = &mut tokens_owned;
aws_smithy_json::deserialize::token::expect_start_object(tokens.next())?;
loop {
match tokens.next().transpose()? {
Some(aws_smithy_json::deserialize::Token::EndObject { .. }) => break,
Some(aws_smithy_json::deserialize::Token::ObjectKey { key, .. }) => {
match key.to_unescaped()?.as_ref() {
"Items" => {
builder = builder.set_items(
crate::json_deser::deser_list_com_amazonaws_dynamodb_item_list(tokens)?,
);
}
"Count" => {
builder = builder.set_count(
aws_smithy_json::deserialize::token::expect_number_or_null(
tokens.next(),
)?
.map(i32::try_from)
.transpose()?,
);
}
"ScannedCount" => {
builder = builder.set_scanned_count(
aws_smithy_json::deserialize::token::expect_number_or_null(
tokens.next(),
)?
.map(i32::try_from)
.transpose()?,
);
}
"LastEvaluatedKey" => {
builder = builder.set_last_evaluated_key(
crate::json_deser::deser_map_com_amazonaws_dynamodb_key(tokens)?,
);
}
"ConsumedCapacity" => {
builder = builder.set_consumed_capacity(
crate::json_deser::deser_structure_crate_model_consumed_capacity(
tokens,
)?,
);
}
_ => aws_smithy_json::deserialize::token::skip_value(tokens)?,
}
}
other => {
return Err(
aws_smithy_json::deserialize::error::DeserializeError::custom(format!(
"expected object key or end object, found: {:?}",
other
)),
)
}
}
}
if tokens.next().is_some() {
return Err(
aws_smithy_json::deserialize::error::DeserializeError::custom(
"found more JSON tokens after completing parsing",
),
);
}
Ok(builder)
}
sourcepub fn last_evaluated_key(self, k: impl Into<String>, v: AttributeValue) -> Self
pub fn last_evaluated_key(self, k: impl Into<String>, v: AttributeValue) -> Self
Adds a key-value pair to last_evaluated_key
.
To override the contents of this collection use set_last_evaluated_key
.
The primary key of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.
If LastEvaluatedKey
is empty, then the "last page" of results has been processed and there is no more data to be retrieved.
If LastEvaluatedKey
is not empty, it does not necessarily mean that there is more data in the result set. The only way to know when you have reached the end of the result set is when LastEvaluatedKey
is empty.
sourcepub fn set_last_evaluated_key(
self,
input: Option<HashMap<String, AttributeValue>>
) -> Self
pub fn set_last_evaluated_key(
self,
input: Option<HashMap<String, AttributeValue>>
) -> Self
The primary key of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.
If LastEvaluatedKey
is empty, then the "last page" of results has been processed and there is no more data to be retrieved.
If LastEvaluatedKey
is not empty, it does not necessarily mean that there is more data in the result set. The only way to know when you have reached the end of the result set is when LastEvaluatedKey
is empty.
Examples found in repository?
3323 3324 3325 3326 3327 3328 3329 3330 3331 3332 3333 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 3360 3361 3362 3363 3364 3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375 3376 3377 3378 3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391 3392 3393 3394 3395 3396
pub(crate) fn deser_operation_crate_operation_query(
value: &[u8],
mut builder: crate::output::query_output::Builder,
) -> Result<
crate::output::query_output::Builder,
aws_smithy_json::deserialize::error::DeserializeError,
> {
let mut tokens_owned =
aws_smithy_json::deserialize::json_token_iter(crate::json_deser::or_empty_doc(value))
.peekable();
let tokens = &mut tokens_owned;
aws_smithy_json::deserialize::token::expect_start_object(tokens.next())?;
loop {
match tokens.next().transpose()? {
Some(aws_smithy_json::deserialize::Token::EndObject { .. }) => break,
Some(aws_smithy_json::deserialize::Token::ObjectKey { key, .. }) => {
match key.to_unescaped()?.as_ref() {
"Items" => {
builder = builder.set_items(
crate::json_deser::deser_list_com_amazonaws_dynamodb_item_list(tokens)?,
);
}
"Count" => {
builder = builder.set_count(
aws_smithy_json::deserialize::token::expect_number_or_null(
tokens.next(),
)?
.map(i32::try_from)
.transpose()?,
);
}
"ScannedCount" => {
builder = builder.set_scanned_count(
aws_smithy_json::deserialize::token::expect_number_or_null(
tokens.next(),
)?
.map(i32::try_from)
.transpose()?,
);
}
"LastEvaluatedKey" => {
builder = builder.set_last_evaluated_key(
crate::json_deser::deser_map_com_amazonaws_dynamodb_key(tokens)?,
);
}
"ConsumedCapacity" => {
builder = builder.set_consumed_capacity(
crate::json_deser::deser_structure_crate_model_consumed_capacity(
tokens,
)?,
);
}
_ => aws_smithy_json::deserialize::token::skip_value(tokens)?,
}
}
other => {
return Err(
aws_smithy_json::deserialize::error::DeserializeError::custom(format!(
"expected object key or end object, found: {:?}",
other
)),
)
}
}
}
if tokens.next().is_some() {
return Err(
aws_smithy_json::deserialize::error::DeserializeError::custom(
"found more JSON tokens after completing parsing",
),
);
}
Ok(builder)
}
sourcepub fn consumed_capacity(self, input: ConsumedCapacity) -> Self
pub fn consumed_capacity(self, input: ConsumedCapacity) -> Self
The capacity units consumed by the Query
operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity
is only returned if the ReturnConsumedCapacity
parameter was specified. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.
sourcepub fn set_consumed_capacity(self, input: Option<ConsumedCapacity>) -> Self
pub fn set_consumed_capacity(self, input: Option<ConsumedCapacity>) -> Self
The capacity units consumed by the Query
operation. The data returned includes the total provisioned throughput consumed, along with statistics for the table and any indexes involved in the operation. ConsumedCapacity
is only returned if the ReturnConsumedCapacity
parameter was specified. For more information, see Provisioned Throughput in the Amazon DynamoDB Developer Guide.
Examples found in repository?
3323 3324 3325 3326 3327 3328 3329 3330 3331 3332 3333 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 3360 3361 3362 3363 3364 3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375 3376 3377 3378 3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391 3392 3393 3394 3395 3396
pub(crate) fn deser_operation_crate_operation_query(
value: &[u8],
mut builder: crate::output::query_output::Builder,
) -> Result<
crate::output::query_output::Builder,
aws_smithy_json::deserialize::error::DeserializeError,
> {
let mut tokens_owned =
aws_smithy_json::deserialize::json_token_iter(crate::json_deser::or_empty_doc(value))
.peekable();
let tokens = &mut tokens_owned;
aws_smithy_json::deserialize::token::expect_start_object(tokens.next())?;
loop {
match tokens.next().transpose()? {
Some(aws_smithy_json::deserialize::Token::EndObject { .. }) => break,
Some(aws_smithy_json::deserialize::Token::ObjectKey { key, .. }) => {
match key.to_unescaped()?.as_ref() {
"Items" => {
builder = builder.set_items(
crate::json_deser::deser_list_com_amazonaws_dynamodb_item_list(tokens)?,
);
}
"Count" => {
builder = builder.set_count(
aws_smithy_json::deserialize::token::expect_number_or_null(
tokens.next(),
)?
.map(i32::try_from)
.transpose()?,
);
}
"ScannedCount" => {
builder = builder.set_scanned_count(
aws_smithy_json::deserialize::token::expect_number_or_null(
tokens.next(),
)?
.map(i32::try_from)
.transpose()?,
);
}
"LastEvaluatedKey" => {
builder = builder.set_last_evaluated_key(
crate::json_deser::deser_map_com_amazonaws_dynamodb_key(tokens)?,
);
}
"ConsumedCapacity" => {
builder = builder.set_consumed_capacity(
crate::json_deser::deser_structure_crate_model_consumed_capacity(
tokens,
)?,
);
}
_ => aws_smithy_json::deserialize::token::skip_value(tokens)?,
}
}
other => {
return Err(
aws_smithy_json::deserialize::error::DeserializeError::custom(format!(
"expected object key or end object, found: {:?}",
other
)),
)
}
}
}
if tokens.next().is_some() {
return Err(
aws_smithy_json::deserialize::error::DeserializeError::custom(
"found more JSON tokens after completing parsing",
),
);
}
Ok(builder)
}
sourcepub fn build(self) -> QueryOutput
pub fn build(self) -> QueryOutput
Consumes the builder and constructs a QueryOutput
.
Examples found in repository?
3857 3858 3859 3860 3861 3862 3863 3864 3865 3866 3867 3868 3869 3870 3871
pub fn parse_query_response(
response: &http::Response<bytes::Bytes>,
) -> std::result::Result<crate::output::QueryOutput, crate::error::QueryError> {
Ok({
#[allow(unused_mut)]
let mut output = crate::output::query_output::Builder::default();
let _ = response;
output = crate::json_deser::deser_operation_crate_operation_query(
response.body().as_ref(),
output,
)
.map_err(crate::error::QueryError::unhandled)?;
output.build()
})
}