> ## Documentation Index
> Fetch the complete documentation index at: https://insightsoftware-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect to Data and View it on a Dashboard

<a id="connect-to-data-and-view-it-on-a-dashboard" />

**This applies to:**  *Managed Dashboards, Managed Reports*

This walkthrough shows you how to add a new connection to a data source and use it to display some data on a dashboard.

A SQL Server/Azure SQL database is used for example purposes, but you can follow these steps for any data source.

<a id="connecting-to-data" />

## Connecting to Data

If you are accessing data live from a database or online data source, you generally need to have some knowledge about the type of data source as well as the necessary permissions to connect.

You also need to be a user with at least power user access to create a data connector.

<a id="create-a-new-data-connector" />

### Create a New Data Connector

You can create a data connector a number of different ways:

* Click **Data** in the [main menu](/logi-symphony/symphony/v25/navigate/the_symphony_main_menu) on the left, switch to **Data Connector** , then click **Create**.

* You can also use the options provided when creating a [new metric set](/logi-symphony/symphony/v25/dashboards/select_and_group_data_for_a_metric_set).

* Or, right-click the *Data Connectors* folder in the [Explore window](/logi-symphony/symphony/v25/available_visual_types/design_overview) and choose **New Data Connector**.

The new data connector dialog appears, with various settings available that change depending on the type of data provider you want to use.

<Frame>
  <img src="https://mintcdn.com/insightsoftware-preview/0P-hTWrx6tFSM8Fk/images/38062525541005_03327a17a6.png?fit=max&auto=format&n=0P-hTWrx6tFSM8Fk&q=85&s=0139bc651a562b855b9b8fd5d1e6fca1" alt="New data connector dialog" title="New data connector dialog" width="600" height="1088" data-path="images/38062525541005_03327a17a6.png" />
</Frame>

<a id="choose-a-name-and-folder-location" />

### Choose a Name and Folder Location

Your new data connector will need a name - click inside the **Name** box to open a dialog where you can enter one.

You can optionally click to select a specific subfolder **Location** under the *Data Connectors* folder. To create a subfolder, right-click (or long-tap) an existing folder and choose **Create Folder**.

<Frame>
  <img src="https://mintcdn.com/insightsoftware-preview/0P-hTWrx6tFSM8Fk/images/38062514142477_b1eb948469.png?fit=max&auto=format&n=0P-hTWrx6tFSM8Fk&q=85&s=2559cb8a40aa5f3a7fa8ee5f7b18823f" alt="Save dialog" title="Save dialog" width="592" height="488" data-path="images/38062514142477_b1eb948469.png" />
</Frame>

<a id="select-a-data-provider" />

### Select a Data Provider

You can connect to a wide range of data source types. The **Data Provider** drop-down is set to *Microsoft SQL Server* by default, which is also used for connecting to Azure SQL and Azure Synapse.

<Frame>
  <img src="https://mintcdn.com/insightsoftware-preview/gqaUScsVYB_N4K2F/images/38062525639309_f243da5911.png?fit=max&auto=format&n=gqaUScsVYB_N4K2F&q=85&s=87e339e259d718a777c01149e418aadb" alt="Data provider choices" title="Data provider choices" width="565" height="672" data-path="images/38062525639309_f243da5911.png" />
</Frame>

The settings below may change after changing the data provider.

Your administrator may need to install drivers on the server for certain data providers.

<a id="settings" />

### Settings

You can hover over each data provider setting for a tooltip popup providing a description (or long-tap on touch devices).

<Frame>
  <img src="https://mintcdn.com/insightsoftware-preview/0P-hTWrx6tFSM8Fk/images/38062514224525_d302ee1719.png?fit=max&auto=format&n=0P-hTWrx6tFSM8Fk&q=85&s=13271eb204eb52adc78b51b57cd34d80" alt="Settings for SOL Server" title="Settings for SOL Server" width="576" height="779" data-path="images/38062514224525_d302ee1719.png" />
</Frame>

Some data providers offer more than one authentication method you can choose from, such as:

* Server Windows credentials

* Provider-specific options such as SQL Server authentication

* Specified Windows credentials

* Impersonated Windows credentials

* Active Directory credentials, for use with Azure

Fill in the requested credentials if required.

When connecting to any database, there may be settings similar to the following ones for Microsoft SQL Server:

* **Data Source** - The name of your database instance or database server (e.g., often this is just the server name), or its network/internet address.

* **Initial Catalog** - The database name.

There are typically other optional or advanced settings you can configure. Click through the expandable sections near the bottom to access additional settings.

<Note>
  **Note:** Enable **Allow Session Schemas** for supported connectors to use session schemas. See Session Schema.
</Note>

<Warning>
  **Important:** If you disable Trusted Access in a multi-tenancy environment, data retrieved through the Data Discovery connector you created is fetched using the tenant admin's credentials instead of each user's credentials. Effectively, all row level security settings are removed on the data retrieved.
</Warning>

<a id="test-the-connection" />

### Test the Connection

You can click **Test connection** as a quick way of verifying the settings you just entered. A message will appear in the bottom-right corner of your browser window indicating whether the connection was successful.

<Frame>
  <img src="https://mintcdn.com/insightsoftware-preview/0P-hTWrx6tFSM8Fk/images/38062511343885_bf2838846a.png?fit=max&auto=format&n=0P-hTWrx6tFSM8Fk&q=85&s=8401ac1567c6c3e639a695cf1fffc537" alt="Test connection" title="Test connection" width="560" height="249" data-path="images/38062511343885_bf2838846a.png" />
</Frame>

<a id="save" />

### Save

At the bottom of the dialog, the **Check In** option is checked by default to [share the data connector with other users](/logi-symphony/symphony/v25/dashboards/check_in,_check_out_and_auto_saving) with access to the current project as soon as it's created.

<Frame>
  <img src="https://mintcdn.com/insightsoftware-preview/gqaUScsVYB_N4K2F/images/38062539471245_b42a55faac.png?fit=max&auto=format&n=gqaUScsVYB_N4K2F&q=85&s=8f4020fdaba1d0fe29e91cac14c4c38a" alt="Submit button" title="Submit button" width="550" height="336" data-path="images/38062539471245_b42a55faac.png" />
</Frame>

Finally, click to **Save** at the bottom. A message will tell you the data connector was created and that a discovery operation was started - this process automatically finds and lists all the tables, stored procedures, and other available data 'structures' for you to work with, and it runs in the background so you don't need to wait for it.

<Frame>
  <img src="https://mintcdn.com/insightsoftware-preview/PTUnBWJog2AqeVpO/images/38062554646925_f6e0c40f9c.png?fit=max&auto=format&n=PTUnBWJog2AqeVpO&q=85&s=7a27338d8a41785d684757befec8ee41" alt="Discovery notification in bottom-right corner" title="Discovery notification in bottom-right corner" width="576" height="239" data-path="images/38062554646925_f6e0c40f9c.png" />
</Frame>

<Note>
  **Note:** Stored Procedures that don't output a value are not supported.
</Note>

If you want to make changes to the data connector, you can re-open it from the main menu.

<a id="viewing-data" />

## Viewing Data

Now that you have a data connector providing access to a data source, you can display some data using a metric set or dashboard, for example. The quick walkthrough below shows a dashboard.

<a id="create-a-new-dashboard" />

### Create a New Dashboard

Click on **Views** in the [main menu](/logi-symphony/symphony/v25/navigate/the_symphony_main_menu) and create a new dashboard. Choose *Blank* to drag and drop content anywhere on the dashboard, or you can choose another template.

The [dashboard editor](/logi-symphony/symphony/v25/available_visual_types/design_overview) is displayed, with most of the screen taken up by a *canvas* where you can drag and drop items to compose your dashboard.

<Frame>
  <img src="https://mintcdn.com/insightsoftware-preview/0P-hTWrx6tFSM8Fk/images/38062514422797_97a1d35c4f.png?fit=max&auto=format&n=0P-hTWrx6tFSM8Fk&q=85&s=8ffbcd2ff1f3be323ffc2c85b0509ddc" alt="Dashboard Designer screen" title="Dashboard Designer screen" width="1200" height="913" data-path="images/38062514422797_97a1d35c4f.png" />
</Frame>

<a id="find-your-data-connector" />

### Find Your Data Connector

Click on the *Explore* window, usually docked on the right, to expand it if it isn't already. It lists all the items within the current project.

Expand the *Data Connectors* folder to see your data connector, then further expand the data connector itself to see the data structures discovered, including database tables and programmatic structures such as stored procedures and functions.

<Frame>
  <img src="https://mintcdn.com/insightsoftware-preview/gqaUScsVYB_N4K2F/images/38062525866765_6ab2ac7d05.png?fit=max&auto=format&n=gqaUScsVYB_N4K2F&q=85&s=918588c4e31e7a2fec60aad9de3861cf" alt="A data connector's data structures" title="A data connector's data structures" width="448" height="719" data-path="images/38062525866765_6ab2ac7d05.png" />
</Frame>

<Note>
  **Note:** If the structures or their columns have changed since they were last discovered, you can right-click/long-tap the data connector or one of its sub-folders and choose Re­ Discover.
</Note>

<a id="drag-a-table-of-data-to-the-canvas" />

### Drag a Table of Data To the Canvas

Under your data connector, scroll down and locate a specific table or sheet of data you want to see. Expand the table and drag individual columns you are interested in, or drag the entire table to preview all of its [raw data](/logi-symphony/symphony/v25/dashboards/select_and_group_data_for_a_metric_set).

<Frame>
  <img src="https://mintcdn.com/insightsoftware-preview/gqaUScsVYB_N4K2F/images/38062539620877_b9679440ed.png?fit=max&auto=format&n=gqaUScsVYB_N4K2F&q=85&s=33890684e0d1df7c9590250bf2b1d509" alt="Drag database table to canvas" title="Drag database table to canvas" width="992" height="432" data-path="images/38062539620877_b9679440ed.png" />
</Frame>

Data sources are connected to live/real-time by default (other than files such as Excel spreadsheets that were uploaded).

Dragging data automatically creates a [metric set](/logi-symphony/symphony/v25/dashboards/symphony_metric_sets) you can use to analyze it. Initially it's visualized as a table, but you can Re-Visualize from the toolbar. Otherwise, a recommended visualization will be chosen for you automatically as you drag or add more data.

<a id="view-the-dashboard" />

### View the Dashboard

Click **View** in the toolbar to switch to *View mode*. This lets you interact with your dashboard, such as using the scrollbars on the table visualization. Click **Edit** in the toolbar to go back to **Edit mode**.

<Frame>
  <img src="https://mintcdn.com/insightsoftware-preview/Jh8ZEiEPZ5D3LGlz/images/38062494686221_bcac78871a.png?fit=max&auto=format&n=Jh8ZEiEPZ5D3LGlz&q=85&s=ed43c9d5d4b96cf0ef3d8440051d2fcf" alt="Database table in view mode" title="Database table in view mode" width="800" height="570" data-path="images/38062494686221_bcac78871a.png" />
</Frame>

For more information, see:

* Authentication Methods

* Connect to OLAP Data and Apply a Formula

* Setting Up Data Input

* Other Metric Set Tools

* Automatic Joins and Hierarchies

* Working With Projects

* [Check In, Check Out and Auto Saving](/logi-symphony/symphony/v25/dashboards/check_in,_check_out_and_auto_saving)
