Documentation
Vertica
Connect TableR to Vertica, a columnar analytics database, with connection fields, SSL/TLS, verifying the connection, and troubleshooting.
Vertica is a columnar analytics database built for large-scale queries. Point TableR at your Vertica host by filling the connection form.
Overview
TableR connects to Vertica over its native protocol. It works with a self-hosted cluster or a managed Vertica service; the columnar storage is designed for analytical (OLAP) workloads over large datasets.
- Self-hosted — connect to your Vertica host on port 5433.
- Remote / managed — use the provider endpoint and enable SSL/TLS.
- Columnar analytics — optimized for large scans and aggregations rather than single-row lookups.
Before you start
- A reachable Vertica host (host and port).
- A database user name — this is required.
- The user's password, if the database requires one.
- Optionally, the specific database to open on connect.
- For remote hosts: network access to the port and, usually, SSL/TLS enabled.
Connection fields
These defaults match TableR's Vertica connection form. Secrets are written to the operating system keyring, never to plain configuration files.
| Field | Required | Default | Notes |
|---|---|---|---|
| Host | Yes | 127.0.0.1 | Hostname or IP of your Vertica host. |
| Port | Yes | 5433 | Vertica's default port. Change it only if your host listens elsewhere. |
| Username | Yes | — | The database user used to authenticate. |
| Password | No | — | Optional; stored in the OS keyring. |
| Database | No | — | Optional. When empty, the user's default database is used. |
| SSL/TLS | No | Off | Enable for remote hosts; many managed providers require it. |
Connect with the form
- 1Choose Vertica
Open the launcher and pick the Vertica card.
- 2Enter host and port
Use 127.0.0.1 and 5433 for a local host, or your provider's endpoint for a remote one.
- 3Add credentials
Type the username, and the password if required. The password is saved to the OS keyring.
- 4Pick a database (optional)
Set a database to open it directly, or leave it blank to use the user's default.
- 5Enable SSL/TLS for remote
Turn on SSL/TLS when connecting to a remote or managed host.
- 6Save and connect
Save the profile so it reappears in the launcher, then connect.
SSL/TLS
Local hosts on 127.0.0.1 usually need no encryption. For anything over a network, enable SSL/TLS so credentials and results are protected in transit.
- Off — no encryption (local or trusted networks only).
- On — encrypt the connection to the Vertica host.
- Enable it for any remote or managed host.
Verify the connection
Once connected, open a SQL tab and run a quick check:
SELECT version();
SELECT current_database(), current_user;If both statements return rows, the connection and credentials are working.
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| Connection refused | Host not running, wrong host/port, or a firewall. | Confirm the host is up and the port is reachable; re-check host and port. |
| Authentication failed | Wrong username or password. | Re-check the credentials and update the saved password (it lives in the keyring). |
| SSL / encryption required | The host requires TLS. | Enable SSL/TLS for the connection. |
| Database does not exist | The Database field names a database that is missing. | Leave Database empty, or enter one that exists. |