---
title: Tableau plugin
description: This tutorial provides instructions on using the Coralogix JDBC driver with Tableau.
url: https://coralogix.com/docs/user-guides/visualizations/tableau-plugin/
product: dashboards
feature: Dashboards
feature_id: dashboards
feature_identifier: dashboards/dashboards
last_updated: '2026-11-12'
---

# Tableau plugin

The [Coralogix JDBC driver](https://github.com/coralogix/coralogix-jdbc) allows you to investigate your log data with your favorite database tool using SQL queries.

JDBC, which stands for Java Database Connectivity, is a common standard for database drivers, and many popular querying tools support it. With the Coralogix JDBC driver, you can quickly get started on performing SQL queries against the data already stored in your Coralogix account.

This tutorial provides instructions on using the Coralogix JDBC driver with Tableau.

Note

Queries sent through the Coralogix JDBC driver reach your data without passing through the Coralogix query engine, so the [`$l` and `$m` field aliases](https://coralogix.com/docs/dataprime/language-reference/access_mechanisms.md#canonical-names-and-accepted-aliases) aren't resolved here. Use the field names and match semantics of the underlying store.

## Getting started

1

<!-- -->

.

Place the .jar files in the folder for your operating system. Create a folder if it doesn't exist already.

| OS      | Path                              |
| ------- | --------------------------------- |
| Windows | C:\Program Files\Tableau\Drivers  |
| Mac     | \~/Library/Tableau/Drivers        |
| Linux   | /opt/tableau/tableau\_driver/jdbc |

2

<!-- -->

.

Copy the [coralogix.tdc](https://github.com/coralogix/coralogix-jdbc/blob/master/coralogix.tdc) file to `~/Documents/My Tableau Repository/Datasources`. For more details, view the Tableau documentation  [here.](https://kb.tableau.com/articles/howto/using-a-tdc-file-with-tableau-server)

3

<!-- -->

.

Create a file `coralogix.properties` and add an entry with your `apiKey`. To use this API you need to [create](https://coralogix.com/docs/user-guides/account-management/api-keys/api-keys.md) a personal or team API key. It’s recommended to use permission presets, as they are automatically updated with all relevant permissions. Alternatively, you can manually add individual permissions.

| Preset       | Action                                                                                                                                                                                                             | Description                                                                                                                                                                                      |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| DataQuerying | `LEGACY-ARCHIVE-QUERIES:EXECUTE`<br />`LOGS.DATA-API#HIGH:READDATA`<br />`LOGS.DATA-API#LOW:READDATA`<br />`METRICS.DATA-API#HIGH:READDATA`<br />`SPANS.DATA-API#HIGH:READDATA`<br />`SPANS.DATA-API#LOW:READDATA` | Query Data from the Archive<br />Query Frequent Search Logs<br />Query Monitoring & Compliance Logs<br />Query Metrics<br />Query Frequent Search Spans<br />Query Monitoring & Compliance Spans |

```
apiKey=<cx_api_key>
```

1. On the main screen in `To a Server` section, select `Other Databases (JDBC)`.
2. Set `URL` to `jdbc:opensearch://https://api.eu2.coralogix.com/sql`. Select the
   <!-- -->
   https\://api./sql
   <!-- -->
   endpoint that corresponds to your Coralogix [domain](https://coralogix.com/docs/user-guides/account-management/account-settings/coralogix-domain.md) using the domain selector at the top of the page.
3. Set `Dialect` to `MySQL` and leave the `Username` and `Password` blank. Click on `Browse` next `Properties file` and choose `coralogix.properties` you created.
4. Click on `Sign In`.

The Coralogix SQL support is based on the [OpenDistro SQL](https://opendistro.github.io/for-elasticsearch-docs/docs/sql/sql-full-text/) interface. Refer to its documentation for further references on supported SQL features.