Tableau

Connect to Tableau

Connect Tableau to your Codd Semantic Layer

Overview

Connect Tableau to your Codd Semantic Layer to access your data through a PostgreSQL connection. This integration allows you to leverage Tableau's powerful visualization capabilities with your Codd corpus data.

Connection Method: We use the standard PostgreSQL connector in Tableau to connect to your Codd Semantic Layer, providing seamless integration without requiring custom drivers.

Prerequisites

Codd workspace with at least one corpus

Ensure you have a Codd workspace with at least one corpus created

Tableau Desktop version 2021.1 or higher

Ensure you have Tableau Desktop version 2021.1 or higher installed

Codd API key

Generate your API key from Settings → API Keys in your Codd workspace

Tableau Setup

01

Open Tableau Desktop

Launch Tableau Desktop and prepare to connect to your Codd Semantic Layer.

Getting Started:

  1. Open Tableau Desktop
  2. Click "Connect" from the start screen
  3. Navigate to "To a Server" section
02

Select PostgreSQL Connector

Choose the PostgreSQL connector to connect to Codd's semantic layer.

In the Connect dialog:

  1. Navigate to "More..." under "To a Server"
  2. Select "PostgreSQL" from the list
  3. Click "Connect"
03

Configure Connection

Enter the connection details in the PostgreSQL connection dialog.

Corpus Name

Select a corpus

The corpus you want to access from Tableau

Connection Parameters

Server: [Your Codd server URL]
Database: <corpus_name>

Select a corpus above to generate the database name

04

Authentication

Enter your authentication credentials.

Authentication Details

Username: 1285ec42-1fbb-46c0-b495-0c114b46b8bd/2ec0400f-c33e-4b2c-b9c1-16e1a24aa310/eaaaa00e-4828-479b-a962-49412dccdc4f

Format: tenantId/brainId/userId ( use your own tenantId, brainId and userId) the above username is just an example

Password: Go to API Keys

Use your API key as the password

05

Complete Connection

Final Steps:

  1. Click "Sign In" in the authentication dialog
  2. Wait for Tableau to establish the connection
  3. Select the tables/views you want to use
  4. Click "OK" to load the data

Troubleshooting

Network & Firewall Configuration

  • Whitelist the Codd Semantic Layer endpoint in your firewall
  • If behind corporate firewall, contact your IT team to allow traffic to the server URL
  • Ensure SSL/TLS connections are permitted for secure data transfer
  • Configure proxy settings if required by your network

Common Issues

  • Verify username format: tenantId/brainId/userId
  • Check API key permissions and ensure it hasn't expired
  • Confirm corpus name is exact (case-sensitive)
  • Reconnect in Tableau after making configuration changes