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
+24Lines changed: 24 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,3 +1,27 @@
1
+
# dbt_jira v1.0.0
2
+
3
+
[PR #145](https://github.com/fivetran/dbt_jira/pull/145) includes the following updates:
4
+
5
+
## Breaking Changes
6
+
7
+
### Source Package Consolidation
8
+
- Removed the dependency on the `fivetran/jira_source` package.
9
+
- All functionality from the source package has been merged into this transformation package for improved maintainability and clarity.
10
+
- If you reference `fivetran/jira_source` in your `packages.yml`, you must remove this dependency to avoid conflicts.
11
+
- Any source overrides referencing the `fivetran/jira_source` package will also need to be removed or updated to reference this package.
12
+
- Update any jira_source-scoped variables to be scoped to only under this package. See the [README](https://github.com/fivetran/dbt_jira/blob/main/README.md) for how to configure the build schema of staging models.
13
+
- As part of the consolidation, vars are no longer used to reference staging models, and only sources are represented by vars. Staging models are now referenced directly with `ref()` in downstream models.
14
+
15
+
### dbt Fusion Compatibility Updates
16
+
- Updated package to maintain compatibility with dbt-core versions both before and after v1.10.6, which introduced a breaking change to multi-argument test syntax (e.g., `unique_combination_of_columns`).
17
+
- Temporarily removed unsupported tests to avoid errors and ensure smoother upgrades across different dbt-core versions. These tests will be reintroduced once a safe migration path is available.
18
+
- Removed all `dbt_utils.unique_combination_of_columns` tests.
19
+
- Moved `loaded_at_field: _fivetran_synced` under the `config:` block in `src_jira.yml`.
20
+
21
+
## Under the Hood
22
+
- Updated conditions in `.github/workflows/auto-release.yml`.
23
+
- Added `.github/workflows/generate-docs.yml`.
24
+
1
25
# dbt_jira v0.21.0
2
26
3
27
[PR #140](https://github.com/fivetran/dbt_jira/pull/140) includes the following updates:
- Produces modeled tables that leverage Jira data from [Fivetran's connector](https://fivetran.com/docs/applications/jira) in the format described by [this ERD](https://fivetran.com/docs/applications/jira#schemainformation) and builds off the output of our [Jira source package](https://github.com/fivetran/dbt_jira_source).
19
+
- Produces modeled tables that leverage Jira data from [Fivetran's connector](https://fivetran.com/docs/applications/jira) in the format described by [this ERD](https://fivetran.com/docs/applications/jira#schemainformation).
20
20
- Enables you to better understand the workload, performance, and velocity of your team's work using Jira issues. It performs the following actions:
21
21
- Creates a daily issue history table so you can quickly create agile reports, such as burndown charts, along any issue field.
22
22
- Enriches the core issue table with relevant data regarding its workflow and current state.
@@ -72,9 +72,11 @@ Include the following jira package version in your `packages.yml` file:
72
72
```yaml
73
73
packages:
74
74
- package: fivetran/jira
75
-
version: [">=0.21.0", "<0.22.0"]
76
-
75
+
version: [">=1.0.0", "<1.1.0"]
77
76
```
77
+
78
+
> All required sources and staging models are now bundled into this transformation package. Do not include `fivetran/jira_source` in your `packages.yml` since this package has been deprecated.
79
+
78
80
### Step 3: Define database and schema variables
79
81
By default, this package runs using your destination and the `jira` schema. If this is not where your Jira data is (for example, if your Jira schema is named `jira_fivetran`), add the following configuration to your root `dbt_project.yml` file:
80
82
@@ -147,12 +149,12 @@ By default, this package builds the Jira staging models within a schema titled (
147
149
148
150
```yml
149
151
models:
150
-
jira_source:
151
-
+schema: my_new_schema_name # leave blank for just the target_schema
152
152
jira:
153
-
+schema: my_new_schema_name # leave blank for just the target_schema
153
+
+schema: my_new_schema_name # Leave +schema: blank to use the default target_schema.
154
+
staging:
155
+
+schema: my_new_schema_name # Leave +schema: blank to use the default target_schema.
154
156
```
155
-
157
+
156
158
#### Change the source table references
157
159
If an individual source table has a different name than the package expects, add the table name as it appears in your destination to the respective variable:
158
160
@@ -177,19 +179,16 @@ vars:
177
179
### (Optional) Step 6: Orchestrate your models with Fivetran Transformations for dbt Core™
178
180
<details><summary>Expand for details</summary>
179
181
<br>
180
-
182
+
181
183
Fivetran offers the ability for you to orchestrate your dbt project through [Fivetran Transformations for dbt Core™](https://fivetran.com/docs/transformations/dbt). Learn how to set up your project for orchestration through Fivetran in our [Transformations for dbt Core setup guides](https://fivetran.com/docs/transformations/dbt#setupguide).
182
184
</details>
183
185
184
186
## Does this package have dependencies?
185
187
This dbt package is dependent on the following dbt packages. These dependencies are installed by default within this package. For more information on the following packages, refer to the [dbt hub](https://hub.getdbt.com/) site.
186
188
> IMPORTANT: If you have any of these dependent packages in your own `packages.yml` file, we highly recommend that you remove them from your root `packages.yml` to avoid package version conflicts.
0 commit comments