AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
The Scan
operation returns one or more items and item attributes by accessing
every item in a table or a secondary index. To have DynamoDB return fewer items, you
can provide a FilterExpression
operation.
If the total size of scanned items exceeds the maximum dataset size limit of 1 MB,
the scan completes and results are returned to the user. The LastEvaluatedKey
value is also returned and the requestor can use the LastEvaluatedKey
to continue
the scan in a subsequent operation. Each scan response also includes number of items
that were scanned (ScannedCount) as part of the request. If using a FilterExpression
,
a scan result can result in no items meeting the criteria and the Count
will
result in zero. If you did not use a FilterExpression
in the scan request,
then Count
is the same as ScannedCount
.
Count
and ScannedCount
only return the count of items specific to a
single scan request and, unless the table is less than 1MB, do not represent the total
number of items in the table.
A single Scan
operation first reads up to the maximum number of items set (if
using the Limit
parameter) or a maximum of 1 MB of data and then applies any
filtering to the results if a FilterExpression
is provided. If LastEvaluatedKey
is present in the response, pagination is required to complete the full table scan.
For more information, see Paginating
the Results in the Amazon DynamoDB Developer Guide.
Scan
operations proceed sequentially; however, for faster performance on a
large table or secondary index, applications can request a parallel Scan
operation
by providing the Segment
and TotalSegments
parameters. For more information,
see Parallel
Scan in the Amazon DynamoDB Developer Guide.
By default, a Scan
uses eventually consistent reads when accessing the items
in a table. Therefore, the results from an eventually consistent Scan
may not
include the latest item changes at the time the scan iterates through each item in
the table. If you require a strongly consistent read of each item as the scan iterates
through the items in the table, you can set the ConsistentRead
parameter to
true. Strong consistency only relates to the consistency of the read at the item level.
DynamoDB does not provide snapshot isolation for a scan operation when the ConsistentRead
parameter is set to true. Thus, a DynamoDB scan operation does not guarantee that
all reads in a scan see a consistent snapshot of the table when the scan operation
was requested.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginScan and EndScan.
Namespace: Amazon.DynamoDBv2
Assembly: AWSSDK.DynamoDBv2.dll
Version: 3.x.y.z
public virtual Task<ScanResponse> ScanAsync( String tableName, List<String> attributesToGet, CancellationToken cancellationToken )
The name of the table containing the requested items or if you provide IndexName, the name of the table to which that index belongs. You can also provide the Amazon Resource Name (ARN) of the table in this parameter.
This is a legacy parameter. Use ProjectionExpression instead. For more information, see AttributesToGet in the Amazon DynamoDB Developer Guide.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
Exception | Condition |
---|---|
InternalServerErrorException | An error occurred on the server side. |
ProvisionedThroughputExceededException | Your request rate is too high. The Amazon Web Services SDKs for DynamoDB automatically retry requests that receive this exception. Your request is eventually successful, unless your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff. For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide. |
RequestLimitExceededException | Throughput exceeds the current throughput quota for your account. Please contact Amazon Web Services Support to request a quota increase. |
ResourceNotFoundException | The operation tried to access a nonexistent table or index. The resource might not be specified correctly, or its status might not be ACTIVE. |
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer