Edit

Analysis Services Connection Manager

  • Article

Applies to: SQL Server SSIS Integration Runtime in Azure Data Factory

An SQL Server Analysis Services connection manager enables a package to connect to a server that runs an Analysis Services database or to an Analysis Services project that provides access to cube and dimension data. You can only connect to an Analysis Services project while developing packages in SQL Server Data Tools (SSDT). At run time, packages connect to the server and the database to which you deployed the Analysis Services project.

Both tasks, such as the Analysis Services Execute DDL task and the Analysis Services Processing task, and destinations, such as the Data Mining Model Training destination, use an Analysis Services connection manager.

For more information about Analysis Services databases, see Multidimensional Model Databases (SSAS).

Configuration of the Analysis Services Connection Manager

When you add an Analysis Services connection manager to a package, SQL Server Integration Services creates a connection manager that is resolved as an Analysis Services connection at run time, sets the connection manager properties, and adds the connection manager to the Connections collection on the package. The ConnectionManagerType property of the connection manager is set to MSOLAP100.

You can configure the Analysis Services connection manager in the following ways:

  • Provide a connection string configured to meet the requirements of the Microsoft OLE Provider for Analysis Services provider.

  • Specify the instance of Analysis Services or the Analysis Services project to connect to.

  • If you are connecting to an instance of Analysis Services, specify the authentication mode.

Note

If you use SSIS in Azure Data Factory (ADF) and want to connect to Azure Analysis Services (AAS) instance, you can not use an account with Multi-Factor Authentication (MFA) enabled, but must use an account that does not require any interactivity/MFA or a service principal instead. To use the latter, see here to create one and assign the server administrator role to it, then select Use a specific user name and password to log on to the server in your connection manager, and finally enter User name: app:YourApplicationID and Password: YourAuthorizationKey.

  • Indicate whether the connection that is created from the connection manager is retained at run time.

You can set properties through SSIS Designer or programmatically.

Add Analysis Services Connection Manager Dialog Box UI Reference

Use the Add Analysis Services Connection Manager dialog box to create a connection to a server running SQL Server Analysis Services, or to edit connection properties.

Options

Create a connection to a computer running Analysis Services
Use the default connection to a server that is running an instance of Analysis Services, or create a new connection by clicking Edit.

Edit
Use the Connection Manager dialog box to create a connection to a server that is running an instance of Analysis Services, and to edit connection properties.

Create a connection to an Analysis Services project in this solution
Specify that the connection will use an Analysis Services project in the open solution.

Note

Analysis Services tabular model projects are not supported for this scenario.

Analysis Services project
Select an Analysis Services project from the list.

Related content

For information about configuring a connection manager programmatically, see ConnectionManager and Adding Connections Programmatically.