Amazon SimpleDB
Getting Started Guide (API Version 2009-04-15)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

Create and Verify a Domain in Amazon SimpleDB

The first step in storing data within Amazon SimpleDB is to create one or more domains.

Launch instance

Domains are similar to database tables, except that you cannot perform functions across multiple domains, such as querying multiple domains or using foreign keys. As a consequence, you should plan an Amazon SimpleDB data architecture that will meet the needs of your project.

All data that might be searched in a single query must be grouped using a single domain. For example, a web commerce application might contain a customer domain that contains all customer data (name, address, phone, and so on) and a products domain that contains all product information (name, description, price, cost, and so on).

[Note]Note

Although the Amazon SimpleDB API does not perform queries across multiple domains, you can design your applications to perform queries across multiple domains.

To create and verify a domain

  1. Select Create Domain from the scratchpad Explore API list box.

    The CreateDomain page displays.

  2. Enter MyStore in the Domain Name field.

  3. Click Invoke Request.

    Amazon SimpleDB returns a response.

  4. To verify the domain was created successfully, select ListDomains from the scratchpad Explore API list box.

    The ListDomains page displays.

  5. Click Invoke Request.

    Amazon SimpleDB returns a list of all domains that belong to your account, including the newly created MyStore domain. The list is returned as an XML file with each domain identified within a DomainName tag, and the DomainName tag is nested as follows: ListDomainsResponse > ListDomainsResult > DomainName. You can open the XML file in a Web browser to see the results.

[Tip]Tip

You can view the signed URL that the scratchpad uses to make the request by clicking Display Signed URL. You can also click Display String to Sign to view the string that the scratchpad uses to generate the authentication signature.

 

Add items