Tableau documentation for Cloud Serverless (#4988)
parent
7725331554
commit
eef54e021c
|
|
@ -63,7 +63,7 @@ To query {{< cloud-name >}} from Tableau, use the **Flight SQL protocol** and th
|
|||
1. Open Tableau
|
||||
2. In the **Connect** column, under **To a Server**, select **Other Databases (JDBC)**.
|
||||
If that option isn't in the initial list, select **More...** to find it in
|
||||
all the connection options.
|
||||
the full list of connection options.
|
||||
3. Provide the required credentials:
|
||||
|
||||
- **URL**: Your **InfluxDB Cloud Dedicated cluster URL** with the following:
|
||||
|
|
|
|||
|
|
@ -0,0 +1,103 @@
|
|||
---
|
||||
title: Use Tableau to query data with SQL
|
||||
seotitle: Use Tableau to query data stored in InfluxDB Cloud Serverless
|
||||
description: >
|
||||
Install and use [Tableau](https://www.tableau.com/) to query data stored in InfluxDB.
|
||||
weight: 101
|
||||
menu:
|
||||
influxdb_cloud_serverless:
|
||||
parent: Execute SQL queries
|
||||
name: Use Tableau
|
||||
identifier: query-with-tableau
|
||||
influxdb/cloud-serverless/tags: [query, flightsql, tableau, sql]
|
||||
---
|
||||
|
||||
Use [Tableau](https://www.tableau.com/) to query and visualize time series data
|
||||
stored in {{< cloud-name >}}. Tableau supports multiple SQL dialects.
|
||||
|
||||
> Tableau is a visual analytics platform transforming the way we use data to
|
||||
> solve problems—empowering people and organizations to make the most of their data.
|
||||
>
|
||||
> {{% cite %}}[tableau.com](https://www.tableau.com/why-tableau/what-is-tableau){{% /cite %}}
|
||||
|
||||
{{% note %}}
|
||||
#### Tableau Desktop
|
||||
|
||||
These instructions are for **Tableau Desktop**.
|
||||
Tableau Cloud and other Tableau products have not been tested, but may support
|
||||
connecting to {{< cloud-name >}} through the **Flight SQL JDBC driver**.
|
||||
{{% /note %}}
|
||||
|
||||
## Install Tableau Desktop
|
||||
|
||||
If you have not already, [download and install Tableau Desktop](https://www.tableau.com/products/desktop/download).
|
||||
|
||||
## Download and install the Flight SQL JDBC driver
|
||||
|
||||
To query {{< cloud-name >}} from Tableau, use the **Flight SQL protocol** and the
|
||||
**Flight SQL JDBC driver**.
|
||||
|
||||
1. **Download the Flight SQL JDBC driver.**
|
||||
1. Visit the [Flight SQL JDBC driver](https://central.sonatype.com/artifact/org.apache.arrow/flight-sql-jdbc-driver/) page.
|
||||
2. Select the **Versions** tab.
|
||||
3. Click **Browse {{< icon "export" >}}** next to the version you want to
|
||||
download.
|
||||
4. Click the `flight-sql-jdbc-driver-XX.XX.XX.jar` file
|
||||
(with only the `.jar` file extension) from the list of files
|
||||
to download the driver jar file.
|
||||
The version number in the file name is specific to the version you selected.
|
||||
|
||||
2. **Copy the downloaded jar file into the following directory based on your operating system.**
|
||||
|
||||
- **Windows**: `C:\Program Files\Tableau\Drivers`
|
||||
- **Mac**: `~/Library/Tableau/Drivers`
|
||||
- **Linux**: `/opt/tableau/tableau_driver/jdbc`
|
||||
|
||||
3. **Start or restart Tableau.**
|
||||
|
||||
## Configure a JDBC server connection
|
||||
|
||||
1. Open Tableau
|
||||
2. In the **Connect** column, under **To a Server**, select **Other Databases (JDBC)**.
|
||||
If that option isn't in the initial list, select **More...** to find it in
|
||||
the full list of connection options.
|
||||
3. Provide the required credentials:
|
||||
|
||||
- **URL**: Your [InfluxDB Cloud Serverless region URL](/influxdb/cloud-serverless/reference/regions/)
|
||||
with the following:
|
||||
|
||||
- **Protocol**: `jdbc:arrow-flight-sql`
|
||||
- **Port**: `443`
|
||||
- **Query parameters**:
|
||||
- **disableCertificateVerification**: `true`
|
||||
- **database**: InfluxDB bucket name to query
|
||||
|
||||
_See an [example connection URL](#example-connection-url)._
|
||||
|
||||
- **Dialect**: PostreSQL
|
||||
- **Username**: _Leave empty_
|
||||
- **Password**: [API token](/influxdb/cloud-serverless/admin/tokens/)
|
||||
with read access to the specified bucket
|
||||
- **Properties File**: _Leave empty_
|
||||
|
||||
4. Click **Sign In**.
|
||||
|
||||
#### Example connection URL
|
||||
|
||||
{{< code-placeholders "BUCKET_NAME" >}}
|
||||
```
|
||||
jdbc:arrow-flight-sql://us-east-1-1.aws.cloud2.influxdata.com:443?disableCertificateVerification=true&database=BUCKET_NAME
|
||||
```
|
||||
{{< /code-placeholders >}}
|
||||
|
||||
## Query InfluxDB Cloud Serverless
|
||||
|
||||
With the connection successfully established, query your time series data stored
|
||||
in {{< cloud-name >}}. In the left pane:
|
||||
|
||||
1. Under **Database**, select **public** from the drop-down menu.
|
||||
2. Under **Schema**, select **iox** from the drop-down menu.
|
||||
3. Under **Table**, click and drag the measurement you want to query into the query pane.
|
||||
4. Use Tableau to build and execute SQL queries.
|
||||
For more information, see the
|
||||
[Tableau Desktop documentation](https://help.tableau.com/current/pro/desktop/en-us/default.htm).
|
||||
Loading…
Reference in New Issue