Skip to content

Commit 9e05533

Browse files
docs: Clean up
* Remove view-side view group assignment from docs Generated-By: mintlify-agent
1 parent 8d8d2a9 commit 9e05533

3 files changed

Lines changed: 13 additions & 171 deletions

File tree

docs-mintlify/docs/data-modeling/view-groups.mdx

Lines changed: 5 additions & 78 deletions
Original file line numberDiff line numberDiff line change
@@ -42,16 +42,9 @@ view_group(`sales`, {
4242

4343
## Assigning views to a group
4444

45-
There are two ways to assign a view to a group, and both can be combined.
46-
Pick whichever keeps group membership co-located with the entity you'd
47-
rather edit — the group definition for a curated catalog, or the view
48-
definition for ad-hoc additions.
49-
50-
### From the group side
51-
52-
List views on the group via the [`views`][ref-view-group-views] parameter.
53-
This keeps the full membership in one place, which is convenient when you
54-
want to review a group at a glance.
45+
To assign a view to a group, list its name on the group via the
46+
[`views`][ref-view-group-views] parameter. This keeps the full
47+
membership in one place, which makes it easy to review a group at a glance.
5548

5649
<CodeGroup>
5750

@@ -73,72 +66,8 @@ view_group(`sales`, {
7366

7467
</CodeGroup>
7568

76-
### From the view side
77-
78-
Set [`view_group`][ref-view-view-group] on the view itself. The view
79-
declares which group it belongs to, without touching the group definition.
80-
81-
<CodeGroup>
82-
83-
```yaml title="YAML"
84-
views:
85-
- name: revenue
86-
view_group: sales
87-
cubes:
88-
- join_path: order_items
89-
includes:
90-
- total_sale_price
91-
- created_at
92-
```
93-
94-
```javascript title="JavaScript"
95-
view(`revenue`, {
96-
view_group: sales,
97-
cubes: [
98-
{
99-
join_path: order_items,
100-
includes: [`total_sale_price`, `created_at`]
101-
}
102-
]
103-
})
104-
```
105-
106-
</CodeGroup>
107-
108-
### Belonging to multiple groups
109-
110-
A view can belong to more than one group. Use
111-
[`view_groups`][ref-view-view-groups] (plural) on the view to list every
112-
group it should appear in.
113-
114-
<CodeGroup>
115-
116-
```yaml title="YAML"
117-
views:
118-
- name: revenue
119-
view_groups:
120-
- sales
121-
- finance
122-
cubes:
123-
- join_path: order_items
124-
includes:
125-
- total_sale_price
126-
- created_at
127-
```
128-
129-
```javascript title="JavaScript"
130-
view(`revenue`, {
131-
view_groups: [sales, finance],
132-
cubes: [
133-
{
134-
join_path: order_items,
135-
includes: [`total_sale_price`, `created_at`]
136-
}
137-
]
138-
})
139-
```
140-
141-
</CodeGroup>
69+
A view can belong to more than one group — list it under the `views`
70+
parameter of every group it should appear in.
14271

14372
## Where view groups live in the model
14473

@@ -160,6 +89,4 @@ entity and can be split across multiple files as your model grows.
16089
[ref-ai-context]: /docs/data-modeling/ai-context
16190
[ref-view-group-ref]: /reference/data-modeling/view-group
16291
[ref-view-group-views]: /reference/data-modeling/view-group#views
163-
[ref-view-view-group]: /reference/data-modeling/view#view_group
164-
[ref-view-view-groups]: /reference/data-modeling/view#view_groups
16592
[ref-meta-endpoint]: /reference/core-data-apis/rest-api/reference

docs-mintlify/reference/data-modeling/view-group.mdx

Lines changed: 7 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -81,10 +81,7 @@ view_group(`sales`, {
8181

8282
### `views`
8383

84-
A list of view names that belong to this group. Views listed here are
85-
merged with any views that reference this group via their own
86-
[`view_group`][ref-view-view-group] or
87-
[`view_groups`][ref-view-view-groups] parameter.
84+
A list of view names that belong to this group.
8885

8986
<CodeGroup>
9087

@@ -108,22 +105,14 @@ view_group(`sales`, {
108105

109106
## Assigning views to groups
110107

111-
There are two complementary ways to associate a view with a view group:
112-
113-
1. **On the view group** — list view names in the [`views`](#views) parameter.
114-
2. **On the view** — set [`view_group`][ref-view-view-group] (singular) or
115-
[`view_groups`][ref-view-view-groups] (plural) on the view itself.
116-
117-
Both approaches can be combined. Cube merges the membership from all
118-
sources, so a view listed under a group's `views` *and* referencing that
119-
group via `view_group` will appear only once.
108+
To associate a view with a view group, list its name in the
109+
[`views`](#views) parameter on the view group.
120110

121111
### Example
122112

123113
The following model defines two view groups. The `sales` group lists
124-
`orders_overview` in its `views` parameter; `revenue` joins the same
125-
group via its own `view_group` property. The `customers_view` belongs to
126-
`people` through the group-level `views` list.
114+
`orders_overview` and `revenue` in its `views` parameter, while the
115+
`people` group lists `customers_view`.
127116

128117
<CodeGroup>
129118

@@ -182,7 +171,6 @@ views:
182171
- created_at
183172

184173
- name: revenue
185-
view_group: sales
186174
cubes:
187175
- join_path: order_items
188176
includes:
@@ -200,6 +188,7 @@ view_groups:
200188
description: Revenue and order views for the sales team
201189
views:
202190
- orders_overview
191+
- revenue
203192

204193
- name: people
205194
title: People
@@ -280,7 +269,6 @@ view(`orders_overview`, {
280269
})
281270

282271
view(`revenue`, {
283-
view_group: sales,
284272
cubes: [
285273
{
286274
join_path: order_items,
@@ -304,7 +292,7 @@ view(`customers_view`, {
304292
view_group(`sales`, {
305293
title: `Sales`,
306294
description: `Revenue and order views for the sales team`,
307-
views: [`orders_overview`]
295+
views: [`orders_overview`, `revenue`]
308296
})
309297

310298
view_group(`people`, {
@@ -337,12 +325,6 @@ With this model, the `/v1/meta` response includes a `viewGroups` array:
337325
}
338326
```
339327

340-
Notice that `revenue` appears in the `sales` group even though it was not
341-
listed in the group's `views` — it was added because the view itself set
342-
`view_group: sales`.
343-
344328
[ref-views]: /docs/data-modeling/views
345329
[ref-naming]: /docs/data-modeling/concepts/syntax#naming
346330
[ref-meta-endpoint]: /reference/core-data-apis/rest-api/reference
347-
[ref-view-view-group]: /reference/data-modeling/view#view_group
348-
[ref-view-view-groups]: /reference/data-modeling/view#view_groups

docs-mintlify/reference/data-modeling/view.mdx

Lines changed: 1 addition & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -230,72 +230,6 @@ view(`active_users`, {
230230

231231
</CodeGroup>
232232

233-
### `view_group`
234-
235-
Assigns this view to a single [view group][ref-ref-view-group]. The referenced
236-
view group must be defined with `view_group()` elsewhere in the data model.
237-
238-
<CodeGroup>
239-
240-
```yaml title="YAML"
241-
views:
242-
- name: revenue
243-
view_group: sales
244-
cubes:
245-
- join_path: order_items
246-
includes: "*"
247-
```
248-
249-
```javascript title="JavaScript"
250-
view(`revenue`, {
251-
view_group: sales,
252-
cubes: [
253-
{
254-
join_path: order_items,
255-
includes: `*`
256-
}
257-
]
258-
})
259-
```
260-
261-
</CodeGroup>
262-
263-
### `view_groups`
264-
265-
Assigns this view to multiple [view groups][ref-ref-view-group] at once.
266-
Each referenced view group must be defined with `view_group()` elsewhere
267-
in the data model.
268-
269-
<CodeGroup>
270-
271-
```yaml title="YAML"
272-
views:
273-
- name: revenue
274-
view_groups:
275-
- sales
276-
- finance
277-
cubes:
278-
- join_path: order_items
279-
includes: "*"
280-
```
281-
282-
```javascript title="JavaScript"
283-
view(`revenue`, {
284-
view_groups: [`sales`, `finance`],
285-
cubes: [
286-
{
287-
join_path: order_items,
288-
includes: `*`
289-
}
290-
]
291-
})
292-
```
293-
294-
</CodeGroup>
295-
296-
You can use both `view_group` and `view_groups` on the same view. Cube
297-
merges them and removes duplicates.
298-
299233
### `cubes`
300234

301235
Use `cubes` parameter in view to include exposed cubes in bulk. You can build
@@ -731,5 +665,4 @@ The `access_policy` parameter is used to configure [access policies][ref-ref-dap
731665
[ref-dim-title]: /reference/data-modeling/dimensions#title
732666
[ref-dim-description]: /reference/data-modeling/dimensions#description
733667
[ref-dim-format]: /reference/data-modeling/dimensions#format
734-
[ref-dim-meta]: /reference/data-modeling/dimensions#meta
735-
[ref-ref-view-group]: /reference/data-modeling/view-group
668+
[ref-dim-meta]: /reference/data-modeling/dimensions#meta

0 commit comments

Comments
 (0)