These are the docs for the Metabase master branch. Some features documented here may not yet be available in the latest release. Check out the docs for the latest version, Metabase v0.53.

Presto

To add a database connection, click on the gear icon in the top right, and navigate to Admin settings > Databases > Add a database.

Fill out the fields for that database, and click Save changes at the bottom.

Edit connection details

You can edit these settings at any time. Just remember to save your changes.

Display name

The display name for the database in the Metabase interface.

Host

Your database’s IP address, or its domain name (e.g., esc.mydatabase.com).

Port

The database port. E.g., 8080.

Catalog

Presto catalogs contain schemas and reference data sources via a connector.

Schema (optional)

Only add tables to Metabase that come from a specific schema.

Username

The database username for the account that you want to use to connect to your database. You can set up multiple connections to the same database using different user accounts to connect to the same database, each with different sets of privileges.

Password

The password for the username that you use to connect to the database.

Use a secure connection (SSL)

Metabase automatically tries to connect to databases with SSL first, then without if that doesn’t work. If it’s possible to connect to your database with an SSL connection, Metabase will make that the default setting for your database. If you prefer to connect without this layer of security, you can always change this setting later, but we highly recommend keeping SSL turned on to keep your data secure.

Use SSL certificate?

Metabase supports both keystores and truststores.

Keystore

You can specify a local file path, or upload a keystore. You’ll also need to input your keystore password.

Truststore

You can specify a local file path, or upload a truststore. You’ll also need to input your truststore password.

Authenticate with Kerberos

Kerberos settings include:

  • Kerberos principal (e.g., service/instance@REALM)
  • Kerberos coordinator service (e.g., presto)
  • You can use a canonical hostname.
  • Kerberos credential cache file (e.g., /tmp/kerbo-credential-cache)
  • Kerberos keytab file (e.g., /path/to/kerberos.keytab)
  • Kerberos configuration file (e.g., /etc/krb5.conf)
  • Presto coordinator Kerberos service principal pattern (e.g., ${SERVICE}@${HOST}.${SERVICE}

Additional JDBC connection string options

You can append options to the connection string that Metabase uses to connect to your database.

Re-run queries for simple explorations

Turn this option OFF if people want to click Run (the play button) before applying any Summarize or filter selections.

By default, Metabase will execute a query as soon as you choose an grouping option from the Summarize menu or a filter condition from the drill-through menu. If your database is slow, you may want to disable re-running to avoid loading data on each click.

Choose when syncs and scans happen

See syncs and scans.

Periodically refingerprint tables

Periodic refingerprinting will increase the load on your database.

Turn this option ON to scan a sample of values every time Metabase runs a sync.

A fingerprinting query examines the first 10,000 rows from each column and uses that data to guesstimate how many unique values each column has, what the minimum and maximum values are for numeric and timestamp columns, and so on. If you leave this option OFF, Metabase will only fingerprint your columns once during setup.

Danger zone

See Danger zone.

Further reading

Read docs for other versions of Metabase.