DMX Query Editor (Analysis Services - Data Mining)

  • Article

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:

Term

Definition

Cut

Copies the current selection to the clipboard and removes the selection from the query editor window.

Copy

Copies the current selection to the clipboard.

Paste

Pastes the contents of the clipboard to the current selection.

Connect

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

Disconnect

Disconnects the current query editor from an Analysis Services instance.

Disconnect All Queries

Disconnects all open query editors.

Change Connection

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

Open Server in Object Explorer

Opens the Analysis Services instance to which the current query editor is connected in Object Explorer.

Execute

Executes the selected code, or if no code is selected, executes the entire code in the current query editor.

Properties Window

Displays the Properties window in SQL Server Management Studio for the current query window.

Query Options

Displays 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.

See Also

Reference

Analysis Services Designers and Dialog Boxes (Multidimensional Data)

Data Mining Extensions (DMX) Reference

MDX Query Editor (Analysis Services - Multidimensional Data)

XMLA Query Editor (Analysis Services - Multidimensional Data)

SQL Server Management Studio Keyboard Shortcuts

Color Coding in Query Editors

Concepts

Query and Text Editors (SQL Server Management Studio)

Customize Menus and Shortcut Keys