https+influxdb:\\ per Issue #4.
31 | 1. 1.3 - Additional error logging.
32 | 1. 1.2 - Added support for special characters - ` (space)`, `,`, `\ and /`, `' and "`,`-` and other special characters.
33 | 1. 1.1 - When editing a connection, the previous values will be restored (except for the password). Increased, and dismissible, alert information. Formatting of # of rows returned with ",".
34 | 1. 1.0 - Initial version
35 |
36 | ## Instructions
37 |
38 | ### Local install
39 | * npm install influxdb_wdc
40 | OR
41 | * Download the files and put them in a local web server.
42 |
43 | * Open in Tableau 10.2+ and point to your URL.
44 |
45 | ### Use it in place
46 |
47 | This is hosted by Github Pages. To use it, open Tableau (10.2+), select "Web Data Connector" and point to this URL: [https://tagyoureit.github.io/InfluxDB_WDC/InfluxDB.html](https://tagyoureit.github.io/InfluxDB_WDC/InfluxDB.html)
48 |
49 | #### Authorization
50 | If you use authorization on your InfluxDB, you can click the link to reload the page with the username/password fields. Alternatively, add `?auth=true` or `?auth=false` to the end of the URL to access these directly.
51 |
52 | ## Features
53 |
54 | * Basic Auth or no Auth
55 | * Custom SQL
56 | * Full or Incremental refresh
57 | * Row count for extract creation progress
58 |
59 | ## How To Use
60 |
61 | 4 easy steps.
62 | 1. Enter your server details (protocol, hostname, port and optionally username/password)
63 | 2. Press connect to load the databases and then select the appropriate one
64 | 3. Choose the type of query you want (See details below)
65 | 4. Press Submit to load the schema into Tableau
66 |
67 | ### Query Types
68 | #### All Rows
69 | This is the most basic query. It is equivalent to writing "select * from [measurement]" in InfluxQL CLI. You will be presented with a schema in the Tableau Data Source page and can select your tables and Tableau will then load the data. This will support Incremental refreshes.
70 |
71 | #### Aggregation
72 | This is a shortcut for simple aggregations. You can choose one of 9 basic aggregations and the interval type (microseconds up to weeks) and the interval time. Like with all rows, you will be able to select the specific tables you want at Tableau Data Source Screen and this supports Incremental Refreshes.
73 |
74 | #### Custom SQL
75 | This allows you to enter any custom sql that you could write into InfluxQL for any query not supported by the other two types. In addition, this supports multiple statements and multiple series.
76 |
77 | * Multiple statements - You can write multiple InfluxQL statements separated by ';'. For example,
78 | ```
79 | select * from tableA; select * from tableB
80 | ```
81 | Tableau will load the schema for tableaA and tableB and you can choose to then load the data individually or join them together (see note on aggregation below).
82 |
83 | * Multiple series - This connector supports grouping the data by series. In InfluxQL if you write a sql statement like `select * from tableC group by "someTag"` and someTag has multiple values Influx will return multiple series. See [group by](https://docs.influxdata.com/influxdb/v1.5/query_language/data_exploration/#group-by-tags) in the Influx help pages. This connector will union all of the data in each series into a single table. You can then format the data in any number of ways using Tableau.
84 |
85 | You can combine multiple series and multiple statements with the custom sql option. Incremental refreshes are not supported with custom sql at this time (please submit an issue if you feel this is important).
86 |
87 | ## Suggestions on use
88 | ### Tableau and Time Series
89 | Tableau works great with time data, but time series metrics can be a challenge. The most metrics you can have on a single graph is 2 (with Dual Axis). If you want to show many metrics you'll want to create a dashboard with individual measurements.
90 |
91 | ### Aggregation
92 | Aggregation is a great way to be able to do a row-level join on time series data that would otherwise not be joinable. When you aggregate to any interval, Influx will "fill in" the missing values with nulls. This should enable an inner join where you can use all of your data from a single Tableau Data Source. In Tableau, use your table with earliest/latest dates and then connect to it with a left-outer join.
93 |
94 | Aggregation can significantly decrease (or increase) the number of data points that are returned. If your DB stores 1000 measurements per second, and aggregate up to the minute you'll reduce the data by 59,999 points per minute. On the other hand, if you store 1 measurement per hour and aggregate by the milli-second you'll pull an extra 59,999 data points per minute.
95 |
96 | If you don't aggregate the measurements, then you will likely want to create a separate Tableau Data Source for each measurement.
97 |
98 | #### Do you need MAX in Tableau?
99 | By default, Tableau will try to SUM all of your measurements. If you bring data back and try to display it in Tableau at a higher level aggregation (eg you collect temperature readings every 20 minutes) and graph this at an hourly measurement, you may see you steady 80 degrees appear as 240 degrees!
100 |
101 | ## Limitations
102 |
103 | Currently, the admin user is needed to populate the list of databases. Once the extract is created if you want to refresh it you can enter a read (or write) only user account in Tableau.
104 |
--------------------------------------------------------------------------------
/InfluxDB.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | Bring in your time series data!
34 |