Was this page helpful?
Yes No
Have a comment? Please leave it here.Thanks for your feedback!

Home > 

Troubleshooting with the Tableau SDK

This topic provides suggestions for troubleshooting issues when you're using the Tableau SDK to create or publish extracts.

Things to check for

The following sections list issues that are often the source of problems when using the Tableau SDK.

"Unsatisfied link" error when using Java to create an extract

If you are running on Windows and you have not installed Visual Studio, you see an error that starts with the following:

java.lang.UnsatisfiedLinkError: Unable to load library 'Tableau.Extract': The specified module could not be found.

This probably means that the Visual C++ runtime library is not installed in your computer. This library is required even if you are not using C or C++, and even if you are not using Visual Studio.

If you see this error, download and install the library from the following page on the Microsoft site:

Visual C++ Redistributable Packages for Visual Studio 2013

Missing package libpcre16.so.0: cannot open shared object file

If you are running on Linux, the libpcre16.so.0 package is a required to run the Tableau SDK. You might see an error message similar to the following if you do not have it installed.

OSError: libpcre16.so.0: cannot open shared object file: No such file or directory

The error is common on newer versions of Ubuntu. To fix this problem, run the following commands:

sudo apt-get install libpcre16-3

sudo ln -s /usr/lib/x86_64-linux-gnu/libpcre16.so.3 /usr/lib/x86_64-linux-gnu/libpcre16.so.0

This installs the latest package, libpcre16-3, and creates a symbolic link to the installed libpcre16.so.3 for the missing libpcre16.so.0 package.

Creating or updating an extract

If you're trying to create or update an extract and the process is not succeeding, check the following:

Publishing

If you're trying to publish an extract to Tableau Server and the process is not succeeding, check the following:

Examining logs

The classes in the Tableau SDK write information to log files. You can examine the log files to see the operations that the classes have performed, such as writing an extract file or connecting to Tableau Server. Because the classes write error information to the log files, you can also examine the log files to help determine if there's an issue when code is not performing as intended.

The Tableau SDK writes information to the following log files:

By default, these log files are written to the current working directory. You can specify the target location for the log files by setting the TAB_SDK_LOGDIR environment variable.