Skip to content

Commit 84cf0f2

Browse files
committed
Update CHANGELOG.md
1 parent eb12922 commit 84cf0f2

File tree

1 file changed

+60
-39
lines changed

1 file changed

+60
-39
lines changed

CHANGELOG.md

+60-39
Original file line numberDiff line numberDiff line change
@@ -8,56 +8,32 @@
88
## Contributors:
99
--->
1010

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
1215

1316
## 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))
1717
- 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.
1919
- 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))
2020

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+
2130
## Under the hood
2231
- Remove deprecated table argument from `unpivot` ([#671](https://github.com/dbt-labs/dbt-utils/pull/671))
2332
- Delete the deprecated identifier macro ([#672](https://github.com/dbt-labs/dbt-utils/pull/672))
2433
- Handle deprecations in deduplicate macro ([#673](https://github.com/dbt-labs/dbt-utils/pull/673))
2534
- Fully remove varargs usage in `surrogate_key` and `safe_add` ([#674](https://github.com/dbt-labs/dbt-utils/pull/674))
2635
- 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))
5736
- 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))
6137

6238
## Contributors:
6339
- [@CR-Lough] (https://github.com/CR-Lough) (#706) (#696)
@@ -67,11 +43,56 @@ models:
6743
- [@christineberger](https://github.com/christineberger) (#624)
6844
- [@epapineau](https://github.com/epapineau) (#634)
6945
- [@courentin](https://github.com/courentin) (#651)
70-
- [@sfc-gh-ancoleman](https://github.com/sfc-gh-ancoleman) (#660)
7146
- [@zachoj10](https://github.com/zachoj10) (#692)
7247
- [@miles170](https://github.com/miles170)
7348
- [@emilyriederer](https://github.com/emilyriederer)
49+
# 0.9.5
50+
## Fixes
51+
- 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+
7474

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
7596
# dbt-utils v0.8.6
7697

7798
## New features

0 commit comments

Comments
 (0)