AWS SDK Version 4 for .NET
API Reference

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.

Represents a request to scan items in a DynamoDB table or index using the Document Model. This class introduces a modern expression-based API that replaces legacy parameter-based approaches. Legacy parameters such as ScanFilter, AttributesToGet are not supported. Use FilterExpression and ProjectionExpression instead.

Inheritance Hierarchy

System.Object
  Amazon.DynamoDBv2.DocumentModel.DocumentOperationRequest
    Amazon.DynamoDBv2.DocumentModel.ScanDocumentOperationRequest

Namespace: Amazon.DynamoDBv2.DocumentModel
Assembly: AWSSDK.DynamoDBv2.dll
Version: 3.x.y.z

Syntax

C#
public class ScanDocumentOperationRequest : DocumentOperationRequest

The ScanDocumentOperationRequest type exposes the following members

Constructors

NameDescription
Public Method ScanDocumentOperationRequest()

Initializes a new instance of the Amazon.DynamoDBv2.DocumentModel.ScanDocumentOperationRequest class.

Properties

NameTypeDescription
Public Property CollectResults System.Boolean

Whether to collect GetNextSet and GetRemaining results in Matches property. Default is true. If set to false, Matches will always be empty.

Public Property ConsistentRead System.Boolean

Gets or sets the consistent read flag. Strongly consistent reads are only supported for tables and local secondary indexes.

Public Property FilterExpression Amazon.DynamoDBv2.DocumentModel.Expression

Gets or sets the filter expression specifying which items should be returned after scanning. Applied after DynamoDB reads the items.

Public Property IndexName System.String

Gets or sets the index name to scan against.

Public Property Limit System.Int32

Gets or sets the maximum number of items DynamoDB should process before returning a page of results. Defaults to int.MaxValue (service default paging behavior).

Public Property PaginationToken System.String

Pagination token corresponding to the item where the last Scan operation stopped. Set this value to resume the scan from the next item. Retrieved from a Search object.

Public Property ProjectionExpression Amazon.DynamoDBv2.DocumentModel.Expression

Gets or sets the projection expression specifying which attributes should be retrieved.

Public Property ReturnConsumedCapacity Amazon.DynamoDBv2.ReturnConsumedCapacity

Controls whether DynamoDB returns capacity consumption details for each Scan request. Defaults to NONE. Set to TOTAL or INDEXES to capture consumed capacity metrics in Search.Metrics.

Public Property Segment System.Int32

For parallel Scan requests, Segment identifies an individual segment to be scanned by an application "worker" (such as a thread or a process). Each worker issues a Scan request with a distinct value for the segment it will scan. Segment IDs are zero-based, so the first segment is always 0. For example, if you want to scan a table using four application threads, the first thread would specify a Segment value of 0, the second thread would specify 1, and so on. LastEvaluatedKey returned from a parallel scan request must be used with same Segment id in a subsequent operation. The value for Segment must be less than or equal to 0, and less than the value provided for TotalSegments. If you specify Segment, you must also specify TotalSegments.

Constraints:

       
  •         Range         0 - 999999    

Public Property Select Amazon.DynamoDBv2.DocumentModel.SelectValues

Enum specifying what data to return from the scan (e.g., attributes or count).

Public Property TotalSegments System.Int32

For parallel Scan requests, TotalSegmentsrepresents the total number of segments for a table that is being scanned. Segments are a way to logically divide a table into equally sized portions, for the duration of the Scan request. The value of TotalSegments corresponds to the number of application "workers" (such as threads or processes) that will perform the parallel Scan. For example, if you want to scan a table using four application threads, you would specify a TotalSegments value of 4. The value for TotalSegments must be greater than or equal to 1, and less than or equal to 1000000. If you specify a TotalSegments value of 1, the Scan will be sequential rather than parallel. If you specify TotalSegments, you must also specify Segment.

Constraints:

       
  •         Range         1 - 1000000    

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.7.2 and newer