Network.AWS.SDB.Select

The Select operation returns a set of attributes for ItemNames that match the select expression. Select is similar to the standard SQL SELECT statement.

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 NextToken so the client can access the next page of results.

For information on how to construct select expressions, see Using Select to Create Amazon SimpleDB Queries in the Developer Guide.

This operation returns paginated results.

Creating a Request

select

Arguments

:: Text

sSelectExpression

-> Select

Creates a value of Select with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• sConsistentRead
• sNextToken
• sSelectExpression

data Select

See: select smart constructor.

Instances

Eq Select

Methods

(==) :: Select -> Select -> Bool

(/=) :: Select -> Select -> Bool

Data Select

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> Select -> c Select

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c Select

toConstr :: Select -> Constr

dataTypeOf :: Select -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c Select)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c Select)

gmapT :: (forall b. Data b => b -> b) -> Select -> Select

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> Select -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> Select -> r

gmapQ :: (forall d. Data d => d -> u) -> Select -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> Select -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> Select -> m Select

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> Select -> m Select

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> Select -> m Select

Read Select

Methods

readsPrec :: Int -> ReadS Select

readList :: ReadS [Select]

readPrec :: ReadPrec Select

readListPrec :: ReadPrec [Select]

Show Select

Methods

showsPrec :: Int -> Select -> ShowS

show :: Select -> String

showList :: [Select] -> ShowS

Generic Select

Associated Types

type Rep Select :: * -> *

Methods

from :: Select -> Rep Select x

to :: Rep Select x -> Select

Hashable Select

Methods

hashWithSalt :: Int -> Select -> Int

hash :: Select -> Int

NFData Select

Methods

rnf :: Select -> ()

AWSPager Select

Methods

page :: Select -> Rs Select -> Maybe Select

AWSRequest Select

Associated Types

type Rs Select :: *

Methods

request :: Select -> Request Select

response :: MonadResource m => Logger -> Service -> Proxy * Select -> ClientResponse -> m (Response Select)

ToPath Select

Methods

toPath :: Select -> ByteString

ToHeaders Select

Methods

toHeaders :: Select -> [Header]

ToQuery Select

Methods

toQuery :: Select -> QueryString

type Rep Select

type Rep Select = D1 (MetaData "Select" "Network.AWS.SDB.Select" "amazonka-sdb-1.4.4-E3vIEtGPgC62eYANRobWJk" False) (C1 (MetaCons "Select'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_sConsistentRead") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool))) ((:*:) (S1 (MetaSel (Just Symbol "_sNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_sSelectExpression") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))))

type Rs Select

type Rs Select = SelectResponse

Request Lenses

sConsistentRead :: Lens' Select (Maybe Bool)

Determines whether or not strong consistency should be enforced when data is read from SimpleDB. If true, any data previously written to SimpleDB will be returned. Otherwise, results will be consistent eventually, and the client may not see data that was written immediately before your read.

sNextToken :: Lens' Select (Maybe Text)

A string informing Amazon SimpleDB where to start the next list of ItemNames.

sSelectExpression :: Lens' Select Text

The expression used to query the domain.

Destructuring the Response

selectResponse

Arguments

:: Int

srsResponseStatus

-> SelectResponse

Creates a value of SelectResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• srsItems
• srsNextToken
• srsResponseStatus

data SelectResponse

See: selectResponse smart constructor.

Instances

Eq SelectResponse

Methods

(==) :: SelectResponse -> SelectResponse -> Bool

(/=) :: SelectResponse -> SelectResponse -> Bool

Data SelectResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> SelectResponse -> c SelectResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c SelectResponse

toConstr :: SelectResponse -> Constr

dataTypeOf :: SelectResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c SelectResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c SelectResponse)

gmapT :: (forall b. Data b => b -> b) -> SelectResponse -> SelectResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> SelectResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> SelectResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> SelectResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> SelectResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> SelectResponse -> m SelectResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> SelectResponse -> m SelectResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> SelectResponse -> m SelectResponse

Read SelectResponse

Methods

readsPrec :: Int -> ReadS SelectResponse

readList :: ReadS [SelectResponse]

readPrec :: ReadPrec SelectResponse

readListPrec :: ReadPrec [SelectResponse]

Show SelectResponse

Methods

showsPrec :: Int -> SelectResponse -> ShowS

show :: SelectResponse -> String

showList :: [SelectResponse] -> ShowS

Generic SelectResponse

Associated Types

type Rep SelectResponse :: * -> *

Methods

from :: SelectResponse -> Rep SelectResponse x

to :: Rep SelectResponse x -> SelectResponse

NFData SelectResponse

Methods

rnf :: SelectResponse -> ()

type Rep SelectResponse

type Rep SelectResponse = D1 (MetaData "SelectResponse" "Network.AWS.SDB.Select" "amazonka-sdb-1.4.4-E3vIEtGPgC62eYANRobWJk" False) (C1 (MetaCons "SelectResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_srsItems") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Item]))) ((:*:) (S1 (MetaSel (Just Symbol "_srsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_srsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 Int)))))

Response Lenses

srsItems :: Lens' SelectResponse [Item]

A list of items that match the select expression.

srsNextToken :: Lens' SelectResponse (Maybe Text)

An opaque token indicating that more items than MaxNumberOfItems were matched, the response size exceeded 1 megabyte, or the execution time exceeded 5 seconds.

srsResponseStatus :: Lens' SelectResponse Int

The response status code.