Skip to content

Commit

Permalink
Merge branch 'current' into dremio-qs
Browse files Browse the repository at this point in the history
  • Loading branch information
matthewshaver authored Nov 16, 2023
2 parents 50aaaa3 + accb4f4 commit a7e34e2
Show file tree
Hide file tree
Showing 13 changed files with 134 additions and 90 deletions.
5 changes: 3 additions & 2 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ Uncomment if you're publishing docs for a prerelease version of dbt (delete if n
- [ ] Add versioning components, as described in [Versioning Docs](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#versioning-entire-pages)
- [ ] Add a note to the prerelease version [Migration Guide](https://github.com/dbt-labs/docs.getdbt.com/tree/current/website/docs/docs/dbt-versions/core-upgrade)
-->
- [ ] Review the [Content style guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md) and [About versioning](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#adding-a-new-version) so my content adheres to these guidelines.
- [ ] Review the [Content style guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md) so my content adheres to these guidelines.
- [ ] For [docs versioning](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#about-versioning), review how to [version a whole page](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#adding-a-new-version) and [version a block of content](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#versioning-blocks-of-content).
- [ ] Add a checklist item for anything that needs to happen before this PR is merged, such as "needs technical review" or "change base branch."

Adding new pages (delete if not applicable):
Expand All @@ -22,4 +23,4 @@ Adding new pages (delete if not applicable):
Removing or renaming existing pages (delete if not applicable):
- [ ] Remove page from `website/sidebars.js`
- [ ] Add an entry `website/static/_redirects`
- [ ] [Ran link testing](https://github.com/dbt-labs/docs.getdbt.com#running-the-cypress-tests-locally) to update the links that point to the deleted page
- [ ] Run link testing locally with `npm run build` to update the links that point to the deleted page
24 changes: 0 additions & 24 deletions website/docs/dbt-cli/cli-overview.md

This file was deleted.

53 changes: 0 additions & 53 deletions website/docs/docs/about/overview.md

This file was deleted.

4 changes: 2 additions & 2 deletions website/docs/docs/collaborate/govern/model-contracts.md
Original file line number Diff line number Diff line change
Expand Up @@ -125,8 +125,8 @@ Select the adapter-specific tab for more information on [constraint](/reference/
| Constraint type | Support | Platform enforcement |
|:-----------------|:-------------|:---------------------|
| not_null | ✅ Supported | ✅ Enforced |
| primary_key | ✅ Supported | ✅ Enforced |
| foreign_key | ✅ Supported | ✅ Enforced |
| primary_key | ✅ Supported | ❌ Not enforced |
| foreign_key | ✅ Supported | ❌ Not enforced |
| unique | ❌ Not supported | ❌ Not enforced |
| check | ❌ Not supported | ❌ Not enforced |

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@ pip is the easiest way to install the adapter:
| dbt-teradata | dbt-core | dbt-teradata-util | dbt-util |
|--------------|------------|-------------------|----------------|
| 1.2.x | 1.2.x | 0.1.0 | 0.9.x or below |
| 1.6.7 | 1.6.7 | 1.1.1 | 1.1.1 |


<h2> Configuring {frontMatter.meta.pypi_package} </h2>
Expand Down
2 changes: 1 addition & 1 deletion website/docs/docs/dbt-cloud-apis/project-state.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ Most Discovery API use cases will favor the _applied state_ since it pertains to
| Seed | Yes | Yes | Yes | Downstream | Applied & definition |
| Snapshot | Yes | Yes | Yes | Upstream & downstream | Applied & definition |
| Test | Yes | Yes | No | Upstream | Applied & definition |
| Exposure | No | No | No | Upstream | Applied & definition |
| Exposure | No | No | No | Upstream | Definition |
| Metric | No | No | No | Upstream & downstream | Definition |
| Semantic model | No | No | No | Upstream & downstream | Definition |
| Group | No | No | No | Downstream | Definition |
Expand Down
4 changes: 2 additions & 2 deletions website/docs/reference/configs-and-properties.md
Original file line number Diff line number Diff line change
Expand Up @@ -157,9 +157,9 @@ You can find an exhaustive list of each supported property and config, broken do
* Model [properties](/reference/model-properties) and [configs](/reference/model-configs)
* Source [properties](/reference/source-properties) and [configs](source-configs)
* Seed [properties](/reference/seed-properties) and [configs](/reference/seed-configs)
* [Snapshot Properties](snapshot-properties)
* Snapshot [properties](snapshot-properties)
* Analysis [properties](analysis-properties)
* [Macro Properties](/reference/macro-properties)
* Macro [properties](/reference/macro-properties)
* Exposure [properties](/reference/exposure-properties)

## FAQs
Expand Down
80 changes: 79 additions & 1 deletion website/docs/reference/dbt_project.yml.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,85 @@ dbt uses YAML in a few different places. If you're new to YAML, it would be wort
:::


<VersionBlock firstVersion="1.6">
<VersionBlock firstVersion="1.7">

<File name='dbt_project.yml'>

```yml
[name](/reference/project-configs/name): string

[config-version](/reference/project-configs/config-version): 2
[version](/reference/project-configs/version): version

[profile](/reference/project-configs/profile): profilename

[model-paths](/reference/project-configs/model-paths): [directorypath]
[seed-paths](/reference/project-configs/seed-paths): [directorypath]
[test-paths](/reference/project-configs/test-paths): [directorypath]
[analysis-paths](/reference/project-configs/analysis-paths): [directorypath]
[macro-paths](/reference/project-configs/macro-paths): [directorypath]
[snapshot-paths](/reference/project-configs/snapshot-paths): [directorypath]
[docs-paths](/reference/project-configs/docs-paths): [directorypath]
[asset-paths](/reference/project-configs/asset-paths): [directorypath]

[target-path](/reference/project-configs/target-path): directorypath
[log-path](/reference/project-configs/log-path): directorypath
[packages-install-path](/reference/project-configs/packages-install-path): directorypath

[clean-targets](/reference/project-configs/clean-targets): [directorypath]

[query-comment](/reference/project-configs/query-comment): string

[require-dbt-version](/reference/project-configs/require-dbt-version): version-range | [version-range]

[dbt-cloud](/docs/cloud/cloud-cli-installation):
[project-id](/docs/cloud/configure-cloud-cli#configure-the-dbt-cloud-cli): project_id # Required
[defer-env-id](/docs/cloud/about-cloud-develop-defer#defer-in-dbt-cloud-cli): environment_id # Optional

[quoting](/reference/project-configs/quoting):
database: true | false
schema: true | false
identifier: true | false

metrics:
<metric-configs>

models:
[<model-configs>](/reference/model-configs)

seeds:
[<seed-configs>](/reference/seed-configs)

semantic-models:
<semantic-model-configs>

snapshots:
[<snapshot-configs>](/reference/snapshot-configs)

sources:
[<source-configs>](source-configs)

tests:
[<test-configs>](/reference/test-configs)

vars:
[<variables>](/docs/build/project-variables)

[on-run-start](/reference/project-configs/on-run-start-on-run-end): sql-statement | [sql-statement]
[on-run-end](/reference/project-configs/on-run-start-on-run-end): sql-statement | [sql-statement]

[dispatch](/reference/project-configs/dispatch-config):
- macro_namespace: packagename
search_order: [packagename]

[restrict-access](/docs/collaborate/govern/model-access): true | false

```
</File>
</VersionBlock>
<VersionBlock firstVersion="1.6" lastVersion="1.6">
<File name='dbt_project.yml'>
Expand Down
31 changes: 31 additions & 0 deletions website/docs/reference/resource-properties/config.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ datatype: "{dictionary}"
{ label: 'Sources', value: 'sources', },
{ label: 'Metrics', value: 'metrics', },
{ label: 'Exposures', value: 'exposures', },
{ label: 'Semantic models', value: 'semantic models', },
]
}>

Expand Down Expand Up @@ -182,6 +183,36 @@ exposures:

</TabItem>

<TabItem value="semantic models">

<VersionBlock lastVersion="1.6">

Support for the `config` property on `semantic_models` was added in dbt Core v1.7

</VersionBlock>

<VersionBlock firstVersion="1.7">

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

```yml
version: 2
semantic_models:
- name: <semantic_model_name>
config:
enabled: true | false
group: <string>
meta: {dictionary}
```

</File>

</VersionBlock>

</TabItem>

</Tabs>

## Definition
The `config` property allows you to configure resources at the same time you're defining properties in YAML files.
2 changes: 1 addition & 1 deletion website/docs/terms/data-catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ Data teams may choose to use third-party tools with data cataloging capabilities

## Conclusion

Data catalogs are a valuable asset to any data team and business as a whole. They allow people within an organization to find the data that they need when they need it and understand its quality or sensitivity. This makes communication across teams more seamless, preventing problems that impact the business in the long run. Weigh your options in terms of whether to go with open source and enterprise, trusting that the decision you land on will be best for your organization.
Data catalogs are a valuable asset to any data team and business as a whole. They allow people within an organization to find the data that they need when they need it and understand its quality or sensitivity. This makes communication across teams more seamless, preventing problems that impact the business in the long run. Weigh your options in terms of whether to go with open source or enterprise, trusting that the decision you land on will be best for your organization.

## Additional reading

Expand Down
2 changes: 1 addition & 1 deletion website/docs/terms/primary-key.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ The table below gives an overview of primary key support and enforcement in some
<tr>
<td><a href="https://docs.getdbt.com/blog/primary-key-testing#bigquery-primary-keys">Google BigQuery</a>
</td>
<td>
<td>
</td>
<td>❌
</td>
Expand Down
2 changes: 1 addition & 1 deletion website/docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -194,7 +194,7 @@ var siteSettings = {
</div>
<div class='footer__items--right'>
<a href='https://twitter.com/getdbt'><i class="fa-brands fa-twitter"></i></a>
<a href='https://twitter.com/getdbt'><i class="fa-brands fa-x-twitter"></i></a>
<a href='https://www.getdbt.com/community/join-the-community/'><i class="fa-brands fa-slack"></i></a>
<a href='https://github.com/dbt-labs/dbt-core'><i class="fa-brands fa-github"></i></a>
</div>
Expand Down
14 changes: 12 additions & 2 deletions website/vercel.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,16 @@
"cleanUrls": true,
"trailingSlash": false,
"redirects": [
{
"source": "/docs/about/overview",
"destination": "/docs/introduction",
"permanent": true
},
{
"source": "/dbt-cli/cli-overview",
"destination": "/docs/core/about-dbt-core",
"permanent": true
},
{
"source": "/guides/advanced/creating-new-materializations",
"destination": "/guides/create-new-materializations",
Expand Down Expand Up @@ -1604,7 +1614,7 @@
},
{
"source": "/docs/dbt-cloud/cloud-overview",
"destination": "/docs/get-started/getting-started/set-up-dbt-cloud",
"destination": "/docs/cloud/about-cloud/dbt-cloud-features",
"permanent": true
},
{
Expand Down Expand Up @@ -2639,7 +2649,7 @@
},
{
"source": "/docs/cloud-overview",
"destination": "/docs/dbt-cloud/cloud-overview",
"destination": "/docs/cloud/about-cloud/dbt-cloud-features",
"permanent": true
},
{
Expand Down

0 comments on commit a7e34e2

Please sign in to comment.