blazer 2.2.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cfb774d21d8d5756c2fc273c2148542e26550452ea886adf92023c411b45200a
+  data.tar.gz: 8200979166341f38e0647fbb566f1fd8ead6895ea254a12ead4901e344d80f38
+SHA512:
+  metadata.gz: d6705d3dd2c27db9aeb36b9afd2e9a335d876f36865c5bbaade10f13cca80436ec3c31787231c16b591fd78481cdbb7f11df82de00417fd71d5005b1db038b11
+  data.tar.gz: 50c2230e80ad2a0e487197c8593a4c774a0f58304ed88b704860ce4550029202f677042a685b7457a57c67b6e660a82f4692ba529a5eabb41c17d2d1182c3fce

data/CHANGELOG.md

@@ -0,0 +1,310 @@
+## 2.2.6 (2020-07-21)
+
+- Added experimental support for InfluxDB
+- Added support for forecasting week, month, quarter, and year with Prophet
+- Fixed forecasting link not showing up
+
+## 2.2.5 (2020-06-03)
+
+- Updated maps to fix deprecation error
+
+## 2.2.4 (2020-05-30)
+
+- Fixed error with new queries
+
+## 2.2.3 (2020-05-30)
+
+- Improved query parameter handling
+
+## 2.2.2 (2020-04-13)
+
+- Added experimental support for the Socrata Open Data API (SODA)
+- Added experimental Prophet forecasting
+- Fixed query search for non-ASCII characters
+
+## 2.2.1 (2019-10-08)
+
+- Added support for Sprockets 4
+- Improved Snowflake table preview
+- Fixed bug with refresh link not showing
+
+## 2.2.0 (2019-07-12)
+
+- Added schema to table preview for Postgres and Redshift
+- Fixed bug with Slack notifications not sending
+- Dropped support for Rails 4.2
+
+## 2.1.0 (2019-06-04)
+
+- Require latest Chartkick to prevent possible XSS - see [#245](https://github.com/ankane/blazer/issues/245)
+
+## 2.0.2 (2019-05-26)
+
+- Added support for variable transformation for blind indexing
+- Added experimental support for Neo4j
+- Added experimental support for Salesforce
+- Fixed JavaScript sorting for numbers with commas
+
+## 2.0.1 (2019-01-07)
+
+- Added favicon
+- Added search for checks and schema
+- Added pie charts
+- Added Trend anomaly detection
+- Added forecasting
+- Improved tooltips
+- Improved docs for new installs
+- Fixed error with canceling queries
+
+## 2.0.0 (2019-01-03)
+
+- Added support for Slack
+- Added `async` option
+- Added `override_csp` option
+- Added smart variables, linked columns smart columns, and charts to inline docs
+- Use SQL for Elasticsearch
+- Fixed error with latest `google-cloud-bigquery`
+
+Breaking changes
+
+- Dropped support for Rails < 4.2
+
+## 1.9.0 (2018-06-17)
+
+- Prompt developers to check custom `before_action`
+- Better ordering on home page
+- Added support for Snowflake
+
+## 1.8.2 (2018-02-22)
+
+- Added support for Cassandra
+- Fixes for Druid
+- Added support for Amazon Athena
+- Added support for Druid
+- Fixed query cancellation
+
+There was no 1.8.1 release.
+
+## 1.8.0 (2017-05-01)
+
+- Added support for Rails 5.1
+
+## 1.7.10 (2017-04-03)
+
+- Added support for Google BigQuery
+- Require `drill-sergeant` gem for Apache Drill
+- Better handling of checks with variables
+
+## 1.7.9 (2017-03-20)
+
+- Added beta support for Apache Drill
+- Added email validation for checks
+- Updated Chart.js to 2.5.0
+
+## 1.7.8 (2017-02-06)
+
+- Added support for custom adapters
+- Fixed bug with scatter charts on dashboards
+- Fixed table preview for SQL Server
+- Fixed issue when `default_url_options` set
+
+## 1.7.7 (2016-12-17)
+
+- Fixed preview error for MySQL
+- Fixed error with timeouts for MySQL
+
+## 1.7.6 (2016-12-13)
+
+- Added scatter chart
+- Fixed issue with false values showing up blank
+- Fixed preview for table names with certain characters
+
+## 1.7.5 (2016-11-22)
+
+- Fixed issue with check emails sometimes failing for default Rails 5 ActiveJob adapter
+- Fixed sorting for new dashboards
+
+## 1.7.4 (2016-11-06)
+
+- Removed extra dependencies added in 1.7.1
+- Fixed `send_failing_checks` for default Rails 5 ActiveJob adapter
+
+## 1.7.3 (2016-11-01)
+
+- Fixed JavaScript errors
+- Fixed query cancel error
+- Return search results for "me" or "mine"
+- Include sample data in email when bad data checks fail
+- Fixed deprecation warnings
+
+## 1.7.2 (2016-10-30)
+
+- Cancel all queries on page nav
+- Prevent Ace from taking over find command
+- Added ability to use hashes for smart columns
+- Added ability to inherit smart variables and columns from other data sources
+
+## 1.7.1 (2016-10-29)
+
+- Do not fork when enter key pressed
+- Use custom version of Chart.js to fix label overlap
+- Improved performance of home page
+
+## 1.7.0 (2016-09-07)
+
+- Added ability to cancel queries on backend for Postgres and Redshift
+- Only run 3 queries at a time on dashboards
+- Better anomaly detection
+- Attempt to reconnect when connection issues
+- Fixed issues with caching
+
+## 1.6.2 (2016-08-11)
+
+- Added basic query permissions
+- Added ability to use arrays and hashes for smart variables
+- Added cancel button for queries
+- Added `lat` and `lng` as map keys
+
+## 1.6.1 (2016-07-30)
+
+- Added support for Presto [beta]
+- Added support for Elasticsearch timeouts
+- Fixed error in Rails 5
+
+## 1.6.0 (2016-07-28)
+
+- Added support for MongoDB [beta]
+- Added support for Elasticsearch [beta]
+- Fixed deprecation warning in Rails 5
+
+## 1.5.1 (2016-07-24)
+
+- Added anomaly detection for data less than 2 weeks
+- Added autolinking urls
+- Added support for images
+
+## 1.5.0 (2016-06-29)
+
+- Added new bar chart format
+- Added anomaly detection checks
+- Added `async` option for polling
+
+## 1.4.0 (2016-06-09)
+
+- Added `slow` cache mode
+- Fixed `BLAZER_DATABASE_URL required` error
+- Fixed issue with duplicate column names
+
+## 1.3.5 (2016-05-11)
+
+- Fixed error with checks
+
+## 1.3.4 (2016-05-11)
+
+- Fixed issue with missing queries
+
+## 1.3.3 (2016-05-08)
+
+- Fixed error with Rails 4.1 and below
+
+## 1.3.2 (2016-05-07)
+
+- Added support for Rails 5
+- Attempt to reconnect for checks
+
+## 1.3.1 (2016-05-06)
+
+- Fixed migration error
+
+## 1.3.0 (2016-05-06)
+
+- Added schedule for checks
+- Switched to Chart.js for charts
+- Better output for explain
+- Support for MySQL timeouts
+- Raise error when timeout not supported
+- Added creator to dashboards and checks
+
+## 1.2.1 (2016-04-26)
+
+- Fixed checks
+
+## 1.2.0 (2016-03-22)
+
+- Added non-editable queries
+- Added variable defaults
+- Added `local_time_suffix` setting
+- Better timeout message
+- Hide variables from commented out lines
+- Fixed regex as variable names
+
+## 1.1.1 (2016-03-06)
+
+- Added `before_action` option
+- Added invert option for checks
+- Added targets
+- Friendlier error message for timeouts
+- Fixed request URI too large
+- Prevent accidental backspace nav on query page
+
+## 1.1.0 (2015-12-27)
+
+- Replaced pie charts with column charts
+- Fixed error with datepicker
+- Added fork button to edit query page
+- Added a notice when editing a query that is part of a dashboard
+- Added refresh for dashboards
+
+## 1.0.4 (2015-11-04)
+
+- Added recently viewed queries and dashboards to home page
+- Fixed refresh when transform statement is used
+- Fixed error when no user model
+
+## 1.0.3 (2015-10-18)
+
+- Added maps
+- Added support for Rails 4.0
+
+## 1.0.2 (2015-10-11)
+
+- Fixed error when installing
+- Added `schemas` option
+
+## 1.0.1 (2015-10-08)
+
+- Added comments to queries
+- Added `cache` option
+- Added `user_method` option
+- Added `use_transaction` option
+
+## 1.0.0 (2015-10-04)
+
+- Added support for multiple data sources
+- Added dashboards
+- Added checks
+- Added support for Redshift
+
+## 0.0.8 (2015-09-05)
+
+- Easier to edit queries with variables
+- Dynamically expand editor height as needed
+- No need for spaces in search
+
+## 0.0.7 (2015-07-23)
+
+- Fixed error when no `User` class
+- Fixed forking a query with variables
+- Set time zone after Rails initializes
+
+## 0.0.6 (2015-06-18)
+
+- Added fork button
+- Fixed trending
+- Fixed time zones for date select
+
+## 0.0.5 (2015-01-31)
+
+- Added support for Rails 4.2
+- Fixed error with `mysql2` adapter
+- Added `user_class` option

data/CONTRIBUTING.md

@@ -0,0 +1,42 @@
+# Contributing
+
+First, thanks for wanting to contribute. You’re awesome! :heart:
+
+## Help
+
+We’re not able to provide support through GitHub Issues. If you’re looking for help with your code, try posting on [Stack Overflow](https://stackoverflow.com/).
+
+All features should be documented. If you don’t see a feature in the docs, assume it doesn’t exist.
+
+## Bugs
+
+Think you’ve discovered a bug?
+
+1. Search existing issues to see if it’s been reported.
+2. Try the `master` branch to make sure it hasn’t been fixed.
+
+```rb
+gem "blazer", github: "ankane/blazer"
+```
+
+If the above steps don’t help, create an issue. Include:
+
+- Detailed steps to reproduce
+- Complete backtraces for exceptions
+
+## New Features
+
+If you’d like to discuss a new feature, create an issue and start the title with `[Idea]`.
+
+## Pull Requests
+
+Fork the project and create a pull request. A few tips:
+
+- Keep changes to a minimum. If you have multiple features or fixes, submit multiple pull requests.
+- Follow the existing style. The code should read like it’s written by a single person.
+
+Feel free to open an issue to get feedback on your idea before spending too much time on it.
+
+---
+
+This contributing guide is released under [CCO](https://creativecommons.org/publicdomain/zero/1.0/) (public domain). Use it for your own project without attribution.

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014-2019 Andrew Kane
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,1041 @@
+# Blazer
+
+Explore your data with SQL. Easily create charts and dashboards, and share them with your team.
+
+[Try it out](https://blazer.dokkuapp.com)
+
+[![Screenshot](https://blazer.dokkuapp.com/assets/blazer-90fb6ce8ad25614c6f9c3b4619cbfbd66fa3d6567dac34d83df540f6688665f1.png)](https://blazer.dokkuapp.com)
+
+Blazer is also available as a [Docker image](https://github.com/ankane/blazer-docker).
+
+:tangerine: Battle-tested at [Instacart](https://www.instacart.com/opensource)
+
+## Features
+
+- **Multiple data sources** - PostgreSQL, MySQL, Redshift, and [many more](#full-list)
+- **Variables** - run the same queries with different values
+- **Checks & alerts** - get emailed when bad data appears
+- **Audits** - all queries are tracked
+- **Security** - works with your authentication system
+
+## Docs
+
+- [Installation](#installation)
+- [Queries](#queries)
+- [Charts](#charts)
+- [Dashboards](#dashboards)
+- [Checks](#checks)
+
+## Installation
+
+Add this line to your application’s Gemfile:
+
+```ruby
+gem 'blazer'
+```
+
+Run:
+
+```sh
+rails generate blazer:install
+rails db:migrate
+```
+
+And mount the dashboard in your `config/routes.rb`:
+
+```ruby
+mount Blazer::Engine, at: "blazer"
+```
+
+For production, specify your database:
+
+```ruby
+ENV["BLAZER_DATABASE_URL"] = "postgres://user:password@hostname:5432/database"
+```
+
+Blazer tries to protect against queries which modify data (by running each query in a transaction and rolling it back), but a safer approach is to use a read only user. [See how to create one](#permissions).
+
+#### Checks (optional)
+
+Be sure to set a host in `config/environments/production.rb` for emails to work.
+
+```ruby
+config.action_mailer.default_url_options = {host: "blazer.dokkuapp.com"}
+```
+
+Schedule checks to run (with cron, [Heroku Scheduler](https://elements.heroku.com/addons/scheduler), etc). The default options are every 5 minutes, 1 hour, or 1 day, which you can customize. For each of these options, set up a task to run.
+
+```sh
+rake blazer:run_checks SCHEDULE="5 minutes"
+rake blazer:run_checks SCHEDULE="1 hour"
+rake blazer:run_checks SCHEDULE="1 day"
+```
+
+You can also set up failing checks to be sent once a day (or whatever you prefer).
+
+```sh
+rake blazer:send_failing_checks
+```
+
+Here’s what it looks like with cron.
+
+```
+*/5 * * * * rake blazer:run_checks SCHEDULE="5 minutes"
+0   * * * * rake blazer:run_checks SCHEDULE="1 hour"
+30  7 * * * rake blazer:run_checks SCHEDULE="1 day"
+0   8 * * * rake blazer:send_failing_checks
+```
+
+For Slack notifications, create an [incoming webhook](https://slack.com/apps/A0F7XDUAZ-incoming-webhooks) and set:
+
+```sh
+BLAZER_SLACK_WEBHOOK_URL=https://hooks.slack.com/...
+```
+
+Name the webhook “Blazer” and add a cool icon.
+
+## Authentication
+
+Don’t forget to protect the dashboard in production.
+
+### Basic Authentication
+
+Set the following variables in your environment or an initializer.
+
+```ruby
+ENV["BLAZER_USERNAME"] = "andrew"
+ENV["BLAZER_PASSWORD"] = "secret"
+```
+
+### Devise
+
+```ruby
+authenticate :user, ->(user) { user.admin? } do
+  mount Blazer::Engine, at: "blazer"
+end
+```
+
+### Other
+
+Specify a `before_action` method to run in `blazer.yml`.
+
+```yml
+before_action_method: require_admin
+```
+
+You can define this method in your `ApplicationController`.
+
+```ruby
+def require_admin
+  # depending on your auth, something like...
+  redirect_to root_path unless current_user && current_user.admin?
+end
+```
+
+Be sure to render or redirect for unauthorized users.
+
+## Permissions
+
+Blazer runs each query in a transaction and rolls it back to prevent queries from modifying data. As an additional line of defense, we recommend using a read only user.
+
+### PostgreSQL
+
+Create a user with read only permissions:
+
+```sql
+BEGIN;
+CREATE ROLE blazer LOGIN PASSWORD 'secret123';
+GRANT CONNECT ON DATABASE database_name TO blazer;
+GRANT USAGE ON SCHEMA public TO blazer;
+GRANT SELECT ON ALL TABLES IN SCHEMA public TO blazer;
+ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO blazer;
+COMMIT;
+```
+
+### MySQL
+
+Create a user with read only permissions:
+
+```sql
+GRANT SELECT, SHOW VIEW ON database_name.* TO blazer@’127.0.0.1′ IDENTIFIED BY ‘secret123‘;
+FLUSH PRIVILEGES;
+```
+
+### MongoDB
+
+Create a user with read only permissions:
+
+```
+db.createUser({user: "blazer", pwd: "password", roles: ["read"]})
+```
+
+Also, make sure authorization is enabled when you start the server.
+
+## Sensitive Data
+
+If your database contains sensitive or personal data, check out [Hypershield](https://github.com/ankane/hypershield) to shield it.
+
+## Encrypted Data
+
+If you need to search encrypted data, use [blind indexing](https://github.com/ankane/blind_index).
+
+You can have Blazer transform specific variables with:
+
+```ruby
+Blazer.transform_variable = lambda do |name, value|
+  value = User.compute_email_bidx(value) if name == "email_bidx"
+  value
+end
+```
+
+## Queries
+
+### Variables
+
+Create queries with variables.
+
+```sql
+SELECT * FROM users WHERE gender = {gender}
+```
+
+Use `{start_time}` and `{end_time}` for time ranges. [Example](https://blazer.dokkuapp.com/queries/9-time-range-selector?start_time=1997-10-03T05%3A00%3A00%2B00%3A00&end_time=1997-10-04T04%3A59%3A59%2B00%3A00)
+
+```sql
+SELECT * FROM ratings WHERE rated_at >= {start_time} AND rated_at <= {end_time}
+```
+
+### Smart Variables
+
+[Example](https://blazer.dokkuapp.com/queries/1-smart-variable)
+
+Suppose you have the query:
+
+```sql
+SELECT * FROM users WHERE occupation_id = {occupation_id}
+```
+
+Instead of remembering each occupation’s id, users can select occupations by name.
+
+Add a smart variable with:
+
+```yml
+smart_variables:
+  occupation_id: "SELECT id, name FROM occupations ORDER BY name ASC"
+```
+
+The first column is the value of the variable, and the second column is the label.
+
+You can also use an array or hash for static data and enums.
+
+```yml
+smart_variables:
+  period: ["day", "week", "month"]
+  status: {0: "Active", 1: "Archived"}
+```
+
+### Linked Columns
+
+[Example](https://blazer.dokkuapp.com/queries/3-linked-column) - title column
+
+Link results to other pages in your apps or around the web. Specify a column name and where it should link to. You can use the value of the result with `{value}`.
+
+```yml
+linked_columns:
+  user_id: "/admin/users/{value}"
+  ip_address: "https://www.infosniper.net/index.php?ip_address={value}"
+```
+
+### Smart Columns
+
+[Example](https://blazer.dokkuapp.com/queries/2-smart-column) - occupation_id column
+
+Suppose you have the query:
+
+```sql
+SELECT name, city_id FROM users
+```
+
+See which city the user belongs to without a join.
+
+```yml
+smart_columns:
+  city_id: "SELECT id, name FROM cities WHERE id IN {value}"
+```
+
+You can also use a hash for static data and enums.
+
+```yml
+smart_columns:
+  status: {0: "Active", 1: "Archived"}
+```
+
+### Caching
+
+Blazer can automatically cache results to improve speed. It can cache slow queries:
+
+```yml
+cache:
+  mode: slow
+  expires_in: 60 # min
+  slow_threshold: 15 # sec
+```
+
+Or it can cache all queries:
+
+```yml
+cache:
+  mode: all
+  expires_in: 60 # min
+```
+
+Of course, you can force a refresh at any time.
+
+## Charts
+
+Blazer will automatically generate charts based on the types of the columns returned in your query.
+
+**Note:** The order of columns matters.
+
+### Line Chart
+
+There are two ways to generate line charts.
+
+2+ columns - timestamp, numeric(s) - [Example](https://blazer.dokkuapp.com/queries/4-line-chart-format-1)
+
+```sql
+SELECT date_trunc('week', created_at), COUNT(*) FROM users GROUP BY 1
+```
+
+3 columns - timestamp, string, numeric - [Example](https://blazer.dokkuapp.com/queries/5-line-chart-format-2)
+
+
+```sql
+SELECT date_trunc('week', created_at), gender, COUNT(*) FROM users GROUP BY 1, 2
+```
+
+### Column Chart
+
+There are also two ways to generate column charts.
+
+2+ columns - string, numeric(s) - [Example](https://blazer.dokkuapp.com/queries/6-column-chart-format-1)
+
+```sql
+SELECT gender, COUNT(*) FROM users GROUP BY 1
+```
+
+3 columns - string, string, numeric - [Example](https://blazer.dokkuapp.com/queries/7-column-chart-format-2)
+
+```sql
+SELECT gender, zip_code, COUNT(*) FROM users GROUP BY 1, 2
+```
+
+### Scatter Chart
+
+2 columns - both numeric - [Example](https://blazer.dokkuapp.com/queries/16-scatter-chart)
+
+```sql
+SELECT x, y FROM table
+```
+
+### Pie Chart
+
+2 columns - string, numeric - and last column named `pie` - [Example](https://blazer.dokkuapp.com/queries/17-pie-chart)
+
+```sql
+SELECT gender, COUNT(*) AS pie FROM users GROUP BY 1
+```
+
+### Maps
+
+Columns named `latitude` and `longitude` or `lat` and `lon` or `lat` and `lng` - [Example](https://blazer.dokkuapp.com/queries/15-map)
+
+```sql
+SELECT name, latitude, longitude FROM cities
+```
+
+To enable, get an access token from [Mapbox](https://www.mapbox.com/) and set `ENV["MAPBOX_ACCESS_TOKEN"]`.
+
+### Targets
+
+Use the column name `target` to draw a line for goals. [Example](https://blazer.dokkuapp.com/queries/8-target-line)
+
+```sql
+SELECT date_trunc('week', created_at), COUNT(*) AS new_users, 100000 AS target FROM users GROUP BY 1
+```
+
+## Dashboards
+
+Create a dashboard with multiple queries. [Example](https://blazer.dokkuapp.com/dashboards/1-dashboard-demo)
+
+If the query has a chart, the chart is shown. Otherwise, you’ll see a table.
+
+If any queries have variables, they will show up on the dashboard.
+
+## Checks
+
+Checks give you a centralized place to see the health of your data. [Example](https://blazer.dokkuapp.com/checks)
+
+Create a query to identify bad rows.
+
+```sql
+SELECT * FROM ratings WHERE user_id IS NULL /* all ratings should have a user */
+```
+
+Then create check with optional emails if you want to be notified. Emails are sent when a check starts failing, and when it starts passing again.
+
+## Anomaly Detection
+
+Blazer supports two different approaches to anomaly detection.
+
+### Trend
+
+[Trend](https://trendapi.org/) is easiest to set up but uses an external service.
+
+Add [trend](https://github.com/ankane/trend) to your Gemfile:
+
+```ruby
+gem 'trend'
+```
+
+And add to `config/blazer.yml`:
+
+```yml
+anomaly_checks: trend
+```
+
+### R
+
+R is harder to set up but doesn’t use an external service. It uses Twitter’s [AnomalyDetection](https://github.com/twitter/AnomalyDetection) library.
+
+First, [install R](https://cloud.r-project.org/). Then, run:
+
+```R
+install.packages("remotes")
+remotes::install_github("twitter/AnomalyDetection")
+```
+
+And add to `config/blazer.yml`:
+
+```yml
+anomaly_checks: r
+```
+
+If upgrading from version 1.4 or below, also follow the [upgrade instructions](#15).
+
+If you’re on Heroku, follow [these additional instructions](#anomaly-detection-on-heroku).
+
+## Forecasting
+
+Blazer has experimental support for two different forecasting methods.
+
+A forecast link will appear for queries that return 2 columns with types timestamp and numeric.
+
+[Example](https://blazer.dokkuapp.com/queries/18-forecast?forecast=t)
+
+### Prophet
+
+Add [prophet](https://github.com/ankane/prophet) to your Gemfile:
+
+```ruby
+gem 'prophet-rb', '>= 0.2.1'
+```
+
+And add to `config/blazer.yml`:
+
+```yml
+forecasting: prophet
+```
+
+### Trend
+
+[Trend](https://trendapi.org/) uses an external service.
+
+Add [trend](https://github.com/ankane/trend) to your Gemfile:
+
+```ruby
+gem 'trend'
+```
+
+And add to `config/blazer.yml`:
+
+```yml
+forecasting: trend
+```
+
+## Data Sources
+
+Blazer supports multiple data sources :tada:
+
+Add additional data sources in `config/blazer.yml`:
+
+```yml
+data_sources:
+  main:
+    url: <%= ENV["BLAZER_DATABASE_URL"] %>
+    # timeout, smart_variables, linked_columns, smart_columns
+  catalog:
+    url: <%= ENV["CATALOG_DATABASE_URL"] %>
+    # ...
+  redshift:
+    url: <%= ENV["REDSHIFT_DATABASE_URL"] %>
+    # ...
+```
+
+### Full List
+
+- [Amazon Athena](#amazon-athena)
+- [Amazon Redshift](#amazon-redshift)
+- [Apache Drill](#apache-drill)
+- [Cassandra](#cassandra)
+- [Druid](#druid)
+- [Elasticsearch](#elasticsearch)
+- [Google BigQuery](#google-bigquery)
+- [IBM DB2 and Informix](#ibm-db2-and-informix)
+- [InfluxDB](#influxdb)
+- [MongoDB](#mongodb-1)
+- [MySQL](#mysql-1)
+- [Neo4j](#neo4j)
+- [Oracle](#oracle)
+- [PostgreSQL](#postgresql-1)
+- [Presto](#presto)
+- [Salesforce](#salesforce)
+- [Socrata Open Data API (SODA)](#socrata-open-data-api-soda)
+- [Snowflake](#snowflake)
+- [SQLite](#sqlite)
+- [SQL Server](#sql-server)
+
+You can also [create an adapter](#creating-an-adapter) for any other data store.
+
+**Note:** In the examples below, we recommend using environment variables for urls.
+
+```yml
+data_sources:
+  my_source:
+    url: <%= ENV["BLAZER_MY_SOURCE_URL"] %>
+```
+
+### Amazon Athena
+
+Add [aws-sdk-athena](https://github.com/aws/aws-sdk-ruby) and [aws-sdk-glue](https://github.com/aws/aws-sdk-ruby) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    adapter: athena
+    database: database
+    output_location: s3://some-bucket/
+```
+
+### Amazon Redshift
+
+Add [activerecord6-redshift-adapter](https://github.com/kwent/activerecord6-redshift-adapter) or [activerecord5-redshift-adapter](https://github.com/ConsultingMD/activerecord5-redshift-adapter) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    url: redshift://user:password@hostname:5439/database
+```
+
+### Apache Drill
+
+Add [drill-sergeant](https://github.com/ankane/drill-sergeant) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    adapter: drill
+    url: http://hostname:8047
+```
+
+### Cassandra
+
+Add [cassandra-driver](https://github.com/datastax/ruby-driver) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    url: cassandra://user:password@hostname:9042/keyspace
+```
+
+### Druid
+
+Enable [SQL support](http://druid.io/docs/latest/querying/sql.html#configuration) on the broker and set:
+
+```yml
+data_sources:
+  my_source:
+    adapter: druid
+    url: http://hostname:8082
+```
+
+### Elasticsearch
+
+Add [elasticsearch](https://github.com/elastic/elasticsearch-ruby) and [elasticsearch-xpack](https://github.com/elastic/elasticsearch-ruby/tree/master/elasticsearch-xpack) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    adapter: elasticsearch
+    url: http://user:password@hostname:9200
+```
+
+### Google BigQuery
+
+Add [google-cloud-bigquery](https://github.com/GoogleCloudPlatform/google-cloud-ruby/tree/master/google-cloud-bigquery) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    adapter: bigquery
+    project: your-project
+    keyfile: path/to/keyfile.json
+```
+
+### IBM DB2 and Informix
+
+Add [ibm_db](https://github.com/ibmdb/ruby-ibmdb) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    url: ibm-db://user:password@hostname:50000/database
+```
+
+### InfluxDB
+
+*Experimental*
+
+Add [influxdb](https://github.com/influxdata/influxdb-ruby) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    adapter: influxdb
+    url: http://user:password@hostname:8086/database
+```
+
+Supports [InfluxQL](https://docs.influxdata.com/influxdb/v1.8/query_language/explore-data/)
+
+### MongoDB
+
+Add [mongo](https://github.com/mongodb/mongo-ruby-driver) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    url: mongodb://user:password@hostname:27017/database
+```
+
+### MySQL
+
+Add [mysql2](https://github.com/brianmario/mysql2) to your Gemfile (if it’s not there) and set:
+
+```yml
+data_sources:
+  my_source:
+    url: mysql2://user:password@hostname:3306/database
+```
+
+### Neo4j
+
+*Experimental*
+
+Add [neo4j-core](https://github.com/neo4jrb/neo4j-core) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    adapter: neo4j
+    url: http://user:password@hostname:7474
+```
+
+### Oracle
+
+Add [activerecord-oracle_enhanced-adapter](https://github.com/rsim/oracle-enhanced) and [ruby-oci8](https://github.com/kubo/ruby-oci8) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    url: oracle-enhanced://user:password@hostname:1521/database
+```
+
+### PostgreSQL
+
+Add [pg](https://github.com/ged/ruby-pg) to your Gemfile (if it’s not there) and set:
+
+```yml
+data_sources:
+  my_source:
+    url: postgres://user:password@hostname:5432/database
+```
+
+### Presto
+
+Add [presto-client](https://github.com/treasure-data/presto-client-ruby) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    url: presto://user@hostname:8080/catalog
+```
+
+### Salesforce
+
+*Experimental*
+
+Add [restforce](https://github.com/restforce/restforce) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    adapter: salesforce
+```
+
+And set the appropriate environment variables:
+
+```sh
+SALESFORCE_USERNAME="username"
+SALESFORCE_PASSWORD="password"
+SALESFORCE_SECURITY_TOKEN="security token"
+SALESFORCE_CLIENT_ID="client id"
+SALESFORCE_CLIENT_SECRET="client secret"
+SALESFORCE_API_VERSION="41.0"
+```
+
+Supports [SOQL](https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql.htm)
+
+### Socrata Open Data API (SODA)
+
+*Experimental*
+
+Set:
+
+```yml
+data_sources:
+  my_source:
+    adapter: soda
+    url: https://soda.demo.socrata.com/resource/4tka-6guv.json
+    app_token: ...
+```
+
+Supports [SoQL](https://dev.socrata.com/docs/functions/)
+
+### Snowflake
+
+First, install ODBC. For Homebrew, use:
+
+```sh
+brew install unixodbc
+```
+
+For Ubuntu, use:
+
+```sh
+sudo apt-get install unixodbc-dev
+```
+
+For Heroku, use the [Apt buildpack](https://github.com/heroku/heroku-buildpack-apt) and create an `Aptfile` with:
+
+```text
+unixodbc-dev
+https://sfc-repo.snowflakecomputing.com/odbc/linux/2.21.5/snowflake-odbc-2.21.5.x86_64.deb
+```
+
+> This installs the driver at `/app/.apt/usr/lib/snowflake/odbc/lib/libSnowflake.so`
+
+Then, download the [Snowflake ODBC driver](https://docs.snowflake.net/manuals/user-guide/odbc-download.html). Add [odbc_adapter](https://github.com/localytics/odbc_adapter) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    adapter: snowflake
+    conn_str: Driver=/path/to/libSnowflake.so;uid=user;pwd=password;server=host.snowflakecomputing.com
+```
+
+### SQLite
+
+Add [sqlite3](https://github.com/sparklemotion/sqlite3-ruby) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    url: sqlite3:path/to/database.sqlite3
+```
+
+### SQL Server
+
+Add [tiny_tds](https://github.com/rails-sqlserver/tiny_tds) and [activerecord-sqlserver-adapter](https://github.com/rails-sqlserver/activerecord-sqlserver-adapter) to your Gemfile and set:
+
+```yml
+data_sources:
+  my_source:
+    url: sqlserver://user:password@hostname:1433/database
+```
+
+## Creating an Adapter
+
+Create an adapter for any data store with:
+
+```ruby
+class FooAdapter < Blazer::Adapters::BaseAdapter
+  # code goes here
+end
+
+Blazer.register_adapter "foo", FooAdapter
+```
+
+See the [Presto adapter](https://github.com/ankane/blazer/blob/master/lib/blazer/adapters/presto_adapter.rb) for a good example. Then use:
+
+```yml
+data_sources:
+  my_source:
+    adapter: foo
+    url: http://user:password@hostname:9200/
+```
+
+## Query Permissions
+
+Blazer supports a basic permissions model.
+
+1. Queries without a name are unlisted
+2. Queries whose name starts with `#` are only listed to the creator
+3. Queries whose name starts with `*` can only be edited by the creator
+
+## Learn SQL
+
+Have team members who want to learn SQL? Here are a few great, free resources.
+
+- [The Data School](https://dataschool.com/learn-sql/)
+- [SQLBolt](https://sqlbolt.com/)
+
+## Useful Tools
+
+For an easy way to group by day, week, month, and more with correct time zones, check out [Groupdate.sql](https://github.com/ankane/groupdate.sql).
+
+## Standalone Version
+
+Looking for a standalone version? Check out [Ghost Blazer](https://github.com/buren/ghost_blazer).
+
+## Performance
+
+By default, queries take up a request while they are running. To run queries asynchronously, add to your config:
+
+```yml
+async: true
+```
+
+**Note:** Requires Rails 5+ and caching to be enabled. If you have multiple web processes, your app must use a centralized cache store like Memcached or Redis.
+
+```ruby
+config.cache_store = :mem_cache_store
+```
+
+## Anomaly Detection on Heroku
+
+Add the [R buildpack](https://github.com/virtualstaticvoid/heroku-buildpack-r) to your app.
+
+```sh
+heroku buildpacks:add --index 1 https://github.com/virtualstaticvoid/heroku-buildpack-r.git\#cedar-14
+```
+
+And create an `init.r` with:
+
+```sh
+if (!"AnomalyDetection" %in% installed.packages()) {
+  install.packages("devtools")
+  devtools::install_github("twitter/AnomalyDetection")
+}
+```
+
+Commit and deploy away. The first deploy may take a few minutes.
+
+## Content Security Policy
+
+If views are stuck with a `Loading...` message, there might be a problem with strict CSP settings in your app. This can be checked with Firefox or Chrome dev tools. You can allow Blazer to override these settings for its controllers with:
+
+```yml
+override_csp: true
+```
+
+## Upgrading
+
+### 2.0
+
+To use Slack notifications, create a migration
+
+```sh
+rails g migration add_slack_channels_to_blazer_checks
+```
+
+with:
+
+```ruby
+add_column :blazer_checks, :slack_channels, :text
+```
+
+### 1.5
+
+To take advantage of the anomaly detection, create a migration
+
+```sh
+rails g migration upgrade_blazer_to_1_5
+```
+
+with:
+
+```ruby
+add_column :blazer_checks, :check_type, :string
+add_column :blazer_checks, :message, :text
+commit_db_transaction
+
+Blazer::Check.reset_column_information
+
+Blazer::Check.where(invert: true).update_all(check_type: "missing_data")
+Blazer::Check.where(check_type: nil).update_all(check_type: "bad_data")
+```
+
+### 1.3
+
+To take advantage of the latest features, create a migration
+
+```sh
+rails g migration upgrade_blazer_to_1_3
+```
+
+with:
+
+```ruby
+add_column :blazer_dashboards, :creator_id, :integer
+add_column :blazer_checks, :creator_id, :integer
+add_column :blazer_checks, :invert, :boolean
+add_column :blazer_checks, :schedule, :string
+add_column :blazer_checks, :last_run_at, :timestamp
+commit_db_transaction
+
+Blazer::Check.update_all schedule: "1 hour"
+```
+
+### 1.0
+
+Blazer 1.0 brings a number of new features:
+
+- multiple data sources, including Redshift
+- dashboards
+- checks
+
+To upgrade, run:
+
+```sh
+bundle update blazer
+```
+
+Create a migration
+
+```sh
+rails g migration upgrade_blazer_to_1_0
+```
+
+with:
+
+```ruby
+add_column :blazer_queries, :data_source, :string
+add_column :blazer_audits, :data_source, :string
+
+create_table :blazer_dashboards do |t|
+  t.text :name
+  t.timestamps
+end
+
+create_table :blazer_dashboard_queries do |t|
+  t.references :dashboard
+  t.references :query
+  t.integer :position
+  t.timestamps
+end
+
+create_table :blazer_checks do |t|
+  t.references :query
+  t.string :state
+  t.text :emails
+  t.timestamps
+end
+```
+
+And run:
+
+```sh
+rails db:migrate
+```
+
+Update `config/blazer.yml` with:
+
+```yml
+# see https://github.com/ankane/blazer for more info
+
+data_sources:
+  main:
+    url: <%= ENV["BLAZER_DATABASE_URL"] %>
+
+    # statement timeout, in seconds
+    # applies to PostgreSQL only
+    # none by default
+    # timeout: 15
+
+    # time to cache results, in minutes
+    # can greatly improve speed
+    # none by default
+    # cache: 60
+
+    # wrap queries in a transaction for safety
+    # not necessary if you use a read-only user
+    # true by default
+    # use_transaction: false
+
+    smart_variables:
+      # zone_id: "SELECT id, name FROM zones ORDER BY name ASC"
+
+    linked_columns:
+      # user_id: "/admin/users/{value}"
+
+    smart_columns:
+      # user_id: "SELECT id, name FROM users WHERE id IN {value}"
+
+# create audits
+audit: true
+
+# change the time zone
+# time_zone: "Pacific Time (US & Canada)"
+
+# class name of the user model
+# user_class: User
+
+# method name for the current user
+# user_method: current_user
+
+# method name for the display name
+# user_name: name
+
+# email to send checks from
+# from_email: blazer@example.org
+```
+
+## History
+
+View the [changelog](https://github.com/ankane/blazer/blob/master/CHANGELOG.md)
+
+## Thanks
+
+Blazer uses a number of awesome open source projects, including [Rails](https://github.com/rails/rails/), [Vue.js](https://github.com/vuejs/vue), [jQuery](https://github.com/jquery/jquery), [Bootstrap](https://github.com/twbs/bootstrap), [Selectize](https://github.com/brianreavis/selectize.js), [StickyTableHeaders](https://github.com/jmosbech/StickyTableHeaders), [Stupid jQuery Table Sort](https://github.com/joequery/Stupid-Table-Plugin), and [Date Range Picker](https://github.com/dangrossman/bootstrap-daterangepicker).
+
+Demo data from [MovieLens](https://grouplens.org/datasets/movielens/).
+
+## Want to Make Blazer Better?
+
+That’s awesome! Here are a few ways you can help:
+
+- [Report bugs](https://github.com/ankane/blazer/issues)
+- Fix bugs and [submit pull requests](https://github.com/ankane/blazer/pulls)
+- Write, clarify, or fix documentation
+- Suggest or add new features
+
+Check out the [dev app](https://github.com/ankane/blazer-dev) to get started.