diff --git a/docs/pages/guides/recipes/access-control/controlling-access-to-cubes-and-views.mdx b/docs/pages/guides/recipes/access-control/controlling-access-to-cubes-and-views.mdx index 91514035d9777..f8b9421af50d6 100644 --- a/docs/pages/guides/recipes/access-control/controlling-access-to-cubes-and-views.mdx +++ b/docs/pages/guides/recipes/access-control/controlling-access-to-cubes-and-views.mdx @@ -52,9 +52,15 @@ cubes: views: - name: total_revenue_per_customer public: {{ COMPILE_CONTEXT['securityContext']['isFinance'] }} - includes: - - orders.total_revenue - - users.company + + cubes: + - join_path: orders + includes: + - total_revenue + + - join_path: orders.users + includes: + - company ``` ```javascript @@ -75,12 +81,25 @@ cube(`users`, { }); // total_revenue_per_customer.js -view("total_revenue_per_customer", { +view(`total_revenue_per_customer`, { description: `Total revenue per customer`, public: COMPILE_CONTEXT.securityContext.isFinance, - includes: [orders.total_revenue, users.company], -}); + cubes: [ + { + join_path: orders, + includes: [ + `total_revenue` + ] + }, + { + join_path: orders.users, + includes: [ + `company` + ] + } + ] +}) ``` diff --git a/docs/pages/reference/data-model/view.mdx b/docs/pages/reference/data-model/view.mdx index fe7bb50f74b45..82472bc5322da 100644 --- a/docs/pages/reference/data-model/view.mdx +++ b/docs/pages/reference/data-model/view.mdx @@ -292,8 +292,20 @@ view(`arr`, { description: `Annual Recurring Revenue`, public: COMPILE_CONTEXT.security_context.is_finance, - includes: [revenue.arr, revenue.date, customers.plan], -}); + cubes: [ + { + join_path: revenue, + includes: [ + `arr`, + `date` + ] + }, + { + join_path: revenue.customers, + includes: `plan` + } + ] +}) ``` ```yaml @@ -302,12 +314,15 @@ views: description: Annual Recurring Revenue public: COMPILE_CONTEXT.security_context.is_finance - includes: - # Measures - - revenue.arr - # Dimensions - - revenue.date - - customers.plan + cubes: + - join_path: revenue + includes: + - arr + - date + + - join_path: revenue.customers + includes: + - plan ``` @@ -344,50 +359,6 @@ views: The `access_policy` parameter is used to configure [data access policies][ref-ref-dap]. -### `includes` (deprecated) - - - -The top-level `includes` parameter is deprecated and might be removed in -the future. Please always use the `includes` parameter with `cubes` and -`join_path` parameters so you can explicitly control the join path. - - - -The top-level `includes` parameter is used to bulk add measures or dimensions -to a view. - - - -```javascript -view(`active_users`, { - includes: [ - // Measures - users.rolling_count, - - // Dimensions - users.city, - users.created_at, - ], -}); -``` - -```yaml -views: - - name: active_users - - includes: - # Measures - - users.rolling_count - - # Dimensions - - users.city - - users.created_at -``` - - - - [ref-recipe-control-access-cubes-views]: /guides/recipes/access-control/controlling-access-to-cubes-and-views [ref-schema-joins-direction]: