Create Processing Query Dialog Box (SSAS)

  • Article

Use the Create Processing Query dialog box in Business Intelligence Development Studio to create a processing query in the Notifications tab of the Storage Options dialog box. A processing query is query that returns a rowset containing the changes made to a table associated with an Analysis Services object since the last time the table was polled, in order to incrementally update the multidimensional OLAP (MOLAP) cache for the object. Analysis Services uses another query, referred to as a polling query, to poll a table associated with an object and determine whether the table has changed. Processing queries are not necessary when fully updating the MOLAP cache for the object.

Typically, the processing query is parameterized, and two parameters are currently supported:

  • The singleton value returned by the polling query during the previous scheduled polling.
  • The singleton value returned by the polling query during the current scheduled polling.

For example, the queries listed in the following table could be used to incrementally update the Customer dimension in the Adventure Works DW sample Analysis Services project.

Query type Query statement

Polling query

SELECT

MAX([CustomerKey]) AS LastCustomerKey

FROM

[dbo].[DimCustomer]

Processing query

SELECT

*

FROM

[dbo].[DimCustomer]

WHERE

(CustomerKey > COALESCE (@Param1, - 1))

AND (CustomerKey <= @Param2)

For more information about incremental updates for scheduled polling notifications, see Proactive Caching.

You can display the Create Processing Query dialog box by clicking ... on the Processing Query column of the grid for the Scheduled polling option on the Notifications tab of the Storage Options dialog box. For more information about the Notifications tab of the Storage Options dialog box, see Notifications (Storage Options Dialog Box) (SSAS).

The query entered must be a valid query command for the underlying provider. The query is prepared with the underlying provider for validation, and to identify the columns returned. The dialog box can present two views:

  • Visual Database Tools (VDT) Query Builder
    For all users, the VDT Query Builder view provides a set of user interface tools for visually constructing and testing a SQL query.
  • Generic Query Builder
    For advanced users, the Generic Query Builder view provides a simpler, more direct user interface for constructing and testing a SQL query.

Options

  • Data Source
    Specifies the data source for the query.
  • Query definition
    The query definition provides a toolbar and panes in which to define and test the query, depending on the selected view.

  • Toolbar
    Use the toolbar to manage datasets, select panes to display, and control various query functions.

    Value

  • Diagram pane
    Displays the objects referenced by the query as a diagram. The diagram shows the tables included in the query, and how they are joined. Select or clear the check box next to a column in a table to add or remove it from the query output.

    When you add tables to the query, the dialog box creates joins between tables based on the keys in the table. To add a join, drag a field from one table onto a field in another table. To manage a join, right-click the join.

    Right-click the Diagram pane to add or remove tables, select all the tables, and show or hide panes.

    Note

    The contents of the Diagram pane, Grid pane, and SQL pane are synchronized, so that changes in one pane are reflected in the other two panes.

    Important

    Changing query types is not supported by the dialog box.

  • Grid pane
    Displays the objects referenced by the query in a grid. You can use this pane to add and remove columns to the query and change the settings for each column.

    Note

    The contents of the Diagram pane, Grid pane, and SQL pane are synchronized, so that changes in one pane are reflected in the other two panes.

  • SQL pane
    Displays the query as a SQL statement. Type to change the SQL statement for the query.

    Note

    The contents of the Diagram pane, Grid pane, and SQL pane are synchronized, so that changes in one pane are reflected in the other two panes.

  • Result pane
    Displays the results of the query when you click Run on the Toolbar pane.

See Also

Reference

Analysis Services Designers and Dialog Boxes (SSAS)

Help and Information

Getting SQL Server 2005 Assistance