• Article

DMX Query Editor (Analysis Services - Data Mining)

Use the DMX Query Editor to design and execute statements written in the Data Mining Extensions (DMX) language.

Features

  • Type scripts in the query editor pane of DMX Query Editor.

  • To execute scripts press F5, or click Execute on the toolbar or on the Query menu. If a portion of the code is selected, only that portion is executed. If no code is selected, the entire content of the DMX Query Editor is executed.

  • View metadata for cubes and other objects contained in an Analysis Services database in the metadata pane

  • For help with DMX syntax, select a keyword in DMX Query Editor, and then click F1.

  • For dynamic help with DMX syntax, on the Help menu, click Dynamic Help to open the Dynamic Help component. With Dynamic Help, help topics appear in the Dynamic Help window when keywords are typed in Query Editor.

SQL Server Analysis Services Editors Toolbar

When DMX Query Editor is open, the SQL Server Analysis Services Editors toolbar appears with the buttons listed in the following table.

Term

Definition

Connect

Opens the Connect to Server dialog box, to establish a connection to an Analysis Services instance.

Disconnect

Disconnects the DMX Query Editor from an Analysis Services instance.

Change Connection

Opens the Connect to Server dialog box, to establish a connection to a different Analysis Services instance.

New Query with Current Connection

Opens a new DMX Query Editor window, using the connection information from the current DMX Query Editor window.

Available Databases

Changes the connection to a different Analysis Services database on the same instance.

Execute

Executes the selected code, or if no code is selected, this option executes the entire code in the DMX Query Editor.

Parse

Checks the syntax of the selected code. If no code is selected, this option checks the syntax of the entire DMX Query Editor window.

Cancel Executing Query

Sends a cancellation request to the server. Some queries cannot be canceled immediately, but must wait for a suitable cancellation condition. When canceled, delays may occur while transactions are rolled back.

DMX Query Editor Window

The options listed in the following table are available in DMX Query Editor.

Term

Definition

Query editor window

Type DMX statements and scripts to be executed by the DMX Query Editor.

For more information about the query editor pane, see Editing Scripts and Files in SQL Server Management Studio.

The context menu for the query editor provides the following options:

TermDefinition
CutCopies the current selection to the clipboard and removes the selection from the query editor window.
CopyCopies the current selection to the clipboard.
PastePastes the contents of the clipboard to the current selection.
ConnectOpens the Connect to Server dialog box, to establish a connection to an Analysis Services instance.
DisconnectDisconnects the current query editor from an Analysis Services instance.
Disconnect All QueriesDisconnects all open query editors.
Change ConnectionOpens the Connect to Server dialog box, to establish a connection to a different Analysis Services instance.
Open Server in Object ExplorerOpens the Analysis Services instance to which the current query editor is connected in Object Explorer.
ExecuteExecutes the selected code, or if no code is selected, executes the entire code in the current query editor.
Properties WindowDisplays the Properties window in SQL Server Management Studio for the current query window.
Query OptionsDisplays the Query Options dialog box.

Metadata window

Displays metadata for the currently connected Analysis Services database.

Cube

Select a cube in the currently connected Analysis Services database to display the metadata associated with the cube in the Metadata tab.

Metadata

Displays the metadata for the cube selected in Cube, including measure groups and measures, key performance indicators, dimensions, hierarchies, levels, members, and member properties.

To retrieve the fully qualified key of an object, either:

  • Drag the object from the Metadata tab to the query pane.

  • Right-click the object and select Copy, and then right-click the query pane and select Paste.

Functions

Displays the metadata for DMX functions available to the Analysis Services database, as retrieved from the DMSCHEMA_MINING_FUNCTIONS schema rowset.

To retrieve the syntax of a function, either:

  • Drag the object from the Functions tab to the query pane.

  • Right-click the function and select Copy, and then right-click the query pane and select Paste.

Results window

Displays the results of a DMX statement in a grid.

Messages window

Displays information about how a DMX statement executed. For example, this window displays any errors encountered during execution or the number of cells retrieved after execution.