> For the complete documentation index, see [llms.txt](https://docs.e6data.com/query-engine/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.e6data.com/query-engine/developers/bi-tool-recipes/metabase.md).

# Metabase

Connect Metabase to the e6data query engine using the e6data driver.

Metabase is an open-source business intelligence tool for exploring and visualizing data. This guide connects Metabase to the e6data query engine.

## Requirements

* A running instance of Metabase (see the [Metabase docs](https://www.metabase.com/docs/latest) for installation).
* The latest [e6data JDBC driver](/query-engine/developers/connecting-to-the-engine/jdbc.md).
* A [Direct or TLS connection](broken://pages/Wh4d9jql2OPH1ux7JE4O) on your cluster.
* The connection details from the cluster's **Connection Information** tab - host, port, catalog, database, username, and password (a [personal access token](/query-engine/guides/security/access-tokens/pat-and-service-account-keys.md)).

## Connect

1. **Deploy the e6data driver.** Download the latest e6data Metabase driver JAR, copy it into the Metabase `/plugins/` directory, and restart Metabase to load it.
2. Open the Metabase web interface and go to the gear icon → **Admin settings → Databases → Add a database**.
3. Enter the connection parameters:
   * **Database Type**: `e6data`
   * **Display Name**: a name for the database in Metabase
   * **Host**: the cluster's IP address or domain name
   * **Port**: the cluster port (for example, `80`)
   * **Catalog**: the catalog attached to the cluster
   * **Database**: the database within that catalog
   * **Username**: your e6data login
   * **Password**: a personal access token
4. Add JDBC string parameters as needed:
   * **Direct connectivity**: `AUTO_RESUME=true` (optional) to enable cluster auto-resume.
   * **TLS connectivity**: `secure=true` (required), `cluster-uuid=<uuid>` (required), and optionally `AUTO_RESUME=true`.

{% hint style="info" %}
Following the steps in this order results in a successful connection to e6data through Metabase.
{% endhint %}

## TLS/HTTPS

e6data uses globally trusted certificates, so the host and port from the connection dialog are sufficient. Any cluster requiring authentication also requires TLS/HTTPS - use the cluster's HTTPS URL in the connection string.

## See also

* [JDBC](/query-engine/developers/connecting-to-the-engine/jdbc.md)
* [Endpoints and cluster ingress](broken://pages/Wh4d9jql2OPH1ux7JE4O)
* [Access tokens](/query-engine/guides/security/access-tokens.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.e6data.com/query-engine/developers/bi-tool-recipes/metabase.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.