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.
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
If the total number of scanned items exceeds the maximum data set size limit of 1
MB, the scan stops and results are returned to the user as a
value to continue the scan in a subsequent operation. The results also include the
number of items exceeding the limit. A scan can result in no table data meeting the
Scan operation will read up to the maximum number of items set
(if using the
Limit parameter) or a maximum of 1 MB of data and then
apply any filtering to the results using
is present in the response, you will need to paginate the result set. For more information,
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
operation by providing the
For more information, see Parallel
Scan in the Amazon DynamoDB Developer Guide.
Scan uses eventually consistent reads when accessing the data in a table;
therefore, the result set might not include the changes to data in the table immediately
before the operation began. If you need a consistent copy of the data, as of the time
Scan begins, you can set the
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. For Unity the operation does not take CancellationToken as a parameter, and instead takes AmazonServiceCallback<ScanRequest, ScanResponse> and AsyncOptions as additional parameters.
public virtual Task<ScanResponse> ScanAsync( String tableName, Dictionary<String, Condition> scanFilter, 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.
This is a legacy parameter. Use FilterExpression instead. For more information, see ScanFilter in the Amazon DynamoDB Developer Guide.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
|InternalServerErrorException||An error occurred on the server side.|
|ProvisionedThroughputExceededException||Your request rate is too high. The AWS 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.|
|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.|
Supported in: 1.3
Supported in: 4.5
Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms
Supported Versions: 4.6 and above
Supported Platforms: Android, iOS, Standalone