Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

group config for semantic models #4220

Merged
merged 13 commits into from
Nov 8, 2023
Merged

group config for semantic models #4220

Changes from all commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
2e28ca0
`group` config for semantic models
dbeatty10 Oct 7, 2023
e6fc24f
Fix version blocks across multiple resource types
dbeatty10 Oct 7, 2023
871a01f
Fix placement of closing tag for VersionBlock
dbeatty10 Oct 7, 2023
d57c911
Clarify the definition
dbeatty10 Oct 7, 2023
12da594
Merge branch 'current' into dbeatty/semantic-models-group-config
dbeatty10 Nov 8, 2023
8ef88b9
Match the style of other resource types
dbeatty10 Nov 8, 2023
e9f77c2
Fix resource key in `dbt_project.yml`
dbeatty10 Nov 8, 2023
5cc4101
Restore order of `dbt_project.yml` vs. `models/semantic_models.yml`
dbeatty10 Nov 8, 2023
839aab9
Remove "version: 2"
dbeatty10 Nov 8, 2023
fff3afc
Add generic placeholders for the group name
dbeatty10 Nov 8, 2023
1f20f4e
Remove extraneous (and misleading) brackets
dbeatty10 Nov 8, 2023
e15b74a
Merge branch 'current' into dbeatty/semantic-models-group-config
matthewshaver Nov 8, 2023
d54ad46
Merge branch 'current' into dbeatty/semantic-models-group-config
matthewshaver Nov 8, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 19 additions & 20 deletions website/docs/reference/resource-configs/group.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,8 +29,6 @@ Support for grouping models was added in dbt Core v1.5

<VersionBlock firstVersion="1.5">

</VersionBlock>

<File name='models/schema.yml'>

```yml
Expand Down Expand Up @@ -68,6 +66,8 @@ select ...

</File>

</VersionBlock>

</TabItem>

<TabItem value="seeds">
Expand All @@ -80,8 +80,6 @@ Support for grouping seeds was added in dbt Core v1.5

<VersionBlock firstVersion="1.5">

</VersionBlock>

<File name='dbt_project.yml'>

```yml
Expand All @@ -102,6 +100,8 @@ seeds:

</File>

</VersionBlock>


</TabItem>

Expand All @@ -115,8 +115,6 @@ Support for grouping snapshots was added in dbt Core v1.5

<VersionBlock firstVersion="1.5">

</VersionBlock>

<File name='dbt_project.yml'>

```yml
Expand All @@ -143,6 +141,8 @@ select ...

</File>

</VersionBlock>


</TabItem>

Expand All @@ -156,8 +156,6 @@ Support for grouping tests was added in dbt Core v1.5

<VersionBlock firstVersion="1.5">

</VersionBlock>

<File name='dbt_project.yml'>

```yml
Expand Down Expand Up @@ -210,6 +208,8 @@ select ...

</File>

</VersionBlock>

</TabItem>

<TabItem value="analyses">
Expand Down Expand Up @@ -239,8 +239,6 @@ Support for grouping metrics was added in dbt Core v1.5

<VersionBlock firstVersion="1.5">

</VersionBlock>

<File name='dbt_project.yml'>

```yaml
Expand All @@ -264,8 +262,11 @@ metrics:

</File>

</VersionBlock>

</TabItem>


<TabItem value="semantic models">

<VersionBlock lastVersion="1.6">
Expand All @@ -276,37 +277,35 @@ Support for grouping semantic models has been added in dbt Core v1.7.

<VersionBlock firstVersion="1.7">

<File name='schema.yml'>
<File name='models/semantic_models.yml'>

```yml
```yaml
semantic_models:
- name: model_name
group: finance
- name: <semantic_model_name>
group: <group_name>

```

</File>

<File name='dbt_project.yml'>

```yml
semantic_models:
```yaml
semantic-models:
[<resource-path>](resource-path):
+group: finance
[+](plus-prefix)group: <group_name>
```

</File>

The `group` configuration can be nested under the `config` key.

</VersionBlock>

</TabItem>

</Tabs>

## Definition
An optional configuration for grouping models, analysis, snapshots, tests, and metrics. When a resource is grouped, dbt will allow it to reference private models within the same group.
An optional configuration for assigning a group to a resource. When a resource is grouped, dbt will allow it to reference private models within the same group.

For more details on reference access between resources in groups, check out [model access](/docs/collaborate/govern/model-access#groups).

Expand Down