Copyright	(c) 2013-2018 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None
Language	Haskell2010

Network.AWS.SDB.Select

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

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.

Synopsis

select :: Text -> Select
data Select
sConsistentRead :: Lens' Select (Maybe Bool)
sNextToken :: Lens' Select (Maybe Text)
sSelectExpression :: Lens' Select Text
selectResponse :: Int -> SelectResponse
data SelectResponse
srsItems :: Lens' SelectResponse [Item]
srsNextToken :: Lens' SelectResponse (Maybe Text)
srsResponseStatus :: Lens' SelectResponse Int

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 - true
sNextToken - ItemNames
sSelectExpression - The expression used to query the domain.

data Select #

See: select smart constructor.

Instances

Eq Select #
Instance details Defined in Network.AWS.SDB.Select Methods (==) :: Select -> Select -> Bool # (/=) :: Select -> Select -> Bool #
Data Select #
Instance details Defined in Network.AWS.SDB.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 #
Instance details Defined in Network.AWS.SDB.Select Methods readsPrec :: Int -> ReadS Select # readList :: ReadS [Select] # readPrec :: ReadPrec Select # readListPrec :: ReadPrec [Select] #
Show Select #
Instance details Defined in Network.AWS.SDB.Select Methods showsPrec :: Int -> Select -> ShowS # show :: Select -> String # showList :: [Select] -> ShowS #
Generic Select #
Instance details Defined in Network.AWS.SDB.Select Associated Types type Rep Select :: Type -> Type # Methods from :: Select -> Rep Select x # to :: Rep Select x -> Select #
Hashable Select #
Instance details Defined in Network.AWS.SDB.Select Methods hashWithSalt :: Int -> Select -> Int # hash :: Select -> Int #
AWSPager Select #
Instance details Defined in Network.AWS.SDB.Select Methods page :: Select -> Rs Select -> Maybe Select #
AWSRequest Select #
Instance details Defined in Network.AWS.SDB.Select Associated Types type Rs Select :: Type # Methods request :: Select -> Request Select # response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy Select -> ClientResponse -> m (Response Select) #
ToHeaders Select #
Instance details Defined in Network.AWS.SDB.Select Methods toHeaders :: Select -> [Header] #
ToPath Select #
Instance details Defined in Network.AWS.SDB.Select Methods toPath :: Select -> ByteString #
ToQuery Select #
Instance details Defined in Network.AWS.SDB.Select Methods toQuery :: Select -> QueryString #
NFData Select #
Instance details Defined in Network.AWS.SDB.Select Methods rnf :: Select -> () #
type Rep Select #
Instance details Defined in Network.AWS.SDB.Select type Rep Select = D1 (MetaData "Select" "Network.AWS.SDB.Select" "amazonka-sdb-1.6.1-HNtIO18ACdo5F79r0DfFY9" False) (C1 (MetaCons "Select'" PrefixI True) (S1 (MetaSel (Just "_sConsistentRead") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool)) :: (S1 (MetaSel (Just "_sNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :: S1 (MetaSel (Just "_sSelectExpression") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))))
type Rs Select #
Instance details Defined in Network.AWS.SDB.Select type Rs Select = SelectResponse

Request Lenses

sConsistentRead :: Lens' Select (Maybe Bool) #

true

sNextToken :: Lens' Select (Maybe Text) #

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 - A list of items that match the select expression.
srsNextToken - MaxNumberOfItems
srsResponseStatus - -- | The response status code.

data SelectResponse #

See: selectResponse smart constructor.

Instances

Eq SelectResponse #
Instance details Defined in Network.AWS.SDB.Select Methods (==) :: SelectResponse -> SelectResponse -> Bool # (/=) :: SelectResponse -> SelectResponse -> Bool #
Data SelectResponse #
Instance details Defined in Network.AWS.SDB.Select 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 #
Instance details Defined in Network.AWS.SDB.Select Methods readsPrec :: Int -> ReadS SelectResponse # readList :: ReadS [SelectResponse] # readPrec :: ReadPrec SelectResponse # readListPrec :: ReadPrec [SelectResponse] #
Show SelectResponse #
Instance details Defined in Network.AWS.SDB.Select Methods showsPrec :: Int -> SelectResponse -> ShowS # show :: SelectResponse -> String # showList :: [SelectResponse] -> ShowS #
Generic SelectResponse #
Instance details Defined in Network.AWS.SDB.Select Associated Types type Rep SelectResponse :: Type -> Type # Methods from :: SelectResponse -> Rep SelectResponse x # to :: Rep SelectResponse x -> SelectResponse #
NFData SelectResponse #
Instance details Defined in Network.AWS.SDB.Select Methods rnf :: SelectResponse -> () #
type Rep SelectResponse #
Instance details Defined in Network.AWS.SDB.Select type Rep SelectResponse = D1 (MetaData "SelectResponse" "Network.AWS.SDB.Select" "amazonka-sdb-1.6.1-HNtIO18ACdo5F79r0DfFY9" False) (C1 (MetaCons "SelectResponse'" PrefixI True) (S1 (MetaSel (Just "_srsItems") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Item])) :: (S1 (MetaSel (Just "_srsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :: S1 (MetaSel (Just "_srsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))

Response Lenses

srsItems :: Lens' SelectResponse [Item] #

A list of items that match the select expression.

srsNextToken :: Lens' SelectResponse (Maybe Text) #

MaxNumberOfItems

srsResponseStatus :: Lens' SelectResponse Int #

- | The response status code.