Creating a data connection to access data from a database
You can connect to and access data from external data sources, such as databases, data warehouses, and data lakes. On this page, you learn how to connect to your data source with a data connection.
Checking that a data source is supported
First check the list of supported data sources to see that your data source is supported. Also visit the system requirements for details about supported versions.
Installing the required drivers
To access data from many external data sources, a driver is required. If you use a Spotfire installed client, you must install the required driver on your computer.
- Go to Drivers and data sources in Spotfire® and browse to find the data source type that you want to connect to.
- Find the driver for your data source and install it on your computer.
- Restart Spotfire.
- Properties in connection data sources
When you create or edit a data connection, you can set and change properties in the connection data source. Data source properties are settings that provide information about the external data source and decide how Spotfire should communicate with it. - Data types in data connections
When you use a data connection to access data from an external data source, Spotfire maps the data types of columns in the data source to Spotfire data types. This means that a column can have a different data type in Spotfire, compared to the original data type of the column in the external system. - Setting the allowed load method for a table in a data connection
In a data connection, you can control what load methods are allowed for each selected data table (view). Either, you can determine that data must be imported into the Spotfire data engine, or that data must be kept external, to be used in-database only. - Using DSNs to create data connections to Apache Drill and Dremio
Some data connectors require a DSN on your computer to create or edit a connection. From the DSN, Spotfire imports the connection string information about how to connect to the data source. - Credentials profiles for connectors
Sometimes you do not want users to have to sign in manually to a database when they open an analysis with a data connection. In web clients, Automation Services, and Scheduled Updates, you can use a credentials profile to log in automatically. - Single sign-on with an identity provider (OAuth2) for connectors
Some data connectors support using your own identity provider, such as Okta, Keycloak, or Google, for authentication.
Creating a data connection
About this task
You can think of accessing data from an external data source as a 3-step process: First you connect to your data source. Then you select the data that you want to access. And finally you decide how you want to load that data in your analysis.
Connecting to your data source
To create a new connection to your data source, select Connect to in the Files and data flyout.
- Open the
Files and data
flyout, and click
Connect to.
- In the list, find and select your data source.
- In the panel on the right, click New connection.
- In the connection form,
enter the information for connecting to your data source.
Note: This step is different depending on the data source type. Usually you must enter a server address, select an authentication method, and log in with your user credentials. Depending on your data source type, there can be many more options. See the documentation for the corresponding data connector for details.
- To connect to your data source and proceed to selecting your data, click OK or Connect.
- Learn more
- To learn more about how to configure a connection to a data source, see the following pages:
Selecting data from your data source
About this task
When you have connected to your data source, the next step is to select the data that you want to use in Spotfire.

- In the panel on the left, browse the database tables available in your data source.
- Click to select the database tables you want to use, and make available as data tables to analyze in Spotfire.
- For each table, you can decide which columns you want to include.
- When you are happy with your data selection, click Continue or OK. In the next and final step, you can choose how you want Spotfire to retrieve the data in your analysis.
- Learn more
- There are many options for creating a specific or flexible selection of data in your data connection. To learn more, see Selecting data for your connection.
Selecting how to load the data
When you have selected your data, the final step is to select how Spotfire should retrieve that data, and how to add it to the analysis. In the Add data to analysis summary, you can see all the data tables you selected.
- To see all the options for a data table, click the data table's card. In the expanded card, you can change the load method, and select if the table should be added as a new data table or as rows to a table you already have in your analysis.
- Click OK to finish and add the data to your analysis.
- Learn more
- To learn more about different ways to load your data, see the following pages: