1{-# language DataKinds #-}
2{-# language FlexibleContexts #-}
3{-# language ScopedTypeVariables #-}
4{-# language TypeApplications #-}
5{-# language TypeFamilies #-}
7{-# options_ghc -fno-warn-redundant-constraints #-}
9module Rel8.Expr.Aggregate
10 ( count, countDistinct, countStar, countWhere
16 , listAggExpr, nonEmptyAggExpr
22import Data.Int ( Int64 )
23import Data.List.NonEmpty ( NonEmpty )
24import Prelude hiding ( and, max, min, null, or, sum )
27import qualified Opaleye.Internal.HaskellDB.PrimQuery as Opaleye
30import Rel8.Aggregate ( Aggregate, Aggregator(..), unsafeMakeAggregate )
31import Rel8.Expr ( Expr )
32import Rel8.Expr.Bool ( caseExpr )
33import Rel8.Expr.Opaleye
39import Rel8.Expr.Null ( null )
40import Rel8.Expr.Serialize ( litExpr )
41import Rel8.Schema.Nullability ( Nullability, Sql, nullabilization )
42import Rel8.Type.Array ( fromPrimArray )
43import Rel8.Type.Eq ( DBEq )
44import Rel8.Type.Num ( DBNum )
45import Rel8.Type.Ord ( DBMax, DBMin )
46import Rel8.Type.String ( DBString )
47import Rel8.Type.Sum ( DBSum )
50-- | Count the occurances of a single column. Corresponds to @COUNT(a)@
51count :: Expr a -> Aggregate (Expr Int64)
52count = unsafeMakeAggregate toPrimExpr fromPrimExpr $
54 { operation = Opaleye.AggrCount
56 , distinction = Opaleye.AggrAll
60-- | Count the number of distinct occurances of a single column. Corresponds to
62countDistinct :: DBEq a => Expr a -> Aggregate (Expr Int64)
63countDistinct = unsafeMakeAggregate toPrimExpr fromPrimExpr $
65 { operation = Opaleye.AggrCount
67 , distinction = Opaleye.AggrDistinct
71-- | Corresponds to @COUNT(*)@.
72countStar :: Aggregate (Expr Int64)
73countStar = count (litExpr True)
76-- | A count of the number of times a given expression is @true@.
77countWhere :: Expr Bool -> Aggregate (Expr Int64)
78countWhere condition = count (caseExpr [(condition, litExpr (Just True))] null)
81-- | Corresponds to @bool_and@.
82and :: Expr Bool -> Aggregate (Expr Bool)
83and = unsafeMakeAggregate toPrimExpr fromPrimExpr $
85 { operation = Opaleye.AggrBoolAnd
87 , distinction = Opaleye.AggrAll
91-- | Corresponds to @bool_or@.
92or :: Expr Bool -> Aggregate (Expr Bool)
93or = unsafeMakeAggregate toPrimExpr fromPrimExpr $
95 { operation = Opaleye.AggrBoolOr
97 , distinction = Opaleye.AggrAll
101-- | Produce an aggregation for @Expr a@ using the @max@ function.
102max :: Sql DBMax a => Expr a -> Aggregate (Expr a)
103max = unsafeMakeAggregate toPrimExpr fromPrimExpr $
105 { operation = Opaleye.AggrSum
107 , distinction = Opaleye.AggrAll
111-- | Produce an aggregation for @Expr a@ using the @max@ function.
112min :: Sql DBMin a => Expr a -> Aggregate (Expr a)
113min = unsafeMakeAggregate toPrimExpr fromPrimExpr $
115 { operation = Opaleye.AggrSum
117 , distinction = Opaleye.AggrAll
120-- | Corresponds to @sum@. Note that in SQL, @sum@ is type changing - for
121-- example the @sum@ of @integer@ returns a @bigint@. Rel8 doesn't support
122-- this, and will add explicit cast back to the original input type. This can
123-- lead to overflows, and if you anticipate very large sums, you should upcast
125sum :: Sql DBSum a => Expr a -> Aggregate (Expr a)
126sum = unsafeMakeAggregate toPrimExpr (castExpr . fromPrimExpr) $
128 { operation = Opaleye.AggrSum
130 , distinction = Opaleye.AggrAll
134sumWhere :: (Sql DBNum a, Sql DBSum a)
135 => Expr Bool -> Expr a -> Aggregate (Expr a)
136sumWhere condition a = sum (caseExpr [(condition, a)] 0)
139-- | Corresponds to @string_agg()@.
140stringAgg :: Sql DBString a
141 => Expr db -> Expr a -> Aggregate (Expr a)
143 unsafeMakeAggregate toPrimExpr (castExpr . fromPrimExpr) $
145 { operation = Opaleye.AggrStringAggr (toPrimExpr delimiter)
147 , distinction = Opaleye.AggrAll
151-- | Aggregate a value by grouping by it.
152groupByExpr :: Sql DBEq a => Expr a -> Aggregate (Expr a)
153groupByExpr = sgroupByExpr nullabilization
156listAggExpr :: Expr a -> Aggregate (Expr [a])
157listAggExpr = unsafeMakeAggregate toPrimExpr from $ Just
159 { operation = Opaleye.AggrArr
161 , distinction = Opaleye.AggrAll
164 from = fromPrimExpr . fromPrimArray
167nonEmptyAggExpr :: Expr a -> Aggregate (Expr (NonEmpty a))
168nonEmptyAggExpr = unsafeMakeAggregate toPrimExpr from $ Just
170 { operation = Opaleye.AggrArr
172 , distinction = Opaleye.AggrAll
175 from = fromPrimExpr . fromPrimArray
178sgroupByExpr :: DBEq db => Nullability db a -> Expr a -> Aggregate (Expr a)
179sgroupByExpr _ = unsafeMakeAggregate toPrimExpr fromPrimExpr Nothing
keysesc to close
- j k
- move down, up
- enter
- open
- esc
- back, or up a level
- 1 2 3 4
- readme, files, commits, refs
- /
- filter
- y
- copy the clone command
- c
- compare the chosen commit with another (or shift-click both)
- ?
- show or hide this list