Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,15 @@
# dbt_quickbooks v0.20.1
[PR #169](https://github.com/fivetran/dbt_quickbooks/pull/169) includes the following updates:

## Bug Fix
- Updated `quickbooks__balance_sheet` and `quickbooks__income_statement` analysis models to end in `*_analysis` to stop duplicate model errors in dbt Fusion, as these are existing end models within the package.

## Documentation
- Updated analysis README with new model references.

## Contributors
- [@kennymiller-point](https://github.com/kennymiller-point) ([PR #167](https://github.com/fivetran/dbt_quickbooks/pull/167))

# dbt_quickbooks v0.20.0

[PR #165](https://github.com/fivetran/dbt_quickbooks/pull/165) includes the following updates:
Expand Down
23 changes: 7 additions & 16 deletions analysis/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,18 +10,18 @@ values prior to using this package, we encourage you to use the compiled sql pro
## Analysis SQL
| **sql** | **description** |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| [quickbooks__balance_sheet](https://github.com/fivetran/dbt_quickbooks/blob/master/analysis/quickbooks__balance_sheet.sql) | The output of the compiled sql will generate three records: Assets, Liabilities, Equity. The SQL command references the quickbooks__general_ledger_by_period model and pulls all balance sheet account ending balances as of the most recent transaction month. These balances are then added for each respective balance sheet type. This will ensure your total balance sheet balances ties to what you expect. **Note**: you will need to ending date order to generate accurate balance sheet balances for your defined as of date. |
| [quickbooks__income_statement](https://github.com/fivetran/dbt_quickbooks/blob/master/analysis/quickbooks__income_statement.sql) | The output of the compiled sql will generate two records: Revenue, Expense. The SQL command references the quickbooks__general_ledger_by_period model and sums all period net change for Revenue and Expense accounts respectively. **Note**: you will need to set the date range in order to generate an accurate revenue and expense totals for your defined time period. |
| [quickbooks__balance_sheet_analysis](https://github.com/fivetran/dbt_quickbooks/blob/master/analysis/quickbooks__balance_sheet_analysis.sql) | The output of the compiled sql will generate three records: Assets, Liabilities, Equity. The SQL command references the `quickbooks__general_ledger_by_period` model and pulls all balance sheet account ending balances as of the most recent transaction month. These balances are then added for each respective balance sheet type. This will ensure your total balance sheet balances ties to what you expect. **Note**: you will need to ending date order to generate accurate balance sheet balances for your defined as of date. |
| [quickbooks__income_statement_analysis](https://github.com/fivetran/dbt_quickbooks/blob/master/analysis/quickbooks__income_statement_analysis.sql) | The output of the compiled sql will generate two records: Revenue, Expense. The SQL command references the `quickbooks__general_ledger_by_period` model and sums all period net change for Revenue and Expense accounts respectively. **Note**: you will need to set the date range in order to generate an accurate revenue and expense totals for your defined time period. |

## SQL Compile Instructions
Leveraging the above sql is made possible by the [analysis functionality of dbt](https://docs.getdbt.com/docs/building-a-dbt-project/analyses/). In order to
compile the sql, you will perform the following steps:
- Execute `dbt run` to create the package models.
- Execute `dbt compile` to generate the target specific sql.
- Navigate to your project's `/target/compiled/quickbooks/analysis` directory.
- Copy the `quickbooks__balance_sheet` code and run in your data warehouse.
- Copy the `quickbooks__balance_sheet_analysis` code and run in your data warehouse.
- Confirm the balance sheet totals match your expected results.
- Copy the `quickbooks__income_statement` code and run in your data warehouse.
- Copy the `quickbooks__income_statement_analysis` code and run in your data warehouse.
- Confirm the income statement totals match your expected results.

## Contributions
Expand All @@ -32,15 +32,6 @@ Please create issues or open PRs against `master`. Check out [this post](https:/
## Database Support
This package has been tested on BigQuery, Snowflake and Redshift.

## Resources:
- Provide [feedback](https://www.surveymonkey.com/r/DQ7K7WW) on our existing dbt packages or what you'd like to see next
- Have questions or feedback, or need help? Book a time during our office hours [here](https://calendly.com/fivetran-solutions-team/fivetran-solutions-team-office-hours) or shoot us an email at solutions@fivetran.com
- Find all of Fivetran's pre-built dbt packages in our [dbt hub](https://hub.getdbt.com/fivetran/)
- Learn how to orchestrate dbt transformations with Fivetran [here](https://fivetran.com/docs/transformations/dbt)
- Learn more about Fivetran overall [in our docs](https://fivetran.com/docs)
- Check out [Fivetran's blog](https://fivetran.com/blog)
- Learn more about dbt [in the dbt docs](https://docs.getdbt.com/docs/introduction)
- Check out [Discourse](https://discourse.getdbt.com/) for commonly asked questions and answers
- Join the [chat](http://slack.getdbt.com/) on Slack for live discussions and support
- Find [dbt events](https://events.getdbt.com) near you
- Check out [the dbt blog](https://blog.getdbt.com/) for the latest news on dbt's development and best practices
## Are there any resources available?
- If you have questions or want to reach out for help, see the [GitHub Issue](https://github.com/fivetran/dbt_quickbooks/issues/new/choose) section to find the right avenue of support for you.
- If you would like to provide feedback to the dbt package team at Fivetran or would like to request a new dbt package, fill out our [Feedback Form](https://www.surveymonkey.com/r/DQ7K7WW).
2 changes: 1 addition & 1 deletion dbt_project.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
config-version: 2
name: 'quickbooks'

version: '0.20.0'
version: '0.20.1'

require-dbt-version: [">=1.3.0", "<2.0.0"]

Expand Down
2 changes: 1 addition & 1 deletion docs/catalog.json

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion docs/manifest.json

Large diffs are not rendered by default.

10 changes: 5 additions & 5 deletions integration_tests/ci/sample.profiles.yml
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,13 @@ integration_tests:
pass: "{{ env_var('CI_REDSHIFT_DBT_PASS') }}"
dbname: "{{ env_var('CI_REDSHIFT_DBT_DBNAME') }}"
port: 5439
schema: quickbooks_integration_tests_20
schema: quickbooks_integration_tests_21
threads: 8
bigquery:
type: bigquery
method: service-account-json
project: 'dbt-package-testing'
schema: quickbooks_integration_tests_20
schema: quickbooks_integration_tests_21
threads: 8
keyfile_json: "{{ env_var('GCLOUD_SERVICE_KEY') | as_native }}"
snowflake:
Expand All @@ -30,7 +30,7 @@ integration_tests:
role: "{{ env_var('CI_SNOWFLAKE_DBT_ROLE') }}"
database: "{{ env_var('CI_SNOWFLAKE_DBT_DATABASE') }}"
warehouse: "{{ env_var('CI_SNOWFLAKE_DBT_WAREHOUSE') }}"
schema: quickbooks_integration_tests_20
schema: quickbooks_integration_tests_21
threads: 8
postgres:
type: postgres
Expand All @@ -39,13 +39,13 @@ integration_tests:
pass: "{{ env_var('CI_POSTGRES_DBT_PASS') }}"
dbname: "{{ env_var('CI_POSTGRES_DBT_DBNAME') }}"
port: 5432
schema: quickbooks_integration_tests_20
schema: quickbooks_integration_tests_21
threads: 8
databricks:
catalog: "{{ env_var('CI_DATABRICKS_DBT_CATALOG') }}"
host: "{{ env_var('CI_DATABRICKS_DBT_HOST') }}"
http_path: "{{ env_var('CI_DATABRICKS_DBT_HTTP_PATH') }}"
schema: quickbooks_integration_tests_20
schema: quickbooks_integration_tests_21
threads: 8
token: "{{ env_var('CI_DATABRICKS_DBT_TOKEN') }}"
type: databricks
4 changes: 2 additions & 2 deletions integration_tests/dbt_project.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
name: 'quickbooks_integration_tests'

version: '0.20.0'
version: '0.20.1'

profile: 'integration_tests'
config-version: 2
Expand All @@ -9,7 +9,7 @@ models:

vars:
quickbooks_source:
quickbooks_schema: quickbooks_integration_tests_20
quickbooks_schema: quickbooks_integration_tests_21
quickbooks_account_identifier: "account_data"
quickbooks_address_identifier: "address_data"
quickbooks_bill_line_identifier: "bill_line_data"
Expand Down