XML Elements - Methods - Discover

Article
12/09/2022

Retrieves information, such as the list of available databases or details about a specific object, from an instance of Analysis Services. The data retrieved with the Discover method depends on the values of the parameters passed to it.

Namespace urn:schemas-microsoft-com:xml-analysis

SOAP Action "urn:schemas-microsoft-com:xml-analysis:Discover"

Syntax

XML

  
<Discover>  
   <RequestType>...</RequestType>  
   <Restrictions>...</Restrictions>  
   <Properties>...</Properties>  
</Discover>

Element characteristics

Characteristic	Description
Data type and length	None
Default value	None
Cardinality	0-1: Optional element that can occur once and only once.

Element relationships

Relationship	Element
Parent element	None
Child elements	Properties, RequestType, Restrictions

Remarks

The Discover method requests metadata about instances and objects. Metadata is returned using the XMLA Rowset data type.

Tip

If you are unfamiliar with XML commands, click the XMLA query template on the Query toolbar in Management Studio, to build the query and add parameters.

Example

In the following code sample, the client sends the Discover call to request a list of cubes from the Adventure Works DW Multidimensional 2012 sample Analysis Services database:

XML

<Discover xmlns="urn:schemas-microsoft-com:xml-analysis">  
   <RequestType>MDSCHEMA_CUBES</RequestType>  
   <Restrictions>  
      <RestrictionList>  
         <CATALOG_NAME>Adventure Works DW Multidimensional 2012</CATALOG_NAME>  
      </RestrictionList>  
   </Restrictions>  
   <Properties>  
      <PropertyList>  
         <DataSourceInfo>Provider=MSOLAP;Data Source=local;</DataSourceInfo>  
         <Catalog>Adventure Works DW Multidimensional 2012</Catalog>  
         <Format>Tabular</Format>  
      </PropertyList>  
   </Properties>  
</Discover>

Share via