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.

FieldRequiredDefaultNotes
HostYes127.0.0.1Hostname or IP of your Vertica host.
PortYes5433Vertica's default port. Change it only if your host listens elsewhere.
UsernameYesThe database user used to authenticate.
PasswordNoOptional; stored in the OS keyring.
DatabaseNoOptional. When empty, the user's default database is used.
SSL/TLSNoOffEnable for remote hosts; many managed providers require it.

Connect with the form

  1. 1
    Choose Vertica

    Open the launcher and pick the Vertica card.

  2. 2
    Enter host and port

    Use 127.0.0.1 and 5433 for a local host, or your provider's endpoint for a remote one.

  3. 3
    Add credentials

    Type the username, and the password if required. The password is saved to the OS keyring.

  4. 4
    Pick a database (optional)

    Set a database to open it directly, or leave it blank to use the user's default.

  5. 5
    Enable SSL/TLS for remote

    Turn on SSL/TLS when connecting to a remote or managed host.

  6. 6
    Save 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

SymptomLikely causeFix
Connection refusedHost not running, wrong host/port, or a firewall.Confirm the host is up and the port is reachable; re-check host and port.
Authentication failedWrong username or password.Re-check the credentials and update the saved password (it lives in the keyring).
SSL / encryption requiredThe host requires TLS.Enable SSL/TLS for the connection.
Database does not existThe Database field names a database that is missing.Leave Database empty, or enter one that exists.

Next steps