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.
Implementation for accessing SimpleDB
Amazon SimpleDB is a web service providing the core database functions of data indexing and querying in the cloud. By offloading the time and effort associated with building and operating a web-scale database, SimpleDB provides developers the freedom to focus on application development.A traditional, clustered relational database requires a sizable upfront capital outlay, is complex to design, and often requires extensive and repetitive database administration. Amazon SimpleDB is dramatically simpler, requiring no schema, automatically indexing your data and providing a simple API for storage and access. This approach eliminates the administrative burden of data modeling, index maintenance, and performance tuning. Developers gain access to this functionality within Amazon's proven computing environment, are able to scale instantly, and pay only for what they use.
Visit http://aws.amazon.com/simpledb/ for more information.
Namespace: Amazon.SimpleDB
Assembly: AWSSDK.SimpleDB.dll
Version: 3.x.y.z
public class AmazonSimpleDBClient : AmazonServiceClient IAmazonService, IAmazonSimpleDB, IDisposable
The AmazonSimpleDBClient type exposes the following members
Name | Description | |
---|---|---|
AmazonSimpleDBClient() |
Constructs AmazonSimpleDBClient with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set. <?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <add key="AWSProfileName" value="AWS Default"/> </appSettings> </configuration> |
|
AmazonSimpleDBClient(RegionEndpoint) |
Constructs AmazonSimpleDBClient with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set. <?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <add key="AWSProfileName" value="AWS Default"/> </appSettings> </configuration> |
|
AmazonSimpleDBClient(AmazonSimpleDBConfig) |
Constructs AmazonSimpleDBClient with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set. <?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <add key="AWSProfileName" value="AWS Default"/> </appSettings> </configuration> |
|
AmazonSimpleDBClient(AWSCredentials) |
Constructs AmazonSimpleDBClient with AWS Credentials |
|
AmazonSimpleDBClient(AWSCredentials, RegionEndpoint) |
Constructs AmazonSimpleDBClient with AWS Credentials |
|
AmazonSimpleDBClient(AWSCredentials, AmazonSimpleDBConfig) |
Constructs AmazonSimpleDBClient with AWS Credentials and an AmazonSimpleDBClient Configuration object. |
|
AmazonSimpleDBClient(string, string) |
Constructs AmazonSimpleDBClient with AWS Access Key ID and AWS Secret Key |
|
AmazonSimpleDBClient(string, string, RegionEndpoint) |
Constructs AmazonSimpleDBClient with AWS Access Key ID and AWS Secret Key |
|
AmazonSimpleDBClient(string, string, AmazonSimpleDBConfig) |
Constructs AmazonSimpleDBClient with AWS Access Key ID, AWS Secret Key and an AmazonSimpleDBClient Configuration object. |
|
AmazonSimpleDBClient(string, string, string) |
Constructs AmazonSimpleDBClient with AWS Access Key ID and AWS Secret Key |
|
AmazonSimpleDBClient(string, string, string, RegionEndpoint) |
Constructs AmazonSimpleDBClient with AWS Access Key ID and AWS Secret Key |
|
AmazonSimpleDBClient(string, string, string, AmazonSimpleDBConfig) |
Constructs AmazonSimpleDBClient with AWS Access Key ID, AWS Secret Key and an AmazonSimpleDBClient Configuration object. |
Name | Type | Description | |
---|---|---|---|
Config | Amazon.Runtime.IClientConfig | Inherited from Amazon.Runtime.AmazonServiceClient. |
Name | Description | |
---|---|---|
BatchDeleteAttributes(BatchDeleteAttributesRequest) |
Performs multiple DeleteAttributes operations in a single call, which reduces round trips and latencies. This enables Amazon SimpleDB to optimize requests, which generally yields better throughput. The following limitations are enforced for this operation:
|
|
BatchDeleteAttributesAsync(BatchDeleteAttributesRequest, CancellationToken) |
Performs multiple DeleteAttributes operations in a single call, which reduces round trips and latencies. This enables Amazon SimpleDB to optimize requests, which generally yields better throughput. The following limitations are enforced for this operation:
|
|
BatchPutAttributes(BatchPutAttributesRequest) |
The
The client may specify the item name with the
Attributes are uniquely identified within an item by their name/value combination.
For example, a single item can have the attributes
Optionally, the requester can supply the Expected.X.Name , Expected.X.Value , or Expected.X.Exists .
You can execute multiple The following limitations are enforced for this operation:
|
|
BatchPutAttributesAsync(BatchPutAttributesRequest, CancellationToken) |
The
The client may specify the item name with the
Attributes are uniquely identified within an item by their name/value combination.
For example, a single item can have the attributes
Optionally, the requester can supply the Expected.X.Name , Expected.X.Value , or Expected.X.Exists .
You can execute multiple The following limitations are enforced for this operation:
|
|
CreateDomain(CreateDomainRequest) |
The The client can create up to 100 domains per account. If the client requires additional domains, go to http://aws.amazon.com/contact-us/simpledb-limit-request/. |
|
CreateDomainAsync(CreateDomainRequest, CancellationToken) |
The The client can create up to 100 domains per account. If the client requires additional domains, go to http://aws.amazon.com/contact-us/simpledb-limit-request/. |
|
DeleteAttributes(DeleteAttributesRequest) |
Deletes one or more attributes associated with an item. If all attributes of the item are deleted, the item is deleted.
Because Amazon SimpleDB makes multiple copies of item data and uses an eventual consistency
update model, performing a GetAttributes or Select operation (read)
immediately after a |
|
DeleteAttributesAsync(DeleteAttributesRequest, CancellationToken) |
Deletes one or more attributes associated with an item. If all attributes of the item are deleted, the item is deleted.
Because Amazon SimpleDB makes multiple copies of item data and uses an eventual consistency
update model, performing a GetAttributes or Select operation (read)
immediately after a |
|
DeleteDomain(DeleteDomainRequest) |
The |
|
DeleteDomainAsync(DeleteDomainRequest, CancellationToken) |
The |
|
DetermineServiceOperationEndpoint(AmazonWebServiceRequest) |
Returns the endpoint that will be used for a particular request. |
|
Dispose() | Inherited from Amazon.Runtime.AmazonServiceClient. | |
DomainMetadata(DomainMetadataRequest) |
Returns information about the domain, including when the domain was created, the number of items and attributes in the domain, and the size of the attribute names and values. |
|
DomainMetadataAsync(DomainMetadataRequest, CancellationToken) |
Returns information about the domain, including when the domain was created, the number of items and attributes in the domain, and the size of the attribute names and values. |
|
GetAttributes(GetAttributesRequest) |
Returns all of the attributes associated with the specified item. Optionally, the attributes returned can be limited to one or more attributes by specifying an attribute name parameter. If the item does not exist on the replica that was accessed for this operation, an empty set is returned. The system does not return an error as it cannot guarantee the item does not exist on other replicas. |
|
GetAttributesAsync(GetAttributesRequest, CancellationToken) |
Returns all of the attributes associated with the specified item. Optionally, the attributes returned can be limited to one or more attributes by specifying an attribute name parameter. If the item does not exist on the replica that was accessed for this operation, an empty set is returned. The system does not return an error as it cannot guarantee the item does not exist on other replicas. |
|
ListDomains() |
The |
|
ListDomains(ListDomainsRequest) |
The |
|
ListDomainsAsync(CancellationToken) |
The |
|
ListDomainsAsync(ListDomainsRequest, CancellationToken) |
The |
|
PutAttributes(PutAttributesRequest) |
The PutAttributes operation creates or replaces attributes in an item. The client
may specify new attributes using a combination of the
Attributes are uniquely identified in an item by their name/value combination. For
example, a single item can have the attributes
Optionally, the requestor can supply the You cannot specify an empty string as an attribute name. Because Amazon SimpleDB makes multiple copies of client data and uses an eventual consistency update model, an immediate GetAttributes or Select operation (read) immediately after a PutAttributes or DeleteAttributes operation (write) might not return the updated data. The following limitations are enforced for this operation:
|
|
PutAttributesAsync(PutAttributesRequest, CancellationToken) |
The PutAttributes operation creates or replaces attributes in an item. The client
may specify new attributes using a combination of the
Attributes are uniquely identified in an item by their name/value combination. For
example, a single item can have the attributes
Optionally, the requestor can supply the You cannot specify an empty string as an attribute name. Because Amazon SimpleDB makes multiple copies of client data and uses an eventual consistency update model, an immediate GetAttributes or Select operation (read) immediately after a PutAttributes or DeleteAttributes operation (write) might not return the updated data. The following limitations are enforced for this operation:
|
|
Select(SelectRequest) |
The
The total size of the response cannot exceed 1 MB in total size. Amazon SimpleDB
automatically adjusts the number of items returned per page to enforce this limit.
For example, if the client asks to retrieve 2500 items, but each individual item is
10 kB in size, the system returns 100 items and an appropriate For information on how to construct select expressions, see Using Select to Create Amazon SimpleDB Queries in the Developer Guide. |
|
SelectAsync(SelectRequest, CancellationToken) |
The
The total size of the response cannot exceed 1 MB in total size. Amazon SimpleDB
automatically adjusts the number of items returned per page to enforce this limit.
For example, if the client asks to retrieve 2500 items, but each individual item is
10 kB in size, the system returns 100 items and an appropriate For information on how to construct select expressions, see Using Select to Create Amazon SimpleDB Queries in the Developer Guide. |
Name | Description | |
---|---|---|
AfterResponseEvent | Inherited from Amazon.Runtime.AmazonServiceClient. | |
BeforeRequestEvent | Inherited from Amazon.Runtime.AmazonServiceClient. | |
ExceptionEvent | Inherited from Amazon.Runtime.AmazonServiceClient. |
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5, 4.0, 3.5