Skip to content

Commit

Permalink
MagicBot/add-model-counts updates (#18)
Browse files Browse the repository at this point in the history
  • Loading branch information
fivetran-catfritz authored Feb 4, 2025
1 parent 4dde125 commit a7424b1
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 4 deletions.
6 changes: 6 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
# dbt_servicenow version.version

## Documentation
- Added Quickstart model counts to README. ([#18](https://github.com/fivetran/dbt_servicenow/pull/18))
- Corrected references to connectors and connections in the README. ([#18](https://github.com/fivetran/dbt_servicenow/pull/18))

# dbt_servicenow v0.4.0
[PR #17](https://github.com/fivetran/dbt_servicenow/pull/17) includes the following updates:

Expand Down
10 changes: 6 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,8 @@ The following table provides a detailed list of all tables materialized within t
| [servicenow__change_request_enhanced](https://fivetran.github.io/dbt_servicenow/#!/model/model.servicenow.servicenow__change_request_enhanced) | Each record represents a change request with additional information about users who have interacted with it, pertinent task data, and relevant timestamps. |
| [servicenow__user_aggregated](https://fivetran.github.io/dbt_servicenow/#!/model/model.servicenow.servicenow__user_aggregated) | Each record represents a user with their associated groups and roles. |
| [servicenow__user_enhanced](https://fivetran.github.io/dbt_servicenow/#!/model/model.servicenow.servicenow__user_enhanced) | Each record represents a user with their associated groups and roles, in addition to additional user info from the sys_user table. |
### Materialized Models
Each Quickstart transformation job run materializes 39 models if all components of this data model are enabled. This count includes all staging, intermediate, and final models materialized as `view`, `table`, or `incremental`.
<!--section-end-->


Expand All @@ -55,7 +57,7 @@ Servicenow tables can be complex, for example exhibiting many-to-many relationsh
### Step 1: Prerequisites
To use this dbt package, you must have the following:

- At least one Fivetran ServiceNow connector syncing data into your destination.
- At least one Fivetran ServiceNow connection syncing data into your destination.
- A **BigQuery**, **Snowflake**, **Redshift**, **Databricks**, or **PostgreSQL** destination.

#### Databricks dispatch configuration
Expand All @@ -76,7 +78,7 @@ packages:
```

### Step 3: Define database and schema variables
#### Single connector
#### Single connection
By default, this package runs using your destination and the `servicenow` schema. If this is not where your ServiceNow data is (for example, if your ServiceNow schema is named `servicenow_fivetran`), add the following configuration to your root `dbt_project.yml` file:

```yml
Expand All @@ -86,8 +88,8 @@ vars:
servicenow_database: your_database_name
servicenow_schema: your_schema_name
```
#### Union multiple connectors
If you have multiple ServiceNow connectors in Fivetran and would like to use this package on all of them simultaneously, we have provided functionality to do so. The package will union all of the data together and pass the unioned table into the transformations. You will be able to see which source it came from in the `source_relation` column of each model. To use this functionality, you will need to set either the `servicenow_union_schemas` OR `servicenow_union_databases` variables (cannot do both) in your root `dbt_project.yml` file:
#### Union multiple connections
If you have multiple ServiceNow connections in Fivetran and would like to use this package on all of them simultaneously, we have provided functionality to do so. The package will union all of the data together and pass the unioned table into the transformations. You will be able to see which source it came from in the `source_relation` column of each model. To use this functionality, you will need to set either the `servicenow_union_schemas` OR `servicenow_union_databases` variables (cannot do both) in your root `dbt_project.yml` file:

```yml
# dbt_project.yml
Expand Down

0 comments on commit a7424b1

Please sign in to comment.