# Superset

## Start Superset with Docker Image

Start running [Superset Image](https://hub.docker.com/repository/docker/apachepinot/pinot-superset) with pre-built Superset Pinot connector.

{% tabs %}
{% tab title="Docker" %}
1\. Run below command to start a standalone Superset deployment

```
docker run \
  --network pinot-demo \
  --name=superset \
  -p 8088:8088 \
  -d apachepinot/pinot-superset:latest
```

2.1. (First time) Set up Admin account by running below command and follow instructions to set password.

```
docker exec -it superset superset fab create-admin \
               --username admin \
               --firstname Superset \
               --lastname Admin \
               --email admin@superset.com \
               --password admin
```

2.2. (First time) DB upgrade and Initialize Superset

```
docker exec -it superset superset db upgrade
docker exec -it superset superset init
```

3\. Import Pre-defined Pinot Datasources and Dashboard

```
docker exec \
    -t superset \
    bash -c 'superset import_datasources -p /etc/examples/pinot/pinot_example_datasource_quickstart.yaml && \
             superset import_dashboards -p /etc/examples/pinot/pinot_example_dashboard.json'
```

4\. Go to SuperSet UI: <http://localhost:8088/> to play around with dashboard.
{% endtab %}
{% endtabs %}

## Advanced Setup

### Adding Pinot Database

In order to add Pinot cluster as a database, a SQLAlchemy URI is required.

The format of URI is:

`pinot://<pinot-broker-host>:<pinot-broker-port><pinot-broker-path>?controller=<pinot-controller-host>:<pinot-controller-port>`

E.g.

> `pinot://pinot-broker:8099/query/sql?controller=http://pinot-controller:9000/`

Click `TEST CONNECTION` to check if the Pinot cluster is successfully connected.

### Adding Pinot Table

User can add an existing table into Superset:

![Add Table Definition](https://content.gitbook.com/content/ty6SYllypxp3MTxsZRrb/blobs/0NTqDGgOGe556NTsogl2/image.png)

![Table Definition](https://content.gitbook.com/content/ty6SYllypxp3MTxsZRrb/blobs/HivooYCCf0PlzTzCzy03/image.png)

User can edit table/column definition by clicking the `edit` button left to the table name.

### Configuring time column

User can configure an existing column `mergedTimeMillis` as temporal and set `Datetime Format` accordingly.

![Configure time column](https://content.gitbook.com/content/ty6SYllypxp3MTxsZRrb/blobs/xqz0BXwfn2symUmCJDxj/image.png)

### Adding a derived column

User can also add a new column by setting the expression.

![Add a simple derived column](https://content.gitbook.com/content/ty6SYllypxp3MTxsZRrb/blobs/HOYKbTGCB5Ur38RlD3ZB/image.png)

Another example:

![Add a derived column with Pinot UDFs](https://content.gitbook.com/content/ty6SYllypxp3MTxsZRrb/blobs/lHbBCbiixOycBuYB4Je7/image.png)