Skip to content

Commit

Permalink
add cloud cli-related faqs (#4608)
Browse files Browse the repository at this point in the history
this pr adds an faq that informs users there is a default limit when
rows/queries are returned from the cloud cli
  • Loading branch information
mirnawong1 authored Dec 7, 2023
2 parents 265a45e + 5ef2704 commit 39f4686
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 0 deletions.
5 changes: 5 additions & 0 deletions website/docs/docs/build/metricflow-commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -556,3 +556,8 @@ Keep in mind that modifying your shell configuration files can have an impact on
</details>
<details>
<summary>Why is my query limited to 100 rows in the dbt Cloud CLI?</summary>
The default <code>limit</code> for query issues from the dbt Cloud CLI is 100 rows. We set this default to prevent returning unnecessarily large data sets as the dbt Cloud CLI is typically used to query the dbt Semantic Layer during the development process, not for production reporting or to access large data sets. For most workflows, you only need to return a subset of the data.<br /><br />
However, you can change this limit if needed by setting the <code>--limit</code> option in your query. For example, to return 1000 rows, you can run <code>dbt sl list metrics --limit 1000</code>.
</details>
5 changes: 5 additions & 0 deletions website/snippets/_sl-faqs.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@

As we refine MetricFlow’s API layers, some users may find it easier to set up their own custom service layers for managing query requests. This is not currently recommended, as the API boundaries around MetricFlow are not sufficiently well-defined for broad-based community use

- **Why is my query limited to 100 rows in the dbt Cloud CLI?**
- The default `limit` for query issues from the dbt Cloud CLI is 100 rows. We set this default to prevent returning unnecessarily large data sets as the dbt Cloud CLI is typically used to query the dbt Semantic Layer during the development process, not for production reporting or to access large data sets. For most workflows, you only need to return a subset of the data.

However, you can change this limit if needed by setting the `--limit` option in your query. For example, to return 1000 rows, you can run `dbt sl list metrics --limit 1000`.

- **Can I reference MetricFlow queries inside dbt models?**
- dbt relies on Jinja macros to compile SQL, while MetricFlow is Python-based and does direct SQL rendering targeting at a specific dialect. MetricFlow does not support pass-through rendering of Jinja macros, so we can’t easily reference MetricFlow queries inside of dbt models.

Expand Down

0 comments on commit 39f4686

Please sign in to comment.