Add /$count support for $select #2050

mikepizzo · 2025-02-19T04:44:51Z

Fixes #2046

HeikoTheissen · 2025-02-19T07:26:51Z

odata-url-conventions/5 Query Options.md

@@ -2017,7 +2017,8 @@ properties of the identified instances of a structured type, optionally followed
 related entity or entities, optionally followed by a [type-cast segment](#AddressingDerivedTypes)
 to expand only related entities of that derived type or one of its
 sub-types, optionally followed by `/$ref` to expand only entity
-references.
+references, or `/$count`, optionally with expand options, to return only the count of 


Suggested change

references, or `/$count`, optionally with expand options, to return only the count of

references, or `/$count`, optionally with expand options [#OData-Protocol#ExpandOptions], to return only the count of

HeikoTheissen · 2025-02-19T07:30:36Z

odata-url-conventions/5 Query Options.md

-http://host/service/Categories?$expand=Products($filter=DiscontinuedDate eq null)
-```
-:::
-
 The `$count` segment can be appended to a navigation property name or


Isn't this paragraph a repetition of the third bullet point above?

HeikoTheissen · 2025-02-19T07:37:17Z

odata-url-conventions/5 Query Options.md

+The [Expand Options](#ExpandOptions) [`$filter`](#SystemQueryOptionfilter),
 [`$search`](#SystemQueryOptionsearch),
 [`$skip`](#SystemQueryOptionstopandskip),
 [`$top`](#SystemQueryOptionstopandskip), and
-[`$count`](#SystemQueryOptioncount) can be used to limit the number of
+[`$count`](#SystemQueryOptioncount) can be used to include the count of
 expanded entity references.


The [Expand Options](#ExpandOptions) [`$filter`](#SystemQueryOptionfilter), [`$search`](#SystemQueryOptionsearch), [`$skip`](#SystemQueryOptionstopandskip), [`$top`](#SystemQueryOptionstopandskip) can be used to limit the collection of expanded entity references, and [`$count`](#SystemQueryOptioncount) can be used to include not the entity references themselves but their count.

HeikoTheissen · 2025-02-19T07:41:28Z

odata-url-conventions/5 Query Options.md

@@ -2207,7 +2211,7 @@ grammar of the `$select` query option.

 The value of `$select` is a comma-separated list of select items. Each
 select item is one of the following:
- a path, to include a property,
+- a path, optionally followed by a count segment or select options


Suggested change

- a path, optionally followed by a count segment or select options

- a path, optionally followed by a [count segment](#AddressingtheCountofaCollection) or [select options](#SelectOptions)

HeikoTheissen · 2025-02-19T07:46:13Z

odata-url-conventions/5 Query Options.md

-select options specified in more than one place in a request and MUST
-NOT be specified in more than one expand.
+If the path ends in a collection of primitive or complex values, 
+then the count segment (`/$count`), optionally followed by the 


Suggested change

then the count segment (`/$count`), optionally followed by the

then the [count segment](#AddressingtheCountofaCollection) (`/$count`), optionally followed by the

HeikoTheissen · 2025-02-19T07:48:12Z

odata-url-conventions/5 Query Options.md

@@ -2370,6 +2373,39 @@ of properties, open properties, navigation properties, actions and
 functions to be returned is equal to the union of the set of those
 identified by each select item.

+#### ##subsubsubsec SelectOptions


Suggested change

#### ##subsubsubsec SelectOptions

#### ##subsubsubsec Select Options

HeikoTheissen · 2025-02-19T07:50:39Z

odata-url-conventions/5 Query Options.md

+Allowed system query options are
+[`$compute`](#SystemQueryOptioncompute),
+[`$select`](#SystemQueryOptionselect),
+`$expand`, and
+[`$levels`](#ExpandOptionlevels) for all navigation properties, plus
+[`$filter`](#SystemQueryOptionfilter),
+[`$orderby`](#SystemQueryOptionorderby),
+[`$skip`](#SystemQueryOptionstopandskip), [`$top`](#SystemQueryOptionstopandskip),
+[`$count`](#SystemQueryOptioncount), and
+[`$search`](#SystemQueryOptionsearch)
+for collection-valued navigation properties.


Why is this an explicit list whereas section "Select Options" below refers to section "System Query Options"?

HeikoTheissen · 2025-02-19T07:52:51Z

odata-url-conventions/5 Query Options.md

+[System Query Options](#SystemQueryOptions), with the exception of
+[`$expand`](#SystemQueryOptionexpand). The same property MUST NOT have
+select options specified in more than one place in a request and MUST
+NOT be specified in more than one expand.


What does "more than one expand" mean, given that $expand is ruled out above?

ralfhandl · 2025-02-19T08:30:47Z

odata-url-conventions/5 Query Options.md

@@ -2224,7 +2228,7 @@ properties defined on the derived type.
 A path can end with
 - the name of a property or
 non-entity-valued instance annotation of the identified
-instance of a structured type,
+instance of a structured type


Suggested change

instance of a structured type

instance of a structured type,

same as in other bullet points

mikepizzo added 2 commits February 18, 2025 20:43

Add description of /$count to $select; rationalize wording in $expand.

fcedf5d

Merge branch 'main' into odata2046

0ce5e2b

mikepizzo requested review from HeikoTheissen and ralfhandl February 19, 2025 04:45

mikepizzo self-assigned this Feb 19, 2025

HeikoTheissen reviewed Feb 19, 2025

View reviewed changes

ralfhandl reviewed Feb 19, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add /$count support for $select #2050

Add /$count support for $select #2050

mikepizzo commented Feb 19, 2025

HeikoTheissen Feb 19, 2025

HeikoTheissen Feb 19, 2025

HeikoTheissen Feb 19, 2025

HeikoTheissen Feb 19, 2025

HeikoTheissen Feb 19, 2025

HeikoTheissen Feb 19, 2025

HeikoTheissen Feb 19, 2025

HeikoTheissen Feb 19, 2025

ralfhandl Feb 19, 2025 •

edited

Loading

	references, or `/$count`, optionally with expand options, to return only the count of
	references, or `/$count`, optionally with expand options [#OData-Protocol#ExpandOptions], to return only the count of

	- a path, optionally followed by a count segment or select options
	- a path, optionally followed by a [count segment](#AddressingtheCountofaCollection) or [select options](#SelectOptions)

	then the count segment (`/$count`), optionally followed by the
	then the [count segment](#AddressingtheCountofaCollection) (`/$count`), optionally followed by the

	#### ##subsubsubsec SelectOptions
	#### ##subsubsubsec Select Options

Add /$count support for $select #2050

Are you sure you want to change the base?

Add /$count support for $select #2050

Conversation

mikepizzo commented Feb 19, 2025

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ralfhandl Feb 19, 2025 • edited Loading

Choose a reason for hiding this comment

ralfhandl Feb 19, 2025 •

edited

Loading