Install Tableau Hyper API


This topic describes the requirements for installing and using the Hyper API library. You can download the Hyper API library packages from the Hyper API - Products Release and Download page. Select the Hyper API package for your programming language and operating system. Follow the instructions for installing the library for your programming language and operating system as described below.

In this section


Install the Hyper API for Python 3.6 and 3.7

Hyper API for Python requirements

Hyper API for Python installation

  1. The following instructions assume that you have set up a virtual environment for Python. For more information on creating virtual environments, see venv - Creation of virtual environments in the Python Standard Library.

  2. Open a terminal and navigate to the venv directory.

  3. Install the tableauhyperapi module using pip.

     pip install tableauhyperapi
    

    If you previously installed the tableauhyperapi, you can upgrade to the latest version using the following command.

     pip install --upgrade tableauhyperapi
    

    Linux installations require pip version 19.3 or newer. Note that pip versions 20.0 and 20.1 are not working because of issues with pip.

    Alternatively, you can download the Python Hyper API package file (.whl file) for your operating system. See Hyper API - Products Release and Download.

    • Use pip to install the .whl file you downloaded.
      • On Windows: Scripts\pip install [path_to_whl_file]
      • On Linux/macOS: bin/pip install [path_to_whl_file]
  4. Download and try the examples:

    • Download and unzip the Python .zip package for your operating system.
    • Open a terminal and navigate into the examples directory.
    • Run the Python examples (for example, try insert_data_into_single_table.py).
      • On Windows: [venv_directory]\Scripts\python insert_data_into_single_table.py
      • On Linux/macOS: [venv_directory]/bin/python insert_data_into_single_table.py

Install the Hyper API for C++

Hyper API for C++ requirements

Hyper API for C++ installation instructions

  1. Download the C++ Hyper API package file (.zip file) for your operating system. See Hyper API - Products Release and Download.
  2. Unzip the Hyper API package file to a convenient location.
  3. To build and run the examples on the command line:
    • Open a terminal. On Windows, open the VS2019 x64 Native Tools Command Prompt.
    • Navigate into the examples directory of the extracted C++ Hyper API package.
    • Configure the project with cmake:
      • On Windows: cmake -G "Visual Studio 16 2019 Win64" .
      • On Linux/macOS: cmake .
    • Build the examples:
      • On Windows: cmake --build . --config Debug or cmake --build . --config Release
      • On Linux/macOS: cmake --build .
    • Run the examples
      • On Windows: ctest --verbose -C Debug or ctest --verbose -C Release
      • On Linux/macOS: ctest --verbose
  4. To build and run the examples in Visual Studio, go to File > Open > Folder and select the examples directory of the tableauhyperapi-cxx package.
  5. If you want to build your own applications, you need to install the Hyper API library on your computer. To do this:
    • On Windows: Append the extracted bin directory to your system PATH variable.
    • On Linux: Append the extracted lib directory to your system LD_LIBRARY_PATH variable.
    • On macOS: You need to include the lib directory as RPATH for every binary.

Install the Hyper API for Java

Hyper API for Java requirements

Hyper API for Java installation instructions

  1. Download the Java Hyper API package file (.zip file) for your operating system. See Hyper API - Products Release and Download.
  2. Unzip the Hyper API package file to a convenient location.
  3. To build and run the examples on the command line:
    • Open a terminal and navigate into the examples directory of the extracted Java Hyper API package.
    • Build the examples: gradle build
    • Run the examples: gradle run
  4. You can import the example project into IntelliJ or Eclipse:
    • IntelliJ:
      • Import the Hyper API into IntelliJ by opening the build.gradle file from the unzipped Hyper API package.
      • In the Gradle view, choose an example and select Tasks > application > run.
    • Eclipse:
      • You need to have a recent version of Eclipse installed to use Gradle.
      • Import the Hyper API into Eclipse as an existing Gradle project (File > Import > Gradle > Existing Gradle Project).
      • Select the directory of the unzipped Hyper API package as the “Project root directory”.
      • Select Override workspace settings in the “Import Options” dialog and use at least Gradle version 5.5.
      • In the Gradle Tasks view, choose an example and select application > run.
  5. You can create new projects that use the Hyper API in IntelliJ or Eclipse:
    • Create a new Java project. Make sure the JDK is set to Java 8, that is, JavaSDK-1.8.
    • Add the following libraries from the lib directory of the unzipped Hyper API package as external JARs: tableauhyperapi.jar tableauhyperapi-windows.jar (Windows), tableauhyperapi-linux.jar (Linux), tableauhyperapi-darwin.jar (macOS) jna-5.2.0.jar
    • Copy the hyper folder from the lib directory of the unzipped Hyper API package next to the JARs, as in the example project.
    • To enable proper Javadoc, add the hapi-javadoc.jar from the lib directory as the Javadoc archive.

Install the Hyper API for .NET

You can install the Hyper API for .NET in two ways. You can either download the .zip file that contains the library and example code, or you can install the NuGet package for the library, either directly, or by adding a reference to your project. The following section describes the requirements for .NET and the installation instructions for both methods.

Hyper API for .NET requirements

Using the Tableau Hyper API NuGet package

The Hyper API library is available as a NuGet package. To use the library, you need to add a reference to the Tableau.HyperAPI.NET package in your project. Use the NuGet Package Manager in Visual Studio, or for other installation options, see Tableau.HyperAPI.NET in the NuGet Gallery.

Hyper API for .NET installation from the download (.zip) package

In addition to using the NuGet package, you can also download the Hyper API library for .NET. The download package includes the .NET examples for the Hyper API.

  1. From the Hyper API - Products Release and Download, download the .NET Hyper API package file (.zip file) for your operating system. The files are identified as tableauhyperapi-dotnet-

  2. Unzip the Hyper API package file to a convenient location.

  3. Build and run the examples.

    • To run the examples, you need to install .Net Core 2.2 SDK or newer. You can install it from Download .NET.
    • To build the example project, open a terminal, navigate into the example directory and run:
      • On Windows: build.bat
      • On Linux/macOS: ./build.sh
    • Then run the examples with dotnet run. For example, dotnet run -- insert-data-into-single-table

    Note: The examples assume that you have .NET Core 2.2 installed. Depending upon the version of the .NET Core Framework you are using (2.2 or later), you might need to change the <TargetFramework> version in the project file (Example.csproj). You might also need to change the xcopy path in the build.bat or build.sh file.

Use Visual Studio to create new .NET project

You can create a new project with the Hyper API in Visual Studio.

      <ItemGroup>
        <Reference Include="Tableau.HyperAPI.NET">
            <HintPath>../lib/Tableau.HyperAPI.NET.dll</HintPath>
        </Reference>
      </ItemGroup>