-
Notifications
You must be signed in to change notification settings - Fork 1.6k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1241 from fishtown-analytics/0.12.latest
Merge 0.12.latest into master
- Loading branch information
Showing
113 changed files
with
3,317 additions
and
1,897 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
* |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,14 +1,16 @@ | ||
FROM python:3.6 | ||
|
||
RUN apt-get update | ||
|
||
RUN apt-get install -y python-pip netcat | ||
RUN apt-get install -y python-dev python3-dev | ||
# do these on one line so changes trigger apt-get update | ||
RUN apt-get update && \ | ||
apt-get install -y python-pip netcat python-dev python3-dev postgresql | ||
|
||
RUN pip install pip --upgrade | ||
RUN pip install virtualenv | ||
RUN pip install virtualenvwrapper | ||
RUN pip install tox | ||
|
||
RUN useradd -mU dbt_test_user | ||
USER dbt_test_user | ||
|
||
WORKDIR /usr/src/app | ||
RUN cd /usr/src/app |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,49 +1,58 @@ | ||
# dbt | ||
<p align="center"> | ||
<img src="/etc/dbt-horizontal.png" alt="dbt logo"/> | ||
</p> | ||
<p align="center"> | ||
<a href="https://codeclimate.com/github/fishtown-analytics/dbt"> | ||
<img src="https://codeclimate.com/github/fishtown-analytics/dbt/badges/gpa.svg" alt="Code Climate"/> | ||
</a> | ||
<a href="https://circleci.com/gh/fishtown-analytics/dbt/tree/master"> | ||
<img src="https://circleci.com/gh/fishtown-analytics/dbt/tree/master.svg?style=svg" alt="CircleCI" /> | ||
</a> | ||
<a href="https://ci.appveyor.com/project/DrewBanin/dbt/branch/development"> | ||
<img src="https://ci.appveyor.com/api/projects/status/v01rwd3q91jnwp9m/branch/development?svg=true" alt="AppVeyor" /> | ||
</a> | ||
<a href="https://slack.getdbt.com"> | ||
<img src="https://slack.getdbt.com/badge.svg" alt="Slack" /> | ||
</a> | ||
</p> | ||
|
||
dbt (data build tool) helps analysts write reliable, modular code using a workflow that closely mirrors software development. | ||
**[dbt](https://www.getdbt.com/)** (data build tool) enables data analysts and engineers to transform their data using the same practices that software engineers use to build applications. | ||
|
||
A dbt project primarily consists of "models". These models are SQL `select` statements that filter, aggregate, and otherwise transform data to facilitate analytics. Analysts use dbt to [aggregate pageviews into sessions](https://github.com/fishtown-analytics/snowplow), calculate [ad spend ROI](https://github.com/fishtown-analytics/facebook-ads), or report on [email campaign performance](https://github.com/fishtown-analytics/mailchimp). | ||
dbt is the T in ELT. Organize, cleanse, denormalize, filter, rename, and pre-aggregate the raw data in your warehouse so that it's ready for analysis. | ||
|
||
These models frequently build on top of one another. Fortunately, dbt makes it easy to [manage relationships](https://docs.getdbt.com/reference#ref) between models, [test](https://docs.getdbt.com/docs/testing) your assumptions, and [visualize](https://graph.sinterdata.com/) your projects. | ||
![dbt architecture](/etc/dbt-arch.png?raw=true) | ||
|
||
Still reading? Check out the [docs](https://docs.getdbt.com/docs/overview) for more information. | ||
dbt can be used to [aggregate pageviews into sessions](https://github.com/fishtown-analytics/snowplow), calculate [ad spend ROI](https://github.com/fishtown-analytics/facebook-ads), or report on [email campaign performance](https://github.com/fishtown-analytics/mailchimp). | ||
|
||
![dbt dag](/etc/dag.png?raw=true) | ||
## Understanding dbt | ||
|
||
--- | ||
### Getting Started | ||
Analysts using dbt can transform their data by simply writing select statements, while dbt handles turning these statements into tables and views in a data warehouse. | ||
|
||
- [What is dbt]? | ||
- Read the [dbt viewpoint] | ||
- [Installation] | ||
- Join the [chat][slack-url] on Slack for live questions and support. | ||
These select statements, or "models", form a dbt project. Models frequently build on top of one another – dbt makes it easy to [manage relationships](https://docs.getdbt.com/reference#ref) between models, and [visualize these relationships](https://docs.getdbt.com/docs/documentation), as well as assure the quality of your transformations through [testing](https://docs.getdbt.com/docs/testing). | ||
|
||
--- | ||
### The dbt ecosystem | ||
- Visualize your dbt graph [here](https://graph.sinterdata.com/) | ||
- Run your dbt projects on a schedule [here](http://sinterdata.com/) | ||
![dbt dag](/etc/dbt-dag.png?raw=true) | ||
|
||
--- | ||
## Getting started | ||
|
||
[![Code Climate](https://codeclimate.com/github/fishtown-analytics/dbt/badges/gpa.svg)](https://codeclimate.com/github/fishtown-analytics/dbt) [![Slack](https://slack.getdbt.com/badge.svg)](https://slack.getdbt.com) | ||
- [Install dbt](https://docs.getdbt.com/docs/installation) | ||
- Read the [documentation](https://docs.getdbt.com/). | ||
- Productionize your dbt project with [Sinter](https://www.sinterdata.com) | ||
|
||
### Testing | ||
## Find out more | ||
|
||
| service | development | master | | ||
| --- | --- | --- | | ||
| CircleCI| [![CircleCI](https://circleci.com/gh/fishtown-analytics/dbt/tree/development.svg?style=svg)](https://circleci.com/gh/fishtown-analytics/dbt/tree/development) | [![CircleCI](https://circleci.com/gh/fishtown-analytics/dbt/tree/master.svg?style=svg)](https://circleci.com/gh/fishtown-analytics/dbt/tree/master) | | ||
| AppVeyor | [![AppVeyor](https://ci.appveyor.com/api/projects/status/v01rwd3q91jnwp9m/branch/development?svg=true)](https://ci.appveyor.com/project/DrewBanin/dbt/branch/development) | [![AppVeyor](https://ci.appveyor.com/api/projects/status/v01rwd3q91jnwp9m/branch/master?svg=true)](https://ci.appveyor.com/project/DrewBanin/dbt/branch/master) | | ||
- Check out the [Introduction to dbt](https://dbt.readme.io/docs/introduction). | ||
- Read the [dbt Viewpoint](https://dbt.readme.io/docs/viewpoint). | ||
|
||
[Coverage](https://circleci.com/api/v1/project/fishtown-analytics/dbt/latest/artifacts/0/$CIRCLE_ARTIFACTS/htmlcov/index.html?branch=development) | ||
## Join thousands of analysts in the dbt community | ||
|
||
## Code of Conduct | ||
- Join the [chat](http://slack.getdbt.com/) on Slack. | ||
- Find community posts on [dbt Discourse](https://discourse.getdbt.com). | ||
|
||
Everyone interacting in the dbt project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the [PyPA Code of Conduct]. | ||
## Reporting bugs and contributing code | ||
|
||
- Want to report a bug or request a feature? Let us know on [Slack](http://slack.getdbt.com/), or open [an issue](https://github.com/fishtown-analytics/dbt/issues/new). | ||
- Want to help us build dbt? Check out the [Contributing Getting Started Guide](/CONTRIBUTING.md) | ||
|
||
## Code of Conduct | ||
|
||
[PyPA Code of Conduct]: https://www.pypa.io/en/latest/code-of-conduct/ | ||
[slack-url]: https://slack.getdbt.com/ | ||
[Installation]: https://docs.getdbt.com/docs/installation | ||
[What is dbt]: https://docs.getdbt.com/docs/overview | ||
[dbt viewpoint]: https://docs.getdbt.com/docs/viewpoint | ||
Everyone interacting in the dbt project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the [PyPA Code of Conduct](https://www.pypa.io/en/latest/code-of-conduct/). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.