> For the complete documentation index, see [llms.txt](https://medomicslab.gitbook.io/medomics-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://medomicslab.gitbook.io/medomics-docs/tutorials/superset/superset-features.md).

# Superset Features

This page goes through all the superset features and provides information on how to use them.

### Connect to Other Databases

{% hint style="info" %}
Pro Tip: Ensure you have installed the proper database driver(s) for your database before attempting to establish the connection. You can find more details [here](https://superset.apache.org/docs/configuration/databases).
{% endhint %}

Superset provides users with a streamlined way to connect to various remote databases, including SQLite, PostgreSQL, and more. This feature enables the integration of remote data for creating dashboards and visualizing charts.

In MEDomicsLab, after [launching Superset](/medomics-docs/tutorials/superset.md#launch-superset-button), you can easily connect to any remote database via the "Connect a Database" interface. To access this, navigate to ***Settings -> Database Connections***

<figure><img src="https://4288370141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUO0RN9PzFLqAgLEwwaSn%2Fuploads%2FDPqbloVjRCSn3mfAKYmO%2FSupersetAddConnection.png?alt=media&amp;token=07d3a04e-ddcd-4e82-a56e-a25e842ddae6" alt=""><figcaption><p>How to open Database Connections Interface</p></figcaption></figure>

Once the interface is open (see image below), select your desired database—this tutorial uses PostgreSQL as an example.

<figure><img src="https://4288370141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUO0RN9PzFLqAgLEwwaSn%2Fuploads%2FF0JyFE5NDzvKzFHGg2qq%2FConnectDatabseInterface.PNG?alt=media&amp;token=3a745803-75dc-46fb-bbf8-520c9aee3d6b" alt=""><figcaption><p>Database Connections Interface</p></figcaption></figure>

Then enter your database credentials, such as the host, port, username, and other required details. Refer to the image below for guidance.

<figure><img src="https://4288370141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUO0RN9PzFLqAgLEwwaSn%2Fuploads%2Flc5dvwOWZoY7Nb0e3GQN%2FConnectDatabseSteps.png?alt=media&amp;token=162c69d0-5220-459d-9750-c73744eb8404" alt=""><figcaption><p>Connection interface to PostgreSQL through Superset</p></figcaption></figure>

Once you hit and ***CONNECT***, you should  see a confirmation message as depicted below:

<figure><img src="https://4288370141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUO0RN9PzFLqAgLEwwaSn%2Fuploads%2FCUteNBmxWJLSRpKHhJto%2FConnectDatabseSuccess.png?alt=media&amp;token=9fd3efce-5894-46ba-a8b5-c5a504ad73dd" alt=""><figcaption><p>Successful connection to database</p></figcaption></figure>

If you encounter an error, please refer to the [Superset documentation](https://superset.apache.org/docs/configuration/databases) for guidance on troubleshooting the issue. Should the problem persist, feel free to [reach out to us](/medomics-docs/forms/contact-us.md) for further assistance.

### Explore & Visualize

To explore data from your connected dataset, you can use either SQL Lab or the "Add Dataset" option, as illustrated in the figure below:

* ***SQL Lab***: Provides a complete preview of the data, displays column data types, and allows for custom SQL queries on the dataset.

<figure><img src="https://4288370141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUO0RN9PzFLqAgLEwwaSn%2Fuploads%2FD4oW0eHovdIOOoe7aEj1%2FSQLLab.png?alt=media&amp;token=e1dc49b6-3e32-436d-be6f-8a7c2ca8f655" alt=""><figcaption><p>SQL Lab depiction</p></figcaption></figure>

<figure><img src="https://4288370141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUO0RN9PzFLqAgLEwwaSn%2Fuploads%2F2s5N3SIGy8rUo2OQVHHC%2FSQLLabSaveDataset.png?alt=media&amp;token=c8dc0f16-81f0-4956-9218-b8dc66f592db" alt=""><figcaption><p>How to save the output data of your SQL query</p></figcaption></figure>

* ***Add new dataset***: Lets you explore the columns and their data types, with the ability to create charts based on the data if needed.

<figure><img src="https://4288370141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUO0RN9PzFLqAgLEwwaSn%2Fuploads%2F95hRgX2jBBoBJSD3Saj8%2FCreateNewDataset.png?alt=media&amp;token=e6f35ecf-c9a1-4588-9231-42077a41579f" alt=""><figcaption><p>Steps to create a dataset and a chart from a connected database</p></figcaption></figure>

### Create Dashboards

One of the main features of Superset is charts and dashboard creation. It offers a no-code procedure for building charts quickly. To do so:

* Create a new dashboard:

<figure><img src="https://4288370141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUO0RN9PzFLqAgLEwwaSn%2Fuploads%2Fr2y0ocNzUxYqOgyLhOdS%2FNewDashboard.png?alt=media&amp;token=22c08b97-da05-4d94-9e13-6adea182895c" alt=""><figcaption><p>Create new dashboard steps</p></figcaption></figure>

* Create a new chart and add it to the dashboard:

<figure><img src="https://4288370141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUO0RN9PzFLqAgLEwwaSn%2Fuploads%2FwYeInG5FxPqgX2iLmYct%2FnewChart.png?alt=media&amp;token=1c94892a-4894-4eb6-bffc-d9aa5c44f477" alt=""><figcaption><p>Create new chart and add it to a dashboard</p></figcaption></figure>

### Export Data to Workspace

Superset enables data exportation through SQL Lab. This empowers users to further process and explore their data within MEDomicsLab by leveraging the different tools available.

<figure><img src="https://4288370141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUO0RN9PzFLqAgLEwwaSn%2Fuploads%2FThvJC9aM1tKJ3VqZ5kkS%2FExportToWS.png?alt=media&amp;token=fbbff8f2-95f8-4f77-a844-801e4b6a6e6e" alt=""><figcaption><p>Export data to your local workspace</p></figcaption></figure>

### Useful resources

* How to [configure your Superset](https://superset.apache.org/docs/configuration/configuring-superset)?
* [Connect to a database](https://superset.apache.org/docs/configuration/databases).
* How to [use Superset](https://superset.apache.org/docs/using-superset/creating-your-first-dashboard) (dashboard creation, data exploration, etc.)
* [FAQ](https://superset.apache.org/docs/faq)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://medomicslab.gitbook.io/medomics-docs/tutorials/superset/superset-features.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
