Back to Paradedb

Sum

docs/documentation/aggregates/metrics/sum.mdx

0.23.32.9 KB
Original Source

The sum aggregation computes the sum of a field.

<CodeGroup> ```sql SQL SELECT pdb.agg('{"sum": {"field": "rating"}}') FROM mock_items WHERE id @@@ pdb.all(); ```
python
from paradedb import Agg, All, ParadeDB

MockItem.objects.filter(
    id=ParadeDB(All())
).aggregate(agg=Agg('{"sum": {"field": "rating"}}'))
python
from sqlalchemy import select
from sqlalchemy.orm import Session
from paradedb.sqlalchemy import facets, pdb, search

stmt = (
    select(pdb.agg(facets.sum(field="rating")))
    .select_from(MockItem)
    .where(search.all(MockItem.id))
)

with Session(engine) as session:
    session.execute(stmt).all()
ruby
MockItem.search(:id)
        .match_all
        .facets_agg(agg: ParadeDB::Aggregations.sum(:rating))
</CodeGroup>
ini
       agg
------------------
 {"value": 158.0}
(1 row)

See the Tantivy documentation for all available options.

SQL Sum Syntax

SQL's SUM syntax is supported in beta. To enable it, first run

sql
SET paradedb.enable_aggregate_custom_scan TO on;

With this feature enabled, the following query is equivalent to the above and is executed in the same way.

<CodeGroup> ```sql SQL SELECT SUM(rating) FROM mock_items WHERE id @@@ pdb.all(); ```
python
from django.db.models import Sum
from paradedb import All, ParadeDB

MockItem.objects.filter(
    id=ParadeDB(All())
).aggregate(total=Sum('rating'))
python
from sqlalchemy import func, select
from sqlalchemy.orm import Session
from paradedb.sqlalchemy import search

stmt = (
    select(func.sum(MockItem.rating))
    .select_from(MockItem)
    .where(search.all(MockItem.id))
)

with Session(engine) as session:
    session.execute(stmt).all()
ruby
MockItem.search(:id).match_all.sum(:rating)
</CodeGroup>

By default, SUM ignores null values. Use COALESCE to include them in the final sum:

<CodeGroup> ```sql SQL SELECT SUM(COALESCE(rating, 0)) FROM mock_items WHERE id @@@ pdb.all(); ```
python
from django.db.models import Sum, Value
from django.db.models.functions import Coalesce
from paradedb import All, ParadeDB

MockItem.objects.filter(
    id=ParadeDB(All())
).aggregate(total=Sum(Coalesce('rating', Value(0))))
python
from sqlalchemy import func, select
from sqlalchemy.orm import Session
from paradedb.sqlalchemy import search

stmt = (
    select(func.sum(func.coalesce(MockItem.rating, 0)))
    .select_from(MockItem)
    .where(search.all(MockItem.id))
)

with Session(engine) as session:
    session.execute(stmt).all()
ruby
rating = MockItem.arel_table[:rating]
coalesced_rating = Arel::Nodes::NamedFunction.new("COALESCE", [rating, Arel::Nodes.build_quoted(0)])

MockItem.search(:id).match_all.sum(coalesced_rating)
</CodeGroup>