Merge branch 'current' into time-spine

dbt-labs · Oct 12, 2023 · 754a087 · 754a087
2 parents f9fd0ae + dc121c4
commit 754a087
Show file tree

Hide file tree

Showing 3 changed files with 27 additions and 1 deletion.
diff --git a/website/docs/guides/migration/versions/01-upgrading-to-v1.6.md b/website/docs/guides/migration/versions/01-upgrading-to-v1.6.md
@@ -90,4 +90,5 @@ More consistency and flexibility around packages. Resources defined in a package
 - [`dbt debug --connection`](/reference/commands/debug) to test just the data platform connection specified in a profile
 - [`dbt docs generate --empty-catalog`](/reference/commands/cmd-docs) to skip catalog population while generating docs
 - [`--defer-state`](/reference/node-selection/defer) enables more-granular control 
+- [`dbt ls`](/reference/commands/list) adds the Semantic model selection method to allow for `dbt ls -s "semantic_model:*"` and the ability to execute `dbt ls --resource-type semantic_model`.
 
diff --git a/website/docs/reference/commands/list.md b/website/docs/reference/commands/list.md
@@ -10,7 +10,7 @@ The `dbt ls` command lists resources in your dbt project. It accepts selector ar
 ### Usage
 ```
 dbt ls
-     [--resource-type {model,source,seed,snapshot,metric,test,exposure,analysis,default,all}]
+     [--resource-type {model,semantic_model,source,seed,snapshot,metric,test,exposure,analysis,default,all}]
      [--select SELECTION_ARG [SELECTION_ARG ...]]
      [--models SELECTOR [SELECTOR ...]]
      [--exclude SELECTOR [SELECTOR ...]]
@@ -93,6 +93,16 @@ $ dbt ls --select snowplow.* --output json --output-keys name resource_type desc
 
 </VersionBlock>
 
+<VersionBlock firstVersion="1.6">
+
+**Listing Semantic models**
+
+List all resources upstream of your orders semantic model:
+```
+dbt ls -s +semantic_model:orders
+```
+
+</VersionBlock>
 
 **Listing file paths**
 ```

diff --git a/website/docs/reference/node-selection/methods.md b/website/docs/reference/node-selection/methods.md
@@ -352,3 +352,18 @@ dbt list --select version:none        # models that are *not* versioned
 ```
 
 </VersionBlock>
+
+### The "semantic_model" method
+<VersionBlock lastVersion="1.5">
+Supported in v1.6 or newer.
+</VersionBlock>
+<VersionBlock firstVersion="1.6">
+
+The `semantic_model` method selects [semantic models](/docs/build/semantic-models).
+
+```bash
+dbt list --select semantic_model:*        # list all semantic models 
+dbt list --select +semantic_model:orders  # list your semantic model named "orders" and all upstream resources
+```
+
+</VersionBlock>