Subscribe Element (XMLA)

Subscribes to a trace and returns a rowset that contains the trace events from a Microsoft SQL Server Analysis Services instance.

Syntax

<Command>
   <Subscribe>
      <Object>...</Object>
   </Subscribe>
</Command>

Element Characteristics

Characteristic

Description

Data type and length

None

Default value

None

Cardinality

0-n: Optional element that can occur more than once.

Element Relationships

Relationship

Element

Parent elements

Command

Child elements

Object

Remarks

The Subscribe command subscribes to and streams back a rowset from a specified trace on an Analysis Services instance. If an object other than a trace is specified in the Object element, an error occurs.

If the Object element is not specified, a session trace is defined and subscribed to on the Analysis Services instance. The session trace returns a fixed set of trace events from the current session.

The rowset stream returned by this command is terminated if the client application closes the connection to the Analysis Services instance, or if the session on which the Subscribe command is executed is terminated.

See Also

Concepts