You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: CHANGELOG.md
+60-39
Original file line number
Diff line number
Diff line change
@@ -8,56 +8,32 @@
8
8
## Contributors:
9
9
--->
10
10
11
-
# Unreleased
11
+
# dbt utils v1.0
12
+
13
+
## Migration Guide
14
+
The full migration guide is at https://docs.getdbt.com/guides/migration/versions/upgrading-to-dbt-utils-v1.0
12
15
13
16
## New features
14
-
- Updated the `slugify` macro to prepend "_" to column names beginning with a number since most databases do not allow names to begin with numbers.
15
-
- Implemented an optional `group_by_columns` argument across many of the generic testing macros to test for properties that only pertain to group-level or are can be more rigorously conducted at the group level. Property available in `recency`, `at_least_one`, `equal_row_count`, `fewer_rows_than`, `not_constant`, `not_null_proportion`, and `sequential` tests [#633](https://github.com/dbt-labs/dbt-utils/pull/633)
16
-
- New feature to omit the `source_column_name` column on the `union_relations` macro ([#331](https://github.com/dbt-labs/dbt-utils/issues/331), [#624](https://github.com/dbt-labs/dbt-utils/pull/624))
17
17
- New macro `get_single_value` ([#696](https://github.com/dbt-labs/dbt-utils/pull/696))
18
-
- New feature to select fewer columns in `expression_is_true` ([#683](https://github.com/dbt-labs/dbt-utils/issues/683), [#686](https://github.com/dbt-labs/dbt-utils/pull/686))
18
+
- New macro safe_divide() — Returns null when the denominator is 0, instead of throwing a divide-by-zero error.
19
19
- Add `not_empty_string` generic test that asserts column values are not an empty string. ([#632](https://github.com/dbt-labs/dbt-utils/issues/632), [#634](https://github.com/dbt-labs/dbt-utils/pull/634))
20
20
21
+
## Enhancements
22
+
- Implemented an optional `group_by_columns` argument across many of the generic testing macros to test for properties that only pertain to group-level or are can be more rigorously conducted at the group level. Property available in `recency`, `at_least_one`, `equal_row_count`, `fewer_rows_than`, `not_constant`, `not_null_proportion`, and `sequential` tests [#633](https://github.com/dbt-labs/dbt-utils/pull/633)
23
+
- With the addition of an on-by-default quote_identifiers flag in the star() macro, you can now disable quoting if necessary. ([#706](https://github.com/dbt-labs/dbt-utils/pull/706))
24
+
25
+
## Fixes
26
+
-`union()` now includes/excludes columns case-insensitively
27
+
- The `expression_is_true test` doesn’t output * unless storing failures, a cost improvement for BigQuery ([#683](https://github.com/dbt-labs/dbt-utils/issues/683), [#686](https://github.com/dbt-labs/dbt-utils/pull/686))
28
+
- Updated the `slugify` macro to prepend "_" to column names beginning with a number since most databases do not allow names to begin with numbers.
29
+
21
30
## Under the hood
22
31
- Remove deprecated table argument from `unpivot` ([#671](https://github.com/dbt-labs/dbt-utils/pull/671))
23
32
- Delete the deprecated identifier macro ([#672](https://github.com/dbt-labs/dbt-utils/pull/672))
24
33
- Handle deprecations in deduplicate macro ([#673](https://github.com/dbt-labs/dbt-utils/pull/673))
25
34
- Fully remove varargs usage in `surrogate_key` and `safe_add` ([#674](https://github.com/dbt-labs/dbt-utils/pull/674))
26
35
- Remove obsolete condition argument from `expression_is_true` ([#699](https://github.com/dbt-labs/dbt-utils/pull/699))
27
-
28
-
## Migration instructions
29
-
- If your project uses the `expression_is_true` macro, replace `condition` argument with `where`.
30
-
31
-
Before:
32
-
```yaml
33
-
version: 2
34
-
35
-
models:
36
-
- name: model_name
37
-
tests:
38
-
- dbt_utils.expression_is_true:
39
-
expression: "col_a + col_b = total"
40
-
condition: "created_at > '2018-12-31'"
41
-
```
42
-
After:
43
-
```yaml
44
-
version: 2
45
-
46
-
models:
47
-
- name: model_name
48
-
tests:
49
-
- dbt_utils.expression_is_true:
50
-
expression: "col_a + col_b = total"
51
-
config:
52
-
where: "created_at > '2018-12-31'"
53
-
```
54
-
55
-
## Fixes
56
-
- Add star macro option to not encase column names in quotes. ([#706](https://github.com/dbt-labs/dbt-utils/pull/706))
57
36
- Explicitly stating the namespace for cross-db macros so that the dispatch logic works correctly by restoring the dbt. prefix for all migrated cross-db macros ([#701](https://github.com/dbt-labs/dbt-utils/pull/701))
58
-
- Better handling of whitespaces in the star macro ([#651](https://github.com/dbt-labs/dbt-utils/pull/651))
59
-
- Fix to correct behavior in `mutually_exclusive_ranges` test in certain situations when `zero_length_range_allowed: true` and multiple ranges in a partition have the same value for `lower_bound_column`. ([[#659](https://github.com/dbt-labs/dbt-utils/issues/659)], [#660](https://github.com/dbt-labs/dbt-utils/pull/660))
60
-
- Fix to utilize dbt Core version of `escape_single_quotes` instead of version from dbt Utils ([[#689](https://github.com/dbt-labs/dbt-utils/issues/689)], [#692](https://github.com/dbt-labs/dbt-utils/pull/692))
- Stop showing cross-db deprecation warnings for macros who have already been migrated ([#725](https://github.com/dbt-labs/dbt-utils/pull/725))
52
+
53
+
## 0.9.3 and 0.9.4
54
+
Rolled back due to accidental incompatibilities
55
+
# dbt-utils 0.9.2
56
+
## What's Changed
57
+
* Remove unnecessary generated new lines in `star` by @courentin in https://github.com/dbt-labs/dbt-utils/pull/651
58
+
* fix: Actually suppress `union_relations` source_column_name when passing `none` by @kmclaugh in https://github.com/dbt-labs/dbt-utils/pull/661
59
+
* Make `mutually_exclusive_ranges`' test deterministic by adding `upper_bound_column` to `order by` clause by @sfc-gh-ancoleman in https://github.com/dbt-labs/dbt-utils/pull/660
60
+
* update union_relations to use core string literal macro by @dave-connors-3 in https://github.com/dbt-labs/dbt-utils/pull/665
61
+
* Add where clause example to get_column_values documentation by @arsenkhy in https://github.com/dbt-labs/dbt-utils/pull/623
62
+
63
+
## New Contributors
64
+
*@courentin made their first contribution in https://github.com/dbt-labs/dbt-utils/pull/651
65
+
*@kmclaugh made their first contribution in https://github.com/dbt-labs/dbt-utils/pull/661
66
+
*@sfc-gh-ancoleman made their first contribution in https://github.com/dbt-labs/dbt-utils/pull/660
67
+
*@dave-connors-3 made their first contribution in https://github.com/dbt-labs/dbt-utils/pull/665
68
+
*@arsenkhy made their first contribution in https://github.com/dbt-labs/dbt-utils/pull/623
69
+
70
+
# dbt-utils 0.9.1
71
+
## Fixes
72
+
- Remove cross-db dbt_utils references by @clausherther in #650
73
+
74
74
75
+
# dbt-utils 0.9.0
76
+
## Changed functionality
77
+
* 🚨 (Almost all) cross-db macros are now implemented in dbt Core instead of dbt-utils. A backwards-compatibility layer remains for now and will be removed in dbt utils 1.0 later this year. Completed by @dbeatty10 and @jtcohen6 in https://github.com/dbt-labs/dbt-utils/pull/597, https://github.com/dbt-labs/dbt-utils/pull/586 and https://github.com/dbt-labs/dbt-utils/pull/615
78
+
* See #487 for further discussion on the backstory
79
+
* If you are a package maintainer with a dependency on these macros, prepare for their removal by switching to `{{ dbt.some_macro() }}`. Refer to [#package-ecosystem in the Community Slack](https://getdbt.slack.com/archives/CU4MRJ7QB/p1658467817852129) for further assistance
80
+
* Feature: Add option to remove the `source_column_name` on the `union_relations` macro by @christineberger in https://github.com/dbt-labs/dbt-utils/pull/624
81
+
82
+
## Fixes
83
+
* Use adapter.quote() instead of hardcoded BQ quoting for get_table_types_sql by @alla-bongard in https://github.com/dbt-labs/dbt-utils/pull/636
84
+
85
+
## Documentation
86
+
* standardize yml indentation under the 'models:' line on the README by @leoebfolsom in https://github.com/dbt-labs/dbt-utils/pull/613
87
+
* Use MADR 3.0.0 for formatting decision records by @dbeatty10 in https://github.com/dbt-labs/dbt-utils/pull/614
88
+
* Docs cleanup by @dbeatty10 in https://github.com/dbt-labs/dbt-utils/pull/620
89
+
* Add not_accepted_values to README ToC by @david-beallor in https://github.com/dbt-labs/dbt-utils/pull/646
90
+
91
+
# New Contributors
92
+
*@leoebfolsom made their first contribution in https://github.com/dbt-labs/dbt-utils/pull/613
93
+
*@christineberger made their first contribution in https://github.com/dbt-labs/dbt-utils/pull/624
94
+
*@alla-bongard made their first contribution in https://github.com/dbt-labs/dbt-utils/pull/636
95
+
*@david-beallor made their first contribution in https://github.com/dbt-labs/dbt-utils/pull/646
0 commit comments