Certain aggregate functions can also be used within SQLAlchemy by using the func module.

To import this module, execute:

from sqlalchemy.sql import func

Once func is imported, the following aggregate functions are available:

COUNT

The following example counts the number of records in a set of groups using the session object's query() method.

rs = session.query(func.count([publicdata].[samples].github_nested.Id).label("CustomCount"), [publicdata].[samples].github_nested.actor.attributes.email).group_by([publicdata].[samples].github_nested.actor.attributes.email)
for instance in rs:
	print("Count: ", instance.CustomCount)
	print("actor.attributes.email: ", instance.actor.attributes.email)
	print("---------")

You can also execute COUNT using the session object's execute() method:

rs = session.execute([publicdata].[samples].github_nested_table.select().with_only_columns([func.count([publicdata].[samples].github_nested_table.c.Id).label("CustomCount"), [publicdata].[samples].github_nested_table.c.actor.attributes.email])group_by([publicdata].[samples].github_nested_table.c.actor.attributes.email))
for instance in rs:

SUM

This example calculates the cumulative amount of a numeric column in a set of groups.

rs = session.query(func.sum([publicdata].[samples].github_nested.repository.watchers).label("CustomSum"), [publicdata].[samples].github_nested.actor.attributes.email).group_by([publicdata].[samples].github_nested.actor.attributes.email)
for instance in rs:
	print("Sum: ", instance.CustomSum)
	print("actor.attributes.email: ", instance.actor.attributes.email)
	print("---------")

You can also invoke SUM using the session object's execute() method.

rs = session.execute([publicdata].[samples].github_nested_table.select().with_only_columns([func.sum([publicdata].[samples].github_nested_table.c.repository.watchers).label("CustomSum"), [publicdata].[samples].github_nested_table.c.actor.attributes.email]).group_by([publicdata].[samples].github_nested_table.c.actor.attributes.email))
for instance in rs:

AVG

This example uses the session object's query() method to calculate the average amount of a numeric column in a set of groups:

rs = session.query(func.avg([publicdata].[samples].github_nested.repository.watchers).label("CustomAvg"), [publicdata].[samples].github_nested.actor.attributes.email).group_by([publicdata].[samples].github_nested.actor.attributes.email)
for instance in rs:
	print("Avg: ", instance.CustomAvg)
	print("actor.attributes.email: ", instance.actor.attributes.email)
	print("---------")

You can also use the session object's execute() method to invoke AVG:

rs = session.execute([publicdata].[samples].github_nested_table.select().with_only_columns([func.avg([publicdata].[samples].github_nested_table.c.repository.watchers).label("CustomAvg"), [publicdata].[samples].github_nested_table.c.actor.attributes.email]).group_by([publicdata].[samples].github_nested_table.c.actor.attributes.email))
for instance in rs:

MAX and MIN

This example finds the maximum value and minimum value of a numeric column in a set of groups.

rs = session.query(func.max([publicdata].[samples].github_nested.repository.watchers).label("CustomMax"), func.min([publicdata].[samples].github_nested.repository.watchers).label("CustomMin"), [publicdata].[samples].github_nested.actor.attributes.email).group_by([publicdata].[samples].github_nested.actor.attributes.email)
for instance in rs:
	print("Max: ", instance.CustomMax)
	print("Min: ", instance.CustomMin)
	print("actor.attributes.email: ", instance.actor.attributes.email)
	print("---------")

You can also use the session object's execute() method to invoke MAX and MIN:

rs = session.execute([publicdata].[samples].github_nested_table.select().with_only_columns([func.max([publicdata].[samples].github_nested_table.c.repository.watchers).label("CustomMax"), func.min([publicdata].[samples].github_nested_table.c.repository.watchers).label("CustomMin"), [publicdata].[samples].github_nested_table.c.actor.attributes.email]).group_by([publicdata].[samples].github_nested_table.c.actor.attributes.email))
for instance in rs: