How to: Retrieve Data from a Data Mining Model (DMX)

To use data from a SQL Server Analysis Services data mining model in your report, you must define a SQL Server Analysis Services data source and one or more report datasets. When you create the data source definition, you must specify a connection string and credentials so that you can access the data source from your client computer.

You can create an embedded data source definition for use by a single report or a shared data source definition that can be used by multiple reports. The procedures in this topic describe how to create an embedded data source. For more information about shared data sources, see Shared Data Sources and Embedded Data Sources and Creating, Modifying, and Deleting Shared Data Sources.

After you create a SQL Server Analysis Services data source, you can create one or more datasets. For each dataset, you use a Data Mining Prediction Expression (DMX) query designer to create a DMX query that specifies the field collection. For more information, see Analysis Services DMX Query Designer User Interface.

After you create a dataset, the name of the dataset appears in the Report Data pane as a node under its data source. For more information, see Working with Report Designer in Business Intelligence Development Studio.

After you publish your report, you may need to change the credentials for the data source so that when the report runs on the report server, the permissions to retrieve the data are valid.

To create an embedded Microsoft SQL Server Analysis Services data source

  1. On the toolbar in the Report Data pane, click New, and then click Data Source.

  2. In the Data Source Properties dialog box, type a name in the Name text box, or accept the default name.

  3. Verify that Embedded connection is selected.

  4. From the Type drop-down list, select Microsoft SQL Server Analysis Services.

  5. Specify a connection string that works with your Analysis Services data source.

    Contact your database administrator for connection information and for the credentials to use to connect to the data source. The following connection string example specifies the sample AdventureWorksDW database on the local client.

    Data Source=localhost;Initial Catalog=AdventureWorksDW
    
  6. Click Credentials.

    Set the credentials to use to connect to the data source. For more information, see Specifying Credential and Connection Information for Report Data Sources.

    Note

    To test the data source connection, click Edit. In the Connection Properties dialog box, click Test Connection. If the test is successful, you will see the information message "Test connection succeeded." If the test fails, you will see a warning message with more information about why the test was not successful.

  7. Click OK.

    The data source appears in the Report Data pane.

To create a dataset for a Microsoft SQL Server Analysis Services

  1. On In the Report Data pane, right-click the name of the data source that connects to a SQL Server Analysis Services data source, and then click Add Dataset.

  2. In the Dataset Properties dialog box, type a name in the Name text box,

  3. In the Data source box, verify that the name is the name of a data source that connects to an Analysis Services data source.

  4. In the Query type box, verify that Text is selected. Click Query Designer to open the graphical query designer to build a query interactively. If the query designer opens in MDX mode, click Command Type DMX on the toolbar to switch to the data mining query designer. For more information, see Analysis Services DMX Query Designer User Interface.

    Alternatively, you can paste a query from the clipboard directly into the Query pane, or import an existing DMX query from another report. To import an existing query, click Import, and then navigate to the .rdl file with the DMX query. Importing a query from an .dmx file is not supported.

  5. After you create and run your query to see sample results, click OK.

  6. Click OK.

    The dataset and its field collection appear in the Report Data pane under the data source node.