| Standardization Attribute | +Capability | +
| S1 | +
+ Separating models and commands
+
+
+ Example+ +
|
+
| S2 | +
+ Model filtering
+ +
+
+ Example+ Get a list of articles published this year + +```graphql + query articlesThisYear { + articles(where: {publishDate: {_gt: "2024-01-01"}}) { + id + name + } + } +``` + |
+
| S3 | +
+ Model sorting
+
+
+ Example+ Get a list of articles sorted in reverse by the date of publishing + + ```graphql + query sortedArticles { + article(order_by: {publishDate: desc}) { + id + title + author_id + } + } + ``` + |
+
| S4 | +
+ Model pagination
+
+
+ Example+ Paginate the above list with 20 objects per page and fetch the 3rd page + + ```graphql + query sortedArticlesThirdPage { + article(order_by: {publishDate: desc}, offset: 40, limit: 20) { + id + title + author_id + } + } + ``` + |
+
| S5 | +
+ Model aggregations over fields
+
+
+ Example+ Get a count of authors and their average age + + ```graphql + query authorStatistics { + author_aggregate { + aggregate { + count # basic aggregation support by any model + avg { # supported over any numeric fields of a type + age + } + + } + } + } + ``` + |
+
| Composability Attribute | +Capability | Description | +
| C1 | +Joining data | +Join related data together in a "foreign key" like join
+
+
+Example+Get a list of authors and their articles + +```graphql +query authorWithArticles { + author { + id + name + articles { + id + title + } + } +} +``` + |
+
+
+
| C2 | +Nested filtering | +Filter a parent by a property of its child (i.e. a property of a related entity)
+
+
+Example+Get a list of authors whose have published an article this year + +```graphql +query recentlyActiveAuthors { + author(where: {articles: {publishDate: {_gt: "2024-01-01"}}}) { + id + name + } +} +``` + |
+
| C3 | +Nested sorting | +Sort a parent by a property of its child (i.e. a property of a related entity)
+
+
+Example+Get a list of articles sorted by the names of their author + +```graphql +query sortedArticles { + article(order_by: {author: {name: asc}}) { + id + title + } +} +``` + |
+
| C4 | Nested pagination | +Fetch a paginated list of parents, along with a paginated & sorted list of children for each parent
+
+
+Example+Get the 2nd page of a list of authors and the first page of their articles, sorted by the article's title field + +```graphql +query paginatedAuthorsWithSortedPaginatedArticles { + author(offset: 10, limit: 20) { + id + name + articles(offset: 0, limit: 25, order_by: {title: asc}) { + title + publishDate + } + } +} +``` + |
+
| C5 | Nested aggregation | +Aggregate a child/parent in the context of its parent/child
+
+
+Example+Get a list of authors and the number of articles written by each author + +```graphql +query prolificAuthors { + author (limit: 10) { + id + name + articles_aggregate { + count + } + } +} +``` + |
+