Merge pull request #25 from fishtown-analytics/pr/22

Allow customisation of audit schema in base project

Author: Claire Carroll

README.md

@@ -5,7 +5,7 @@
 > this package, especially as a post-hook. Please consider if this package is
 > appropriate for your use case before using it.
 
-Requires dbt >= 0.14.0
+Requires dbt >= 0.16.0
 
 This package provides out-of-the-box functionality to log events for all dbt
 invocations, including run start, run end, model start, and model end. It
@@ -32,6 +32,21 @@ models:
 That's it! You'll now have a stream of events for all dbt invocations in your
 warehouse.
 
+#### Customising audit schema
+
+It's possible to customise the audit schema for any project by adding a macro named: `get_audit_schema` into your DBT project.
+
+For example to always log into a specific schema, say `analytics_meta`, regardless of DBT schema, you can include the following in your project:
+
+```sql
+-- your_dbt_project/macros/get_audit_schema.sql
+{% macro get_audit_schema() %}
+
+   {{ return('analytics_meta') }}
+
+{% endmacro %}
+```
+
 ### Adapter support
 
 This package is currently compatible with dbt's Snowflake, Redshift, and

dbt_project.yml

@@ -7,7 +7,7 @@ test-paths: ["tests"]
 data-paths: ["data"]
 macro-paths: ["macros"]
 
-require-dbt-version: ">=0.14.0"
+require-dbt-version: ">=0.16.0"
 
 target-path: "target"
 clean-targets:

macros/audit.sql

@@ -1,6 +1,11 @@
 {% macro get_audit_schema() %}
 
-    {{ return(target.schema~'_meta') }}
+    {# if the get_audit_schema macro exists in the base project use that #}
+    {% if context.get(project_name, {}).get('get_audit_schema') %}
+        {{ return(context[project_name].get_audit_schema()) }}
+    {% else %}
+        {{ return(target.schema~'_meta') }}
+    {% endif %}
 
 {% endmacro %}