Applies to: 
Kyvos Enterprise Kyvos Cloud (SaaS on AWS) Kyvos AWS Marketplace
Kyvos Azure Marketplace Kyvos GCP Marketplace Kyvos Single Node Installation (Kyvos SNI)
To connect Tableau Server (On-prem) to Kyvos semantic models, you can use any of the following methods:
Publish data source on Tableau Server
Open Tableau desktop.
Connect to the Kyvos data source using the Tableau Server (On-prem) on Kyvos or TDS metadata file.
From the Server menu and select the Publish Data Source option, and select your data source (Kyvos semantic model).
On the displayed Tableau Server Sign in dialog, provide the Tableau Server URL and click the Connect button.
Enter details in the Publish Data Source to Tableau Server dialog box.
Click the Publish button. Your workbook will be published on the Tableau Server.
Publish Workbook on Tableau Server
Create a worksheet/visualization as per your business requirement on the Tableau desktop.
From the Server menu, select the Publish Workbook option.
The Publish Workbook to Tableau Server dialog box is displayed.
Enter details as:
Select the Project to which the workbook belongs.
From the Name drop-down, select the workbook that you want to publish.
Optionally, provide a Description and Tags.
To select specific sheets or dashboards to publish, click the Edit link under Sheets, and select the requisite sheets. To publish only Dashboard, click the Only Dashboards button. To publish all sheets and dashboards, click the All button.
NOTE: By default, all sheets and dashboards present in the workbook are published.
Click the Edit link under Permission to specify data source authentication. You can select the Embedded Password or Prompt User option as needed.
Click the Publish button. The workbook will be published on the Tableau server and can be accessed from the Tableau Server as well.
Connect to Kyvos semantic model through Tableau Server interface
Login to Tableau Server.
Click New and select the Workbook option.
On the New Workbook screen, go to the Connectors tab and select Kyvos or Spark SQL option.
On the displayed Kyvos dialog box, enter your connection information as:
Parameter Description Server
IP address or hostname of your Kyvos Web App Server.
HTTP Path
Client path for Kyvos Web portal.
Port
TCP port that the Kyvos Web App server uses to listen to client requests.
Username
Kyvos Web App Server Username.
Password
Kyvos Web App Server Password.
Require SSL
Select the checkbox if connecting to an SSL Server.
Click Sign In.
On the Data Source page, select your Schema, then select the Table that you want to browse in Tableau. The Kyvos data store is loaded in Tableau. You can now use your data to create reports.
Connecting to Kyvos semantic models through Tableau interface
Tableau Software released a new custom Kyvos connector with its latest version, Tableau 2019.4. Here are the steps that can help you get productive right away using the Kyvos Tableau Connector.
To connect Tableau to a Kyvos semantic model and set up the data source, you must first have this connection information:
Name of the server that hosts the database you want to connect
Port number for client requests
HTTP path to the server
User name and password
Are you connecting to an SSL server?
(Optional) Initial SQL statement to run every time Tableau connects
On the Tableau window, select the Kyvos option from the To a Server list on the navigation pane.
In the displayed Kyvos dialog box, enter your connection information as:
In the Server field, type the IP address or hostname of your Kyvos Web App server.
In the Port field, type the number of the TCP port that the Kyvos Web App server uses to listen for client requests.
In the HTTP Path field, type your client path.
In the Username field, type your Kyvos Web App Server Username.
In the Password field, type your Kyvos Web App Server Password
Select the Require SSL checkbox if connecting to an SSL Server.
(Optional) Select Initial SQL to specify a SQL command to run at the beginning of every connection, such as when you open the workbook, refresh an extract, sign in to Tableau Server, or publish to Tableau Server. For more information, see Run Initial SQL.
Click Sign In. On the Data Source page, select your Schema, then select Table that you want to browse in Tableau.
The Kyvos data store is loaded in Tableau. You can now use your data to create reports.
Here’s a sample Tableau worksheet with the Kyvos connection.
Connecting Kyvos semantic models using Tableau Data Source connection
When you use a TDS file, you will see the dimensions, hierarchies, measures, levels, and attributes as they are configured in the Kyvos semantic model. If you generate a TDS file from the Kyvos web portal and publish it to the Tableau Server, you don’t need to provide the connection details to your users. A TDS file contains the metadata of the semantic model and connection information.
Create a TDS File in Kyvos
From the Kyvos Web portal, click Toolbox > Utilities.
Select the Export Semantic Model Metadata option from the list.
Select the semantic model you want to browse and click Download Selected.
In the Download Selected Semantic Model Metadata dialog box, select the Tableau Data Source (Spark SQL) option from the Format drop-down.
Enter the details in Tableau Version, Server IP/Hostname, Server Port, and optionally the username used to connect.
Click Download.
Connecting to Kyvos semantic models using TDS File on Tableau Server or Tableau Desktop
Once you have downloaded the TDS file, you can connect Kyvos semantic models using this TDS file on Tableau Server and Tableau Desktop. For this, open the TDS file in Tableau, enter your credentials, and click Sign In.
Optionally, edit the connection details by using the Edit Connection option.
Publish the TDS file and allow Tableau to pre-load the cube metadata. Your cube is now ready for your users.