Premium Feature — Available in the Professional Plus and Enterprise Editions. Learn more or contact LabKey.

LabKey's JDBC driver allows Spotfire to query the server and use the results to build visualizations.

Set Up

To configure Spotfire to use the LabKey JDBC driver, do the following:

  • In Spotfire Server, copy the LabKey JDBC driver jar to the directory
  • Launch the Spotfire Server Configuration Tool.
  • Click the Configuration tab.
  • On the lefthand pane click DataSource Templates.
  • Add a new LabKey data source using the following template:

For more details, see the Spotfire documentation:

Applying Folder Filters

To control what folders and subfolders of data will be queried, limiting (or expanding) the scope of data included in spotfire visualizations, apply a container filter. Include a <connection-property> key-value pair in your XML configuration similar to this:


Possible values for the containerFilter parameter are:

  • Current (Default)
  • CurrentAndSubfolders
  • CurrentPlusProject
  • CurrentAndParents
  • CurrentPlusProjectAndShared
  • AllFolders
Learn more about using folder filters in this topic: filterbyfolder.

Using LabKey Data

  • In the Spotfire Information Designer add a data source of type 'labkey'. (Once you have successfully added the driver above, 'labkey' will be available in the Type dropdown.
  • You must also provide a Connection URL, Username, and Password. See an example screen shot below.
  • Now you will be able to see the LabKey Server folder heirarchy and exposed schemas.


In Spotfire Server, add the following to Spotfire’s tomcat/conf/

org.labkey.jdbc.level = FINE

In Spotfire’s tomcat’s default logging config, this will result in logging into the stderr log file appender.

Note that unimplemented JDBC methods get logged as SEVERE (java.util.logging) / ERROR (log4j/slf4j).

Logging options:

  • org.labkey.jdbc.level = FINE (Provides java.util.logging levels)
  • org.labkey.jdbc.level = DEBUG (Provides log4j or slf4j logging levels)

Related Topics

Premium Resource Available

Subscribers to premium editions of LabKey Server can learn more with the example code in this topic:

Learn more about premium editions


Was this content helpful?

Log in or register an account to provide feedback

expand all collapse all