README.md

athena-utils

This dbt package contains macros that:

• can be (re)used across dbt projects running on Athena
• define Athena-specific implementations of dispatched macros from other packages

Installation Instructions

Add to your packages.yml

packages:
  - package: dbt-athena/athena_utils
    version: 0.5.0

For dbt >= v0.19.2, , add the following lines to your dbt_project.yml:

dispatch:
  - macro_namespace: dbt_utils
    search_order: [athena_utils, dbt_utils]
  - macro_namespace: dbt_expectations
    search_order: [athena_utils, dbt_expectations]
  - macro_namespace: metrics
    search_order: [athena_utils, metrics]

For dbt < v0.19.2, add the following lines to your dbt_project.yml:

vars:
  dbt_utils_dispatch_list: ["athena_utils"]

Compatibility

This package provides compatibility "shims" for:

• dbt_utils thanks to @dbarok (initial implementation)
• dbt_expectations
• dbt_metrics (>=1.3.0, <1.4.0)

In the future more shims could be added to this repository.

Contributing

We welcome contributions to this repo! To contribute a new feature or a fix, please open a Pull Request with 1) your changes and 2) updated documentation for the README.md file.

Acknoledgements

athena-utils was first developed by lalalilo, then ownership was then transfered to dbt-athena.