Analytics SAQL Developer Guide
jNewer Version Available
group-by
Organizes the rows returned from a query into groups. Within each group, you can apply
an aggregate function, such as count() or sum() to get the number of items or sum,
respectively.
Syntax
group-by takes this syntax.
- data_stream
- Data input to group.
- fields
- Fields by which data is grouped.
Group-by One Field
In this example, the query counts the number of rows for each Category field and groups the counts by
category.
| Category | Count of Rows |
|---|---|
| Furniture | 2,121 |
| Office Supplies | 6,026 |
| Technology | 1,847 |
Group-by with Null Values
To return grouped null values in your queries, you must select the preference to include null values in Setup. Otherwise, queries ignore null values.
- In Setup, enter Analytics in the Quick Find box.
- Select Settings from the list of Analytics options.
- In Settings, click the checkbox for Include null values in Analytics queries.
Here’s an example of a query that returns null values. It orders the results by the Sub_Category field and specifies that the results display in ascending order, with nulls first.
| Sub-Category | Count of Rows |
|---|---|
| - | 4 |
| Accessories | 775 |
| Appliances | 466 |
| Art | 796 |
| Binders | 1,523 |
| Bookcases | 228 |
| Chairs | 617 |
| Copiers | 68 |
| Envelopes | 254 |
| Fasteners | 217 |
| Furnishings | 957 |
| Labels | 364 |
| Machines | 115 |
| Paper | 1,370 |
| Phones | 889 |
| Storage | 846 |
| Supplies | 190 |
| Tables | 319 |
Group-by all
In this example, the query counts all of the rows and returns the number of different industries that you have opportunities with.
| # | Unique of Industry |
|---|---|
| 1 | 20 |