Twoorb Plugins  1.0
 All Classes Namespaces Functions Variables Enumerations Enumerator Properties
Twoorb.AWS.DynamoDBUtility Class Reference

A runtime utility class for the DynamoDB service to make it easier to use its features. If you need to communicate with DynamoDB in the editor instead of at runtime, we recommend that you use the NETDynamoDB class. More...

Inheritance diagram for Twoorb.AWS.DynamoDBUtility:

Public Member Functions

void ListTables (string exclusiveStartTableName, int returnLimit, DynamoDBListTablesEventHandler onListTablesEventHandler)
 List available tables More...
 
void CreateTable (string tableName, ProvisionedThroughput throughput, List< AttributeDefinition > attributeDefinitions, List< KeySchemaElement > keySchema, List< GlobalSecondaryIndex > globalSecondaryIndexes, List< LocalSecondaryIndex > localSecondaryIndexes, DynamoDBCreateTableEventHandler onCreateTableEventHandler)
 Create a new table More...
 
void DeleteTable (string tableName, DynamoDBDeleteTableEventHandler onDeleteTableEventHandler)
 Delete a table More...
 
void DescribeTable (string tableName, DynamoDBDescribeTableEventHandler onDescribeTableEventHandler)
 Describe a table More...
 
void UpdateTable (string tableName, ProvisionedThroughput throughput, List< GlobalSecondaryIndexUpdate > globalSecondaryIndexUpdates, DynamoDBUpdateTableEventHandler onUpdateTableEventHandler)
 Update a table More...
 
void CreateItem (string tableName, Dictionary< string, AttributeValue > attributeValues, Dictionary< string, ExpectedAttributeValue > expectedAttributeValues, ReturnConsumedCapacity returnConsumedCapacity, ReturnItemCollectionMetrics returnItemCollectionMetrics, ReturnValue returnValue, DynamoDBCreateItemEventHandler onCreateItemEventHandler)
 Create an item More...
 
void GetItem (string tableName, bool consistentRead, List< string > attributesToGet, Dictionary< string, AttributeValue > key, ReturnConsumedCapacity returnConsumedCapacity, DynamoDBGetItemEventHandler onGetObjectEventHandler)
 Get an item from a table More...
 
void DeleteItem (string tableName, Dictionary< string, AttributeValue > key, Dictionary< string, ExpectedAttributeValue > expectedAttributeValues, ReturnConsumedCapacity returnConsumedCapacity, ReturnItemCollectionMetrics returnItemCollectionMetrics, ReturnValue returnValue, DynamoDBDeleteItemEventHandler onDeleteItemEventHandler)
 Delete an item from a table More...
 
void UpdateItem (string tableName, Dictionary< string, AttributeValue > key, Dictionary< string, AttributeValueUpdate > attributeUpdates, Dictionary< string, ExpectedAttributeValue > expectedAttributeValues, ReturnConsumedCapacity returnConsumedCapacity, ReturnItemCollectionMetrics returnItemCollectionMetrics, ReturnValue returnValue, DynamoDBUpdateItemEventHandler onUpdateItemEventHandler)
 Updates an item in a table More...
 
void BatchWriteItems (Dictionary< string, List< WriteRequest >> requestItems, ReturnConsumedCapacity returnConsumedCapacity, ReturnItemCollectionMetrics returnItemCollectionMetrics, DynamoDBBatchWriteItemEventHandler onBatchResultEventHandler)
 The BatchWriteItem operation puts or deletes multiple items in one or more tables. A single call to BatchWriteItem can write up to 1 MB of data, which can comprise as many as 25 put or delete requests. Individual items to be written can be as large as 64 KB. More...
 
void BatchGetItems (Dictionary< string, KeysAndAttributes > requestItems, ReturnConsumedCapacity returnConsumedCapacity, DynamoDBBatchGetItemEventHandler onBatchGetEventHandler)
 The BatchGetItem operation returns the attributes of one or more items from one or more tables. You identify requested items by primary key. A single operation can retrieve up to 1 MB of data, which can comprise as many as 100 items. More...
 
void Initialize (string accessKey, string secretKey, EAWSRegion region)
 Initializes the DynamoDB Utility More...
 
void Close ()
 Closes the DynamoDB Utility More...
 
void ListTables (ListTablesRequest listTablesRequest, DynamoDBListTablesEventHandler onListTablesEventHandler)
 List available tables More...
 
void CreateTable (CreateTableRequest createTableRequest, DynamoDBCreateTableEventHandler onCreateTableEventHandler)
 Create a new table More...
 
void DeleteTable (DeleteTableRequest deleteTableRequest, DynamoDBDeleteTableEventHandler onDeleteTableEventHandler)
 Delete a table More...
 
void DescribeTable (DescribeTableRequest describeTableRequest, DynamoDBDescribeTableEventHandler onDescribeTableEventHandler)
 Describe a table More...
 
void UpdateTable (UpdateTableRequest updateTableRequest, DynamoDBUpdateTableEventHandler onUpdateTableEventHandler)
 Update a table More...
 
void CreateItem (PutItemRequest createItemRequest, DynamoDBCreateItemEventHandler onCreateItemEventHandler)
 Create an item More...
 
void GetItem (GetItemRequest getItemRequest, DynamoDBGetItemEventHandler onGetObjectEventHandler)
 Get an item from a table More...
 
void DeleteItem (DeleteItemRequest deleteItemRequest, DynamoDBDeleteItemEventHandler onDeleteItemEventHandler)
 Delete an item from a table More...
 
void UpdateItem (UpdateItemRequest updateItemRequest, DynamoDBUpdateItemEventHandler onUpdateItemEventHandler)
 Updates an item in a table More...
 
void BatchWriteItems (DynamoDBBatchWriteItemEventHandler onBatchResultEventHandler, params PutItemRequest[] putRequests)
 Converts PutItemRequest params into a single batch request. The BatchWriteItem operation puts or deletes multiple items in one or more tables. A single call to BatchWriteItem can write up to 1 MB of data, which can comprise as many as 25 put or delete requests. Individual items to be written can be as large as 64 KB. More...
 
void BatchWriteItems (DynamoDBBatchWriteItemEventHandler onBatchResultEventHandler, params DeleteItemRequest[] deleteRequests)
 Converts DeleteItemRequest params into a single batch request. The BatchWriteItem operation puts or deletes multiple items in one or more tables. A single call to BatchWriteItem can write up to 1 MB of data, which can comprise as many as 25 put or delete requests. Individual items to be written can be as large as 64 KB. More...
 
void BatchWriteItems (BatchWriteItemRequest batchWriteItemRequest, DynamoDBBatchWriteItemEventHandler onBatchResultEventHandler)
 The BatchWriteItem operation puts or deletes multiple items in one or more tables. A single call to BatchWriteItem can write up to 1 MB of data, which can comprise as many as 25 put or delete requests. Individual items to be written can be as large as 64 KB. More...
 
void BatchGetItems (DynamoDBBatchGetItemEventHandler onBatchGetEventHandler, params GetItemRequest[] getRequests)
 Converts GetItemRequest params into a single batch request. The BatchGetItem operation returns the attributes of one or more items from one or more tables. You identify requested items by primary key. A single operation can retrieve up to 1 MB of data, which can comprise as many as 100 items. More...
 
void BatchGetItems (BatchGetItemRequest batchGetItemRequest, DynamoDBBatchGetItemEventHandler onBatchGetEventHandler)
 The BatchGetItem operation returns the attributes of one or more items from one or more tables. You identify requested items by primary key. A single operation can retrieve up to 1 MB of data, which can comprise as many as 100 items. More...
 
void Query (QueryRequest request, DynamoDBQueryHandler onQueryHandler)
 A Query operation directly accesses items from a table using the table primary key, or from an index using the index key. You must provide a specific hash key value. You can narrow the scope of the query by using comparison operators on the range key value, or on the index key. More...
 
void Scan (ScanRequest request, DynamoDBScanHandler onScanHandler)
 The Scan operation returns one or more items and item attributes by accessing every item in the table. To have Amazon DynamoDB return fewer items, you can provide a ScanFilter . More...
 
void WaitUntilTableIsReady (string tableName, Action< bool > onDone, int retryCount=0)
 Action that polls the table status in intervals until status is active or reached the thresholds(DescribeTableWaitTime and MaxDescribeTableCount properties) More...
 

Properties

IAmazonDynamoDB Client [get]
 The DynamoDB client that the utility is using. Use this class if you want to use some of the methods of DynamoDB currently not supported in the DynamoDBUtility class. More...
 
bool IsInitialized [get]
 Returns if the DynamoDBUtility class is Initialized. More...
 
EDynamoDBState CurrentState [get]
 Gets the current state of the DynamoDBUtility class More...
 
float DescribeTableWaitTime [get, set]
 The DynamoDBUtility will wait for tables to gets the status ACTIVE after certain actions. For example when creating or updating a table. The DescribeTableWaitTime property gets or sets how many seconds to wait before polling the table status again. More...
 
int MaxDescribeTableCount [get, set]
 The DynamoDBUtility will wait for tables to gets the status ACTIVE after certain actions. For example when creating or updating a table. The MaxDescribeTableCount property gets or sets how many times it should poll the table status before giving up. More...
 
int MaxBatchRetryCount [get, set]
 When a batch request(get/write) completes, some items or keys can still be unprocessed. The MaxBatchRetryCount gets or sets how many times the system should try and process the unprocessed items(if there are any) More...
 

Detailed Description

A runtime utility class for the DynamoDB service to make it easier to use its features. If you need to communicate with DynamoDB in the editor instead of at runtime, we recommend that you use the NETDynamoDB class.

Member Function Documentation

void Twoorb.AWS.DynamoDBUtility.BatchGetItems ( Dictionary< string, KeysAndAttributes requestItems,
ReturnConsumedCapacity  returnConsumedCapacity,
DynamoDBBatchGetItemEventHandler  onBatchGetEventHandler 
)

The BatchGetItem operation returns the attributes of one or more items from one or more tables. You identify requested items by primary key. A single operation can retrieve up to 1 MB of data, which can comprise as many as 100 items.

Parameters
requestItemsA map of one or more table names and, for each table, the corresponding primary keys for the items to retrieve. Each table name can be invoked only once. Each element in the map consists of the following:
  • Keys - An array of primary key attribute values that define specific items in the table.
  • AttributesToGet - One or more attributes to be retrieved from the table or index. By default, all attributes are returned. If a specified attribute is not found, it does not appear in the result.
  • ConsistentRead - If true, a strongly consistent read is used; if false (the default), an eventually consistent read is used.
returnConsumedCapacityIf set to TOTAL, ConsumedCapacity is included in the response; if set to NONE (the default), ConsumedCapacity is not included.
onBatchGetEventHandlerThe event handler that invokes when the BatchGetItems operation is done
void Twoorb.AWS.DynamoDBUtility.BatchGetItems ( DynamoDBBatchGetItemEventHandler  onBatchGetEventHandler,
params GetItemRequest[]  getRequests 
)

Converts GetItemRequest params into a single batch request. The BatchGetItem operation returns the attributes of one or more items from one or more tables. You identify requested items by primary key. A single operation can retrieve up to 1 MB of data, which can comprise as many as 100 items.

Parameters
onBatchGetEventHandlerThe event handler that invokes when the BatchGetItems operation is done
getRequestsContainer for the parameters to the GetItem operation.

The GetItem operation returns a set of attributes for the item with the given primary key. If there is no matching item, GetItem does not return any data.

GetItem provides an eventually consistent read by default. If your application requires a strongly consistent read, set ConsistentRead to true . Although a strongly consistent read might take more time than an eventually consistent read, it always returns the last updated value.

void Twoorb.AWS.DynamoDBUtility.BatchGetItems ( BatchGetItemRequest  batchGetItemRequest,
DynamoDBBatchGetItemEventHandler  onBatchGetEventHandler 
)

The BatchGetItem operation returns the attributes of one or more items from one or more tables. You identify requested items by primary key. A single operation can retrieve up to 1 MB of data, which can comprise as many as 100 items.

Parameters
batchGetItemRequestContainer for the parameters to the BatchGetItem operation.

The BatchGetItem operation returns the attributes of one or more items from one or more tables. You identify requested items by primary key.

A single operation can retrieve up to 1 MB of data, which can comprise as many as 100 items. BatchGetItem will return a partial result if the response size limit is exceeded, the table's provisioned throughput is exceeded, or an internal processing failure occurs. If a partial result is returned, the operation returns a value for UnprocessedKeys . You can use this value to retry the operation starting with the next item to get.

For example, if you ask to retrieve 100 items, but each individual item is 50 KB in size, the system returns 20 items (1 MB) and an appropriate UnprocessedKeys value so you can get the next page of results. If desired, your application can include its own logic to assemble the pages of results into one dataset.

If no items can be processed because of insufficient provisioned throughput on each of the tables involved in the request, BatchGetItem throws ProvisionedThroughputExceededException .

By default, BatchGetItem performs eventually consistent reads on every table in the request. If you want strongly consistent reads instead, you can set ConsistentRead to true for any or all tables.

In order to minimize response latency, BatchGetItem fetches items in parallel.

When designing your application, keep in mind that Amazon DynamoDB does not return attributes in any particular order. To help parse the response by item, include the primary key values for the items in your request in the AttributesToGet parameter.

If a requested item does not exist, it is not returned in the result. Requests for nonexistent items consume the minimum read capacity units according to the type of read. For more information, see Capacity Units Calculations in the Amazon DynamoDB Developer Guide.

Parameters
onBatchGetEventHandlerThe event handler that invokes when the BatchGetItems operation is done
void Twoorb.AWS.DynamoDBUtility.BatchWriteItems ( Dictionary< string, List< WriteRequest >>  requestItems,
ReturnConsumedCapacity  returnConsumedCapacity,
ReturnItemCollectionMetrics  returnItemCollectionMetrics,
DynamoDBBatchWriteItemEventHandler  onBatchResultEventHandler 
)

The BatchWriteItem operation puts or deletes multiple items in one or more tables. A single call to BatchWriteItem can write up to 1 MB of data, which can comprise as many as 25 put or delete requests. Individual items to be written can be as large as 64 KB.

Parameters
requestItemsA map of one or more table names and, for each table, a list of operations to be performed (DeleteRequest or PutRequest). Each element in the map consists of the following:
  • DeleteRequest - Perform a DeleteItem operation on the specified item. The item to be deleted is identified by a Key subelement:
    • Key - A map of primary key attribute values that uniquely identify the item. Each entry in this map consists of an attribute name and an attribute value.
  • PutRequest - Perform a PutItem operation on the specified item. The item to be put is identified by an Item subelement:
    • Item - A map of attributes and their values. Each entry in this map consists of an attribute name and an attribute value. Attribute values must not be null; string and binary type attributes must have lengths greater than zero; and set type attributes must not be empty. Requests that contain empty values will be rejected with a ValidationException. If you specify any attributes that are part of an index key, then the data types for those attributes must match those of the schema in the table's attribute definition.
returnConsumedCapacityIf set to TOTAL, ConsumedCapacity is included in the response; if set to NONE (the default), ConsumedCapacity is not included.
returnItemCollectionMetricsIf set to SIZE, statistics about item collections, if any, that were modified during the operation are returned in the response. If set to NONE (the default), no statistics are returned..
onBatchResultEventHandlerThe event handler that invokes when the BatchWriteItems operation is done
void Twoorb.AWS.DynamoDBUtility.BatchWriteItems ( DynamoDBBatchWriteItemEventHandler  onBatchResultEventHandler,
params PutItemRequest[]  putRequests 
)

Converts PutItemRequest params into a single batch request. The BatchWriteItem operation puts or deletes multiple items in one or more tables. A single call to BatchWriteItem can write up to 1 MB of data, which can comprise as many as 25 put or delete requests. Individual items to be written can be as large as 64 KB.

Parameters
onBatchResultEventHandlerThe event handler that invokes when the BatchWriteItems operation is done
putRequestsContainer for the parameters to the PutItem operation.

Creates a new item, or replaces an old item with a new item. If an item already exists in the specified table with the same primary key, the new item completely replaces the existing item. You can perform a conditional put (insert a new item if one with the specified primary key doesn't exist), or replace an existing item if it has certain attribute values.

In addition to putting an item, you can also return the item's attribute values in the same operation, using the ReturnValues parameter.

When you add an item, the primary key attribute(s) are the only required attributes. Attribute values cannot be null. String and binary type attributes must have lengths greater than zero. Set type attributes cannot be empty. Requests with empty values will be rejected with a ValidationException .

You can request that PutItem return either a copy of the old item (before the update) or a copy of the new item (after the update). For more information, see the ReturnValues description.

NOTE: To prevent a new item from replacing an existing item, use a conditional put operation with Exists set to false for the primary key attribute, or attributes.

For more information about using this API, see Working with Items in the Amazon DynamoDB Developer Guide.

void Twoorb.AWS.DynamoDBUtility.BatchWriteItems ( DynamoDBBatchWriteItemEventHandler  onBatchResultEventHandler,
params DeleteItemRequest[]  deleteRequests 
)

Converts DeleteItemRequest params into a single batch request. The BatchWriteItem operation puts or deletes multiple items in one or more tables. A single call to BatchWriteItem can write up to 1 MB of data, which can comprise as many as 25 put or delete requests. Individual items to be written can be as large as 64 KB.

Parameters
onBatchResultEventHandlerThe event handler that invokes when the BatchWriteItems operation is done
deleteRequestsContainer for the parameters to the DeleteItem operation.

Deletes a single item in a table by primary key. You can perform a conditional delete operation that deletes the item if it exists, or if it has an expected attribute value.

In addition to deleting an item, you can also return the item's attribute values in the same operation, using the ReturnValues parameter.

Unless you specify conditions, the DeleteItem is an idempotent operation; running it multiple times on the same item or attribute does not result in an error response.

Conditional deletes are useful for only deleting items if specific conditions are met. If those conditions are met, Amazon DynamoDB performs the delete. Otherwise, the item is not deleted.

void Twoorb.AWS.DynamoDBUtility.BatchWriteItems ( BatchWriteItemRequest  batchWriteItemRequest,
DynamoDBBatchWriteItemEventHandler  onBatchResultEventHandler 
)

The BatchWriteItem operation puts or deletes multiple items in one or more tables. A single call to BatchWriteItem can write up to 1 MB of data, which can comprise as many as 25 put or delete requests. Individual items to be written can be as large as 64 KB.

Parameters
batchWriteItemRequestContainer for the parameters to the BatchWriteItem operation.

The BatchWriteItem operation puts or deletes multiple items in one or more tables. A single call to BatchWriteItem can write up to 1 MB of data, which can comprise as many as 25 put or delete requests. Individual items to be written can be as large as 64 KB.

NOTE: BatchWriteItem cannot update items. To update items, use the UpdateItem API.

The individual PutItem and DeleteItem operations specified in BatchWriteItem are atomic; however BatchWriteItem as a whole is not. If any requested operations fail because the table's provisioned throughput is exceeded or an internal processing failure occurs, the failed operations are returned in the UnprocessedItems response parameter. You can investigate and optionally resend the requests. Typically, you would call BatchWriteItem in a loop. Each iteration would check for unprocessed items and submit a new BatchWriteItem request with those unprocessed items until all items have been processed.

To write one item, you can use the PutItem operation; to delete one item, you can use the DeleteItem operation.

With BatchWriteItem , you can efficiently write or delete large amounts of data, such as from Amazon Elastic MapReduce (EMR), or copy data from another database into Amazon DynamoDB. In order to improve performance with these large-scale operations, BatchWriteItem does not behave in the same way as individual PutItem and DeleteItem calls would For example, you cannot specify conditions on individual put and delete requests, and BatchWriteItem does not return deleted items in the response.

If you use a programming language that supports concurrency, such as Java, you can use threads to write items in parallel. Your application must include the necessary logic to manage the threads.

With languages that don't support threading, such as PHP, BatchWriteItem will write or delete the specified items one at a time. In both situations, BatchWriteItem provides an alternative where the API performs the specified put and delete operations in parallel, giving you the power of the thread pool approach without having to introduce complexity into your application.

Parallel processing reduces latency, but each specified put and delete request consumes the same number of write capacity units whether it is processed in parallel or not. Delete operations on nonexistent items consume one write capacity unit.

If one or more of the following is true, Amazon DynamoDB rejects the entire batch write operation:

  • One or more tables specified in the BatchWriteItem request does not exist.

Primary key attributes specified on an item in the request do not match those in the corresponding table's primary key schema.

You try to perform multiple operations on the same item in the same BatchWriteItem request. For example, you cannot put and delete the same item in the same BatchWriteItem request.

The total request size exceeds 1 MB.

Any individual item in a batch exceeds 64 KB.

Parameters
onBatchResultEventHandlerThe event handler that invokes when the BatchWriteItems operation is done
void Twoorb.AWS.DynamoDBUtility.Close ( )

Closes the DynamoDB Utility

void Twoorb.AWS.DynamoDBUtility.CreateItem ( string  tableName,
Dictionary< string, AttributeValue attributeValues,
Dictionary< string, ExpectedAttributeValue expectedAttributeValues,
ReturnConsumedCapacity  returnConsumedCapacity,
ReturnItemCollectionMetrics  returnItemCollectionMetrics,
ReturnValue  returnValue,
DynamoDBCreateItemEventHandler  onCreateItemEventHandler 
)

Create an item

Parameters
tableNameThe name of the table to contain the item.
attributeValuesA map of attribute name/value pairs, one for each attribute. Only the primary key attributes are required; you can optionally provide other attribute name-value pairs for the item. If you specify any attributes that are part of an index key, then the data types for those attributes must match those of the schema in the table's attribute definition. For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer Guide. Each element in the Item map is an AttributeValue object.
expectedAttributeValuesA map of attribute/condition pairs. This is the conditional block for the PutItem operation. All the conditions must be met for the operation to succeed. Expected allows you to provide an attribute name, and whether or not Amazon DynamoDB should check to see if the attribute value already exists; or if the attribute value exists and has a particular value before changing it. Each item in Expected represents an attribute name for Amazon DynamoDB to check, along with the following:
  • Value - The attribute value for Amazon DynamoDB to check.
  • Exists - Causes Amazon DynamoDB to evaluate the value before attempting a conditional operation:
    • If Exists is true, Amazon DynamoDB will check to see if that attribute value already exists in the table. If it is found, then the operation succeeds. If it is not found, the operation fails with a ConditionalCheckFailedException.
    • If Exists is false, Amazon DynamoDB assumes that the attribute value does not exist in the table. If in fact the value does not exist, then the assumption is valid and the operation succeeds. If the value is found, despite the assumption that it does not exist, the operation fails with a ConditionalCheckFailedException.
    The default setting for Exists is true. If you supply a Value all by itself, Amazon DynamoDB assumes the attribute exists: You don't have to set Exists to true, because it is implied. Amazon DynamoDB returns a ValidationException if:
    • Exists is true but there is no Value to check. (You expect a value to exist, but don't specify what that value is.)
    • Exists is false but you also specify a Value. (You cannot expect an attribute to have a value, while also expecting it not to exist.)
If you specify more than one condition for Exists, then all of the conditions must evaluate to true. (In other words, the conditions are ANDed together.) Otherwise, the conditional operation will fail.
returnConsumedCapacityIf set to TOTAL, ConsumedCapacity is included in the response; if set to NONE (the default), ConsumedCapacity is not included.
returnItemCollectionMetricsIf set to SIZE, statistics about item collections, if any, that were modified during the operation are returned in the response. If set to NONE (the default), no statistics are returned..
returnValueUse ReturnValues if you want to get the item attributes as they appeared before they were updated with the PutItem request. For PutItem, the valid values are:
  • NONE - If ReturnValues is not specified, or if its value is NONE, then nothing is returned. (This is the default for ReturnValues.)
  • ALL_OLD - If PutItem overwrote an attribute name-value pair, then the content of the old item is returned.
onCreateItemEventHandlerThe event handler that invokes when the CreateItem operation is done
void Twoorb.AWS.DynamoDBUtility.CreateItem ( PutItemRequest  createItemRequest,
DynamoDBCreateItemEventHandler  onCreateItemEventHandler 
)

Create an item

Parameters
createItemRequestContainer for the parameters to the PutItem operation.

Creates a new item, or replaces an old item with a new item. If an item already exists in the specified table with the same primary key, the new item completely replaces the existing item. You can perform a conditional put (insert a new item if one with the specified primary key doesn't exist), or replace an existing item if it has certain attribute values.

In addition to putting an item, you can also return the item's attribute values in the same operation, using the ReturnValues parameter.

When you add an item, the primary key attribute(s) are the only required attributes. Attribute values cannot be null. String and binary type attributes must have lengths greater than zero. Set type attributes cannot be empty. Requests with empty values will be rejected with a ValidationException .

You can request that PutItem return either a copy of the old item (before the update) or a copy of the new item (after the update). For more information, see the ReturnValues description.

NOTE: To prevent a new item from replacing an existing item, use a conditional put operation with Exists set to false for the primary key attribute, or attributes.

For more information about using this API, see Working with Items in the Amazon DynamoDB Developer Guide.

Parameters
onCreateItemEventHandlerThe event handler that invokes when the CreateItem operation is done
void Twoorb.AWS.DynamoDBUtility.CreateTable ( string  tableName,
ProvisionedThroughput  throughput,
List< AttributeDefinition attributeDefinitions,
List< KeySchemaElement keySchema,
List< GlobalSecondaryIndex globalSecondaryIndexes,
List< LocalSecondaryIndex localSecondaryIndexes,
DynamoDBCreateTableEventHandler  onCreateTableEventHandler 
)

Create a new table

Parameters
tableNameThe name of the table to create.
throughputThe provisioned throughput settings for the specified table. The settings can be modified using the UpdateTable operation. For current minimum and maximum provisioned throughput values, see Limits in the Amazon DynamoDB Developer Guide.
attributeDefinitionsAn array of attributes that describe the key schema for the table and indexes.
keySchemaSpecifies the attributes that make up the primary key for the table. The attributes in KeySchema must also be defined in the AttributeDefinitions array. For more information, see Data Model in the Amazon DynamoDB Developer Guide. Each KeySchemaElement in the array is composed of:
  • AttributeName - The name of this key attribute.
  • KeyType - Determines whether the key attribute is HASH or RANGE.
For a primary key that consists of a hash attribute, you must specify exactly one element with a KeyType of HASH. For a primary key that consists of hash and range attributes, you must specify exactly two elements, in this order: The first element must have a KeyType of HASH, and the second element must have a KeyType of RANGE. For more information, see Specifying the Primary Key in the Amazon DynamoDB Developer Guide.
globalSecondaryIndexesGlobal Secondary Index
localSecondaryIndexesOne or more secondary indexes (the maximum is five) to be created on the table. Each index is scoped to a given hash key value. There is a 10 gigabyte size limit per hash key; otherwise, the size of a local secondary index is unconstrained. Each secondary index in the array includes the following:
  • IndexName - The name of the secondary index. Must be unique only for this table.
  • KeySchema - Specifies the key schema for the index. The key schema must begin with the same hash key attribute as the table.
  • Projection - Specifies attributes that are copied (projected) from the table into the index. These are in addition to the primary key attributes and index key attributes, which are automatically projected. Each attribute specification is composed of:
    • ProjectionType - One of the following:
      • KEYS_ONLY - Only the index and primary keys are projected into the index.
      • INCLUDE - Only the specified table attributes are projected into the index. The list of projected attributes are in NonKeyAttributes.
      • ALL - All of the table attributes are projected into the index.
    • NonKeyAttributes - A list of one or more non-key attribute names that are projected into the index. The total count of attributes specified in NonKeyAttributes, summed across all of the local secondary indexes, must not exceed 20. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total.
onCreateTableEventHandlerThe event handler that invokes when the CreateTable operation is done
void Twoorb.AWS.DynamoDBUtility.CreateTable ( CreateTableRequest  createTableRequest,
DynamoDBCreateTableEventHandler  onCreateTableEventHandler 
)

Create a new table

Parameters
createTableRequestContainer for the parameters to the CreateTable operation.

The CreateTable operation adds a new table to your account. In an AWS account, table names must be unique within each region. That is, you can have two tables with same name if you create the tables in different regions.

CreateTable is an asynchronous operation. Upon receiving a CreateTable request, Amazon DynamoDB immediately returns a response with a TableStatus of CREATING . After the table is created, Amazon DynamoDB sets the TableStatus to ACTIVE . You can perform read and write operations only on an ACTIVE table.

If you want to create multiple tables with local secondary indexes on them, you must create them sequentially. Only one table with local secondary indexes can be in the CREATING state at any given time.

You can use the DescribeTable API to check the table status.

Parameters
onCreateTableEventHandlerThe event handler that invokes when the CreateTable operation is done
void Twoorb.AWS.DynamoDBUtility.DeleteItem ( string  tableName,
Dictionary< string, AttributeValue key,
Dictionary< string, ExpectedAttributeValue expectedAttributeValues,
ReturnConsumedCapacity  returnConsumedCapacity,
ReturnItemCollectionMetrics  returnItemCollectionMetrics,
ReturnValue  returnValue,
DynamoDBDeleteItemEventHandler  onDeleteItemEventHandler 
)

Delete an item from a table

Parameters
tableNameThe name of the table from which to delete the item.
keyA map of attribute names to AttributeValue objects, representing the primary key of the item to delete.
expectedAttributeValuesA map of attribute/condition pairs. This is the conditional block for the DeleteItemoperation. All the conditions must be met for the operation to succeed. Expected allows you to provide an attribute name, and whether or not Amazon DynamoDB should check to see if the attribute value already exists; or if the attribute value exists and has a particular value before changing it. Each item in Expected represents an attribute name for Amazon DynamoDB to check, along with the following:
  • Value - The attribute value for Amazon DynamoDB to check.
  • Exists - Causes Amazon DynamoDB to evaluate the value before attempting a conditional operation:
    • If Exists is true, Amazon DynamoDB will check to see if that attribute value already exists in the table. If it is found, then the operation succeeds. If it is not found, the operation fails with a ConditionalCheckFailedException.
    • If Exists is false, Amazon DynamoDB assumes that the attribute value does not exist in the table. If in fact the value does not exist, then the assumption is valid and the operation succeeds. If the value is found, despite the assumption that it does not exist, the operation fails with a ConditionalCheckFailedException.
    The default setting for Exists is true. If you supply a Value all by itself, Amazon DynamoDB assumes the attribute exists: You don't have to set Exists to true, because it is implied. Amazon DynamoDB returns a ValidationException if:
    • Exists is true but there is no Value to check. (You expect a value to exist, but don't specify what that value is.)
    • Exists is false but you also specify a Value. (You cannot expect an attribute to have a value, while also expecting it not to exist.)
If you specify more than one condition for Exists, then all of the conditions must evaluate to true. (In other words, the conditions are ANDed together.) Otherwise, the conditional operation will fail.
returnConsumedCapacityIf set to TOTAL, ConsumedCapacity is included in the response; if set to NONE (the default), ConsumedCapacity is not included.
returnItemCollectionMetricsIf set to SIZE, statistics about item collections, if any, that were modified during the operation are returned in the response. If set to NONE (the default), no statistics are returned..
returnValueUse ReturnValues if you want to get the item attributes as they appeared before they were deleted. For DeleteItem, the valid values are:
  • NONE - If ReturnValues is not specified, or if its value is NONE, then nothing is returned. (This is the default for ReturnValues.)
  • ALL_OLD - The content of the old item is returned.
onDeleteItemEventHandlerThe event handler that invokes when the DeleteItem operation is done
void Twoorb.AWS.DynamoDBUtility.DeleteItem ( DeleteItemRequest  deleteItemRequest,
DynamoDBDeleteItemEventHandler  onDeleteItemEventHandler 
)

Delete an item from a table

Parameters
deleteItemRequestContainer for the parameters to the DeleteItem operation.

Deletes a single item in a table by primary key. You can perform a conditional delete operation that deletes the item if it exists, or if it has an expected attribute value.

In addition to deleting an item, you can also return the item's attribute values in the same operation, using the ReturnValues parameter.

Unless you specify conditions, the DeleteItem is an idempotent operation; running it multiple times on the same item or attribute does not result in an error response.

Conditional deletes are useful for only deleting items if specific conditions are met. If those conditions are met, Amazon DynamoDB performs the delete. Otherwise, the item is not deleted.

Parameters
onDeleteItemEventHandlerThe event handler that invokes when the DeleteItem operation is done
void Twoorb.AWS.DynamoDBUtility.DeleteTable ( string  tableName,
DynamoDBDeleteTableEventHandler  onDeleteTableEventHandler 
)

Delete a table

Parameters
tableNameThe name of the table to delete
onDeleteTableEventHandlerThe event handler that invokes when the DeleteTable operation is done
void Twoorb.AWS.DynamoDBUtility.DeleteTable ( DeleteTableRequest  deleteTableRequest,
DynamoDBDeleteTableEventHandler  onDeleteTableEventHandler 
)

Delete a table

Parameters
deleteTableRequestContainer for the parameters to the DeleteTable operation.

The DeleteTable operation deletes a table and all of its items. After a DeleteTable request, the specified table is in the DELETING state until Amazon DynamoDB completes the deletion. If the table is in the ACTIVE state, you can delete it. If a table is in CREATING or UPDATING states, then Amazon DynamoDB returns a ResourceInUseException . If the specified table does not exist, Amazon DynamoDB returns a ResourceNotFoundException . If table is already in the DELETING state, no error is returned.

NOTE: Amazon DynamoDB might continue to accept data read and write operations, such as GetItem and PutItem, on a table in the DELETING state until the table deletion is complete.

When you delete a table, any local secondary indexes on that table are also deleted.

Use the DescribeTable API to check the status of the table.

Parameters
onDeleteTableEventHandlerThe event handler that invokes when the DeleteTable operation is done
void Twoorb.AWS.DynamoDBUtility.DescribeTable ( string  tableName,
DynamoDBDescribeTableEventHandler  onDescribeTableEventHandler 
)

Describe a table

Parameters
tableNameThe name of the table to describe
onDescribeTableEventHandlerThe event handler that invokes when the DescribeTable operation is done
void Twoorb.AWS.DynamoDBUtility.DescribeTable ( DescribeTableRequest  describeTableRequest,
DynamoDBDescribeTableEventHandler  onDescribeTableEventHandler 
)

Describe a table

Parameters
describeTableRequestContainer for the parameters to the DescribeTable operation.

Returns information about the table, including the current status of the table, when it was created, the primary key schema, and any indexes on the table.

Parameters
onDescribeTableEventHandlerThe event handler that invokes when the DescribeTable operation is done
void Twoorb.AWS.DynamoDBUtility.GetItem ( string  tableName,
bool  consistentRead,
List< string >  attributesToGet,
Dictionary< string, AttributeValue key,
ReturnConsumedCapacity  returnConsumedCapacity,
DynamoDBGetItemEventHandler  onGetObjectEventHandler 
)

Get an item from a table

Parameters
tableNameThe name of the table containing the requested item.
consistentReadIf set to true, then the operation uses strongly consistent reads; otherwise, eventually consistent reads are used.
attributesToGetThe names of one or more attributes to retrieve. If no attribute names are specified, then all attributes will be returned. If any of the requested attributes are not found, they will not appear in the result.
keyA map of attribute names to AttributeValue objects, representing the primary key of the item to retrieve.
returnConsumedCapacityIf set to TOTAL, ConsumedCapacity is included in the response; if set to NONE (the default), ConsumedCapacity is not included.
onGetObjectEventHandlerThe event handler that invokes when the GetItem operation is done
void Twoorb.AWS.DynamoDBUtility.GetItem ( GetItemRequest  getItemRequest,
DynamoDBGetItemEventHandler  onGetObjectEventHandler 
)

Get an item from a table

Parameters
getItemRequestContainer for the parameters to the GetItem operation.

The GetItem operation returns a set of attributes for the item with the given primary key. If there is no matching item, GetItem does not return any data.

GetItem provides an eventually consistent read by default. If your application requires a strongly consistent read, set ConsistentRead to true . Although a strongly consistent read might take more time than an eventually consistent read, it always returns the last updated value.

Parameters
onGetObjectEventHandlerThe event handler that invokes when the GetItem operation is done
void Twoorb.AWS.DynamoDBUtility.Initialize ( string  accessKey,
string  secretKey,
EAWSRegion  region 
)

Initializes the DynamoDB Utility

Parameters
accessKeyThe AWS access key
secretKeyThe AWS secret key
regionThe server region of this instance. EAWSRegion.USEast1 is default
void Twoorb.AWS.DynamoDBUtility.ListTables ( string  exclusiveStartTableName,
int  returnLimit,
DynamoDBListTablesEventHandler  onListTablesEventHandler 
)

List available tables

Parameters
exclusiveStartTableNameThe name of the table that starts the list. If you already ran a ListTables operation and received a LastEvaluatedTableName value in the response, use that value here to continue the list.
returnLimitA maximum number of table names to return.
onListTablesEventHandlerThe event handler that invokes when the ListTables operation is done
void Twoorb.AWS.DynamoDBUtility.ListTables ( ListTablesRequest  listTablesRequest,
DynamoDBListTablesEventHandler  onListTablesEventHandler 
)

List available tables

Parameters
listTablesRequestContainer for the parameters to the ListTables operation
onListTablesEventHandlerThe event handler that invokes when the ListTables operation is done
void Twoorb.AWS.DynamoDBUtility.Query ( QueryRequest  request,
DynamoDBQueryHandler  onQueryHandler 
)

A Query operation directly accesses items from a table using the table primary key, or from an index using the index key. You must provide a specific hash key value. You can narrow the scope of the query by using comparison operators on the range key value, or on the index key.

Parameters
requestContainer for the parameters to the Query operation.

A Query operation directly accesses items from a table using the table primary key, or from an index using the index key. You must provide a specific hash key value. You can narrow the scope of the query by using comparison operators on the range key value, or on the index key. You can use the ScanIndexForward parameter to get results in forward or reverse order, by range key or by index key.

Queries that do not return results consume the minimum read capacity units according to the type of read.

If the total number of items meeting the query criteria exceeds the result set size limit of 1 MB, the query stops and results are returned to the user with a LastEvaluatedKey to continue the query in a subsequent operation. Unlike a Scan operation, a Query operation never returns an empty result set and a LastEvaluatedKey . The LastEvaluatedKey is only provided if the results exceed 1 MB, or if you have used Limit .

To request a strongly consistent result, set ConsistentRead to true.

Parameters
onQueryHandlerThe event handler that invokes when the Query operation is done
void Twoorb.AWS.DynamoDBUtility.Scan ( ScanRequest  request,
DynamoDBScanHandler  onScanHandler 
)

The Scan operation returns one or more items and item attributes by accessing every item in the table. To have Amazon DynamoDB return fewer items, you can provide a ScanFilter .

Parameters
requestContainer for the parameters to the Scan operation.

The Scan operation returns one or more items and item attributes by accessing every item in the table. To have Amazon DynamoDB return fewer items, you can provide a ScanFilter .

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 with a LastEvaluatedKey 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 filter criteria.

The result set is eventually consistent.

By default, Scan operations proceed sequentially; however, for faster performance on large tables, applications can request a parallel Scan by specifying the Segment and TotalSegments parameters. For more information, see Parallel Scan in the Amazon DynamoDB Developer Guide.

Parameters
onScanHandlerThe event handler that invokes when the Scan operation is done
void Twoorb.AWS.DynamoDBUtility.UpdateItem ( string  tableName,
Dictionary< string, AttributeValue key,
Dictionary< string, AttributeValueUpdate attributeUpdates,
Dictionary< string, ExpectedAttributeValue expectedAttributeValues,
ReturnConsumedCapacity  returnConsumedCapacity,
ReturnItemCollectionMetrics  returnItemCollectionMetrics,
ReturnValue  returnValue,
DynamoDBUpdateItemEventHandler  onUpdateItemEventHandler 
)

Updates an item in a table

Parameters
tableNameThe name of the table containing the item to update.
keyThe primary key that defines the item. Each element consists of an attribute name and a value for that attribute.
attributeUpdatesThe names of attributes to be modified, the action to perform on each, and the new value for each. If you are updating an attribute that is an index key attribute for any indexes on that table, the attribute type must match the index key type defined in the AttributesDefinition of the table description. You can use UpdateItem to update any non-key attributes. Attribute values cannot be null. String and binary type attributes must have lengths greater than zero. Set type attributes must not be empty. Requests with empty values will be rejected with a ValidationException. Each AttributeUpdates element consists of an attribute name to modify, along with the following:
  • Value - The new value, if applicable, for this attribute.
  • Action - Specifies how to perform the update. Valid values for Action are PUT, DELETE, and ADD. The behavior depends on whether the specified primary key already exists in the table. If an item with the specified Key is found in the table:
    • PUT - Adds the specified attribute to the item. If the attribute already exists, it is replaced by the new value.
    • DELETE - If no value is specified, the attribute and its value are removed from the item. The data type of the specified value must match the existing value's data type. If a set of values is specified, then those values are subtracted from the old set. For example, if the attribute value was the set [a,b,c] and the DELETE action specified [a,c], then the final attribute value would be [b]. Specifying an empty set is an error.
    • ADD - If the attribute does not already exist, then the attribute and its values are added to the item. If the attribute does exist, then the behavior of ADD depends on the data type of the attribute:
      • If the existing attribute is a number, and if Value is also a number, then the Value is mathematically added to the existing attribute. If Value is a negative number, then it is subtracted from the existing attribute. <note> If you use ADD to increment or decrement a number value for an item that doesn't exist before the update, Amazon DynamoDB uses 0 as the initial value. In addition, if you use ADD to update an existing item, and intend to increment or decrement an attribute value which does not yet exist, Amazon DynamoDB uses 0 as the initial value. For example, suppose that the item you want to update does not yet have an attribute named itemcount, but you decide to ADD the number 3 to this attribute anyway, even though it currently does not exist. Amazon DynamoDB will create the itemcount attribute, set its initial value to 0, and finally add 3 to it. The result will be a new itemcount attribute in the item, with a value of 3. </note>
      • If the existing data type is a set, and if the Value is also a set, then the Value is added to the existing set. (This is a set operation, not mathematical addition.) For example, if the attribute value was the set [1,2], and the ADD action specified [3], then the final attribute value would be [1,2,3]. An error occurs if an Add action is specified for a set attribute and the attribute type specified does not match the existing set type. Both sets must have the same primitive data type. For example, if the existing data type is a set of strings, the Value must also be a set of strings. The same holds true for number sets and binary sets.
      This action is only valid for an existing attribute whose data type is number or is a set. Do not use ADD for any other data types.
    If no item with the specified Key is found:
    • PUT - Amazon DynamoDB creates a new item with the specified primary key, and then adds the attribute.
    • DELETE - Nothing happens; there is no attribute to delete.
    • ADD
      • Amazon DynamoDB creates an item with the supplied primary key and number (or set of numbers) for the attribute value. The only data types allowed are number and number set; no other data types can be specified.
If you specify any attributes that are part of an index key, then the data types for those attributes must match those of the schema in the table's attribute definition.
expectedAttributeValuesA map of attribute/condition pairs. This is the conditional block for the UpdateItem operation. All the conditions must be met for the operation to succeed. Expected allows you to provide an attribute name, and whether or not Amazon DynamoDB should check to see if the attribute value already exists; or if the attribute value exists and has a particular value before changing it. Each item in Expected represents an attribute name for Amazon DynamoDB to check, along with the following:
  • Value - The attribute value for Amazon DynamoDB to check.
  • Exists - Causes Amazon DynamoDB to evaluate the value before attempting a conditional operation:
    • If Exists is true, Amazon DynamoDB will check to see if that attribute value already exists in the table. If it is found, then the operation succeeds. If it is not found, the operation fails with a ConditionalCheckFailedException.
    • If Exists is false, Amazon DynamoDB assumes that the attribute value does not exist in the table. If in fact the value does not exist, then the assumption is valid and the operation succeeds. If the value is found, despite the assumption that it does not exist, the operation fails with a ConditionalCheckFailedException.
    The default setting for Exists is true. If you supply a Value all by itself, Amazon DynamoDB assumes the attribute exists: You don't have to set Exists to true, because it is implied. Amazon DynamoDB returns a ValidationException if:
    • Exists is true but there is no Value to check. (You expect a value to exist, but don't specify what that value is.)
    • Exists is false but you also specify a Value. (You cannot expect an attribute to have a value, while also expecting it not to exist.)
If you specify more than one condition for Exists, then all of the conditions must evaluate to true. (In other words, the conditions are ANDed together.) Otherwise, the conditional operation will fail.
returnConsumedCapacityIf set to TOTAL, ConsumedCapacity is included in the response; if set to NONE (the default), ConsumedCapacity is not included.
returnItemCollectionMetricsIf set to SIZE, statistics about item collections, if any, that were modified during the operation are returned in the response. If set to NONE (the default), no statistics are returned..
returnValueUse ReturnValues if you want to get the item attributes as they appeared either before or after they were updated. For UpdateItem, the valid values are:
  • NONE - If ReturnValues is not specified, or if its value is NONE, then nothing is returned. (This is the default for ReturnValues.)
  • ALL_OLD - If UpdateItem overwrote an attribute name-value pair, then the content of the old item is returned.
  • UPDATED_OLD - The old versions of only the updated attributes are returned.
  • ALL_NEW - All of the attributes of the new version of the item are returned.
  • UPDATED_NEW - The new versions of only the updated attributes are returned.
onUpdateItemEventHandlerThe event handler that invokes when the UpdateItem operation is done
void Twoorb.AWS.DynamoDBUtility.UpdateItem ( UpdateItemRequest  updateItemRequest,
DynamoDBUpdateItemEventHandler  onUpdateItemEventHandler 
)

Updates an item in a table

Parameters
updateItemRequestContainer for the parameters to the UpdateItem operation.

Edits an existing item's attributes, or inserts a new item if it does not already exist. You can put, delete, or add attribute values. You can also perform a conditional update (insert a new attribute name-value pair if it doesn't exist, or replace an existing name-value pair if it has certain expected attribute values).

In addition to updating an item, you can also return the item's attribute values in the same operation, using the ReturnValues parameter.

Parameters
onUpdateItemEventHandlerThe event handler that invokes when the UpdateItem operation is done
void Twoorb.AWS.DynamoDBUtility.UpdateTable ( string  tableName,
ProvisionedThroughput  throughput,
List< GlobalSecondaryIndexUpdate globalSecondaryIndexUpdates,
DynamoDBUpdateTableEventHandler  onUpdateTableEventHandler 
)

Update a table

Parameters
tableNameThe name of the table to update
throughputThe provisioned throughput settings for the specified table. The settings can be modified using the UpdateTable operation. For current minimum and maximum provisioned throughput values, see Limits in the Amazon DynamoDB Developer Guide.
globalSecondaryIndexUpdatesGlobal Secondary Index
onUpdateTableEventHandlerThe event handler that invokes when the UpdateTable operation is done
void Twoorb.AWS.DynamoDBUtility.UpdateTable ( UpdateTableRequest  updateTableRequest,
DynamoDBUpdateTableEventHandler  onUpdateTableEventHandler 
)

Update a table

Parameters
updateTableRequestContainer for the parameters to the UpdateTable operation.

Updates the provisioned throughput for the given table. Setting the throughput for a table helps you manage performance and is part of the provisioned throughput feature of Amazon DynamoDB.

The provisioned throughput values can be upgraded or downgraded based on the maximums and minimums listed in the Limits section in the Amazon DynamoDB Developer Guide.

The table must be in the ACTIVE state for this operation to succeed. UpdateTable is an asynchronous operation; while executing the operation, the table is in the UPDATING state. While the table is in the UPDATING state, the table still has the provisioned throughput from before the call. The new provisioned throughput setting is in effect only when the table returns to the ACTIVE state after the UpdateTable operation.

You cannot add, modify or delete local secondary indexes using UpdateTable . Local secondary indexes can only be defined at table creation time.

Parameters
onUpdateTableEventHandlerThe event handler that invokes when the UpdateTable operation is done
void Twoorb.AWS.DynamoDBUtility.WaitUntilTableIsReady ( string  tableName,
Action< bool >  onDone,
int  retryCount = 0 
)

Action that polls the table status in intervals until status is active or reached the thresholds(DescribeTableWaitTime and MaxDescribeTableCount properties)

Parameters
tableNameThe table name to wait for
onDoneCallback when the method is done. Returns false if the polling was aborted before ACTIVE state.
retryCountThis method is used recursively. DON'T touch this.

Property Documentation

IAmazonDynamoDB Twoorb.AWS.DynamoDBUtility.Client
get

The DynamoDB client that the utility is using. Use this class if you want to use some of the methods of DynamoDB currently not supported in the DynamoDBUtility class.

Only use this if you know what you are doing.

Returns null if the DynamoDBUtility class isn't Initialized

EDynamoDBState Twoorb.AWS.DynamoDBUtility.CurrentState
get

Gets the current state of the DynamoDBUtility class

float Twoorb.AWS.DynamoDBUtility.DescribeTableWaitTime
getset

The DynamoDBUtility will wait for tables to gets the status ACTIVE after certain actions. For example when creating or updating a table. The DescribeTableWaitTime property gets or sets how many seconds to wait before polling the table status again.

bool Twoorb.AWS.DynamoDBUtility.IsInitialized
get

Returns if the DynamoDBUtility class is Initialized.

int Twoorb.AWS.DynamoDBUtility.MaxBatchRetryCount
getset

When a batch request(get/write) completes, some items or keys can still be unprocessed. The MaxBatchRetryCount gets or sets how many times the system should try and process the unprocessed items(if there are any)

int Twoorb.AWS.DynamoDBUtility.MaxDescribeTableCount
getset

The DynamoDBUtility will wait for tables to gets the status ACTIVE after certain actions. For example when creating or updating a table. The MaxDescribeTableCount property gets or sets how many times it should poll the table status before giving up.


The documentation for this class was generated from the following file: