diff --git a/presto-docs/src/main/sphinx/clients.rst b/presto-docs/src/main/sphinx/clients.rst index 4f0a4613b415e..f100750529d7d 100644 --- a/presto-docs/src/main/sphinx/clients.rst +++ b/presto-docs/src/main/sphinx/clients.rst @@ -7,4 +7,5 @@ Presto Clients clients/presto-cli clients/presto-console + clients/superset clients/dbeaver diff --git a/presto-docs/src/main/sphinx/clients/superset.rst b/presto-docs/src/main/sphinx/clients/superset.rst new file mode 100644 index 0000000000000..6f75185404078 --- /dev/null +++ b/presto-docs/src/main/sphinx/clients/superset.rst @@ -0,0 +1,37 @@ +=============== +Apache Superset +=============== + +`Apache Superset `_ is an open source data exploration tool that is part of the Apache Project. +Follow these steps to configure Superset to query Presto. + +1. Install or deploy Superset from the `Superset documentation `_. + + Note: When running Superset for the first time, an error may be displayed similar to the following: + + `validating superset/docker-compose-image-tag.yml: services.db.env_file.0 must be a string` + + See `Superset discussion 28184 `_ for more information. + +2. You may need `pyhive` to configure Superset to connect to Presto. See `Presto `_. + +3. Log into Superset as described in `Log into Superset `_. + +4. In the Superset UI, select `+` in the upper right to display the drop-down menu, then select `Data`, then `Connect database`. + +5. In the `Connect a database` window, select `Presto`. + +6. In `SLQAlchemy URI`, enter a connection string using the following format: + + `presto://{hostname}:{port}/{database}` + + For example, `presto://:8080/system` + + For more information, see the Superset documentation for connecting to `Presto `_. + +7. Select `Test Connection`. If the message `Connection looks good!` is displayed, continue. + + Note: If your Presto server is running locally, `localhost` may not resolve DNS successfully from the Superset docker-compose launched instance to the local Presto server. Replace `` with your system's actual IP address. + +8. Select `Connect`. +