Skip to content

Commit e6e8123

Browse files
committed
troubleshooting fixes
1 parent 4c35571 commit e6e8123

1 file changed

Lines changed: 30 additions & 6 deletions

File tree

docs/oss/general/troubleshooting.mdx

Lines changed: 30 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -166,12 +166,27 @@ python3 -m pip install elementary-data[<adapter>]
166166
<Accordion title="WARNING - Installed package 'elementary' is overriding the built-in materialization 'XXX'">
167167
<Snippet file="dbt-18-materializations-common.mdx" />
168168

169-
The warning above may appear in one of the following two cases:
170-
* If you are using the most recent version of dbt 1.6 or 1.7 - this warning will appear by default, since it indicates the aforementioned behavior change in dbt 1.8.
171-
* If you are using dbt 1.8 and above, this warning will NOT appear by default, however it will start appearing once you set the flag `require_explicit_package_overrides_for_builtin_materializations` to `false`
172-
as required in the [dbt package installation guide](/oss/quickstart/quickstart-cli-package#step-by-step-install-elementary-dbt-package).
173-
174-
In either case, please ignore it for now. This is a temporary measure and we are working with the dbt team on a [longer term solution](https://github.com/dbt-labs/dbt-core/issues/10090).
169+
If you are encountering the warning above though, it means that you have previously added the flag
170+
`require_explicit_package_overrides_for_builtin_materializations=False` to `dbt-project.yml`.
171+
This is no longer required!.
172+
173+
Instead, please add a file named `elementary_materialization.sql` to your macros folder, with the following contents -
174+
175+
If you use Snowflake:
176+
```
177+
{% materialization test, adapter='snowflake' %}
178+
{{ return(elementary.materialization_test_snowflake()) }}
179+
{% endmaterialization %}
180+
```
181+
182+
If you use any other DWH:
183+
```
184+
{% materialization test, default %}
185+
{{ return(elementary.materialization_test_default()) }}
186+
{% endmaterialization %}
187+
```
188+
189+
This will ensure Elementary's test materialization is run but will avoid the warning.
175190
</Accordion>
176191
177192
<Accordion title="I changed the training period but the results are the same">
@@ -221,6 +236,15 @@ vars:
221236
222237
</Accordion>
223238
239+
<Accordion title="I'm trying to run Elementary with dbt-fusion but encountering issues">
240+
241+
dbt-fusion support in Elementary is still in beta.
242+
243+
While most of the core features should work, some features may not work as expected.
244+
For more details, please click [here](/oss/integrations/dbt-fusion)
245+
246+
</Accordion>
247+
224248
<Accordion title="My problem is not listed here">
225249
226250
If you're experiencing issues of any kind, reach out on the [#community-support](https://elementary-community.slack.com/archives/C02CTC89LAX) channel. Elementary AI and the team will be happy to help.

0 commit comments

Comments
 (0)