Merge pull request #2 from sgoley/develop

v0.1.0 - add index & uindex optimizers

Author: sgoley

.gitignore

@@ -0,0 +1,3 @@
+target/
+dbt_modules/
+logs/

README.md

@@ -9,3 +9,40 @@ Check [dbt Hub](https://hub.getdbt.com/fishtown-analytics/postgres_utils/latest/
 Postgres Utils is compatible with dbt 0.17.0 and later.
 
 ----
+
+## Optimizers
+
+#### index ([source](macros/optimizers/index.sql))
+This macro creates an index on a given column. 
+
+Usage (at end of model definition .sql file):
+```
+{{
+config({
+    "post-hook": [
+      "{{ postgres_utils.index(this, 'id')}}",
+    ],
+    })
+}}
+```
+
+#### uindex ([source](macros/optimizers/uindex.sql))
+This macro creates an index on a given column.
+
+Usage (at end of model definition .sql file):
+```
+{{
+config({
+    "post-hook": [
+      "{{ postgres_utils.uindex(this, 'id')}}",
+    ],
+    })
+}}
+```
+
+
+## Acknowlegements
+
+This project extends fishtown-analytics's own postgres project available here:
+
+https://github.com/fishtown-analytics/postgres (source of index macro)

analysis/.gitkeep

@@ -0,0 +1,11 @@
+name: 'postgres_utils'
+version: '0.0.1'
+
+require-dbt-version: ">=0.17.0"
+
+source-paths: ["models"]
+target-path: "target"
+clean-targets: ["target", "dbt_modules"]
+test-paths: ["test"]
+macro-paths: ["macros"]
+log-path: "logs"

data/.gitkeep

@@ -0,0 +1,6 @@
+-- original credits to https://github.com/fishtown-analytics/postgres
+{% macro index(this, column) %}
+
+create index if not exists "{{ this.name }}__index_on_{{ column }}" on {{ this }} ("{{ column }}")
+
+{% endmacro %}

dbt_project.yml

@@ -0,0 +1,17 @@
+version: 2
+
+macros:
+  - name: index
+    description: creates an index on a given column
+    arguments:
+      - name: this
+        description: Source schema name
+      - name: column
+        description: Source schema name
+  - name: uindex
+    description: creates an unique index on a given column
+    arguments:
+      - name: this
+        description: Source schema name
+      - name: column
+        description: Source schema name

macros/.gitkeep

@@ -0,0 +1,5 @@
+{% macro uindex(this, column) %}
+
+create unique index if not exists "{{ this.name }}__uindex_on_{{ column }}" on {{ this }} ("{{ column }}")
+
+{% endmacro %}