MDSCHEMA_DIMENSIONS Rowset

The DIMENSIONS rowset contains information about the dimensions in a given cube. Each dimension has one row.

GUID: MDSCHEMA_DIMENSIONS

Table 34 describes the rowset structure.

Table 34. MDSCHEMA_DIMENSIONS Rowset structure

Column NameEssbase Mapping
CATALOG_NAMEApplication name
CUBE_NAMEDatabase name
DIMENSION_NAMEDimension name
DIMENSION_UNIQUE_NAMEDimension name
DIMENSION_CAPTIONDimension name
DIMENSION_ORDINALDimension number. First dimension is 1, second is 2, and so on
DIMENSION_TYPE

If Essbase dimension type is:

  • TIME: MD_DIMTYPE_TIME

  • ACCOUNTS: MD_DIMTYPE_MEASURE

  • ALL OTHER: MD_DIMTYPE_OTHER

DIMENSION_CARDINALITYNumber of members in the dimension
DEFAULT_HIERARCHYDimension name
DESCRIPTIONComment added for the dimension
DIMENSION_UNIQUE_SETTINGS2
DIMENSION_IS_VISIBLETrue always

Request Example

<SOAP-ENV:Envelope
 xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
 xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
 xmlns:xsd="http://www.w3.org/2001/XMLSchema">
 <SOAP-ENV:Body>
  <Discover xmlns="urn:schemas-microsoft-com:xml-analysis"
   SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
    <RequestType>MDSCHEMA_DIMENSIONS</RequestType>
    <Restrictions>
     <RestrictionList>
      <CATALOG_NAME>Sample</CATALOG_NAME>
      <CUBE_NAME>Basic</CUBE_NAME>
     </RestrictionList>
    </Restrictions>
    <Properties>
     <PropertyList>
      <DataSourceInfo>Provider=Essbase;Data Source=localhost
      </DataSourceInfo>
      <Format>Tabular</Format>
     </PropertyList>
    </Properties>
  </Discover>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Response Example(truncated)

<?xml version="1.0"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
 SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
 <SOAP-ENV:Body>
  <m:DiscoverResponse xmlns:m="urn:schemas-microsoft-com:xml-analysis">
   <m:return xsi:type="xsd:string" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <root xmlns="urn:schemas-microsoft-com:xml-analysis:rowset"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
     <xsd:schema xmlns="urn:schemas-microsoft-com:xml-analysis:rowset"
      targetNamespace="urn:schemas-microsoft-com:xml-analysis:rowset" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xmlns:xsd="http://www.w3.org/2001/XMLSchema"
      xmlns:sql="urn:schemas-microsoft-com:xml-sql"
      elementFormDefault="qualified">
      <xsd:element name="root">
       <xsd:complexType>
        <xsd:sequence minOccurs="0" maxOccurs="unbounded">
         <xsd:element name="row" type="row"/>
        </xsd:sequence>
       </xsd:complexType>
      </xsd:element>
      <xsd:complexType name="row">
      <xsd:sequence maxOccurs="unbounded" minOccurs="0">
       <xsd:element name="CATALOG_NAME" type="xsd:string" 
        sql:field="CATALOG_NAME"/>
       <xsd:element name="CUBE_NAME" type="xsd:string" 
        sql:field="CUBE_NAME"/>
       <xsd:element name="DIMENSION_NAME" type="xsd:string" 
        sql:field="DIMENSION_NAME"/>
       <xsd:element name="DIMENSION_UNIQUE_NAME" type="xsd:string" 
        sql:field="DIMENSION_UNIQUE_NAME"/>
       <xsd:element name="DIMENSION_CAPTION" type="xsd:string" 
        sql:field="DIMENSION_CAPTION"/>
       <xsd:element name="DIMENSION_ORDINAL" type="xsd:unsignedInt" 
        sql:field="DIMENSION_ORDINAL"/>
       <xsd:element name="DIMENSION_TYPE" type="xsd:short" 
        sql:field="DIMENSION_TYPE"/>
       <xsd:element name="DIMENSION_CARDINALITY" type="xsd:unsignedInt" 
        sql:field="DIMENSION_CARDINALITY"/>
       <xsd:element name="DEFAULT_HIERARCHY" type="xsd:string" 
        sql:field="DEFAULT_HIERARCHY"/>
       <xsd:element name="DESCRIPTION" type="xsd:string" 
        sql:field="DESCRIPTION" minOccurs="0"/>
       <xsd:element name="DIMENSION_UNIQUE_SETTINGS" type="xsd:int" 
        sql:field="DIMENSION_UNIQUE_SETTINGS"/>
       <xsd:element name="DIMENSION_IS_VISIBLE" type="xsd:boolean" 
        sql:field="DIMENSION_IS_VISIBLE"/>
      </xsd:sequence>
     </xsd:complexType>
    </xsd:schema>
    <row>
     <CATALOG_NAME>Sample</CATALOG_NAME>
     <CUBE_NAME>Sample.Basic</CUBE_NAME>
     <DIMENSION_NAME>Year</DIMENSION_NAME>
     <DIMENSION_UNIQUE_NAME>[Year]</DIMENSION_UNIQUE_NAME>
     <DIMENSION_CAPTION>Year</DIMENSION_CAPTION> 
     <DIMENSION_ORDINAL>1</DIMENSION_ORDINAL>
     <DIMENSION_TYPE>1</DIMENSION_TYPE>
     <DIMENSION_CARDINALITY>19</DIMENSION_CARDINALITY>
     <DEFAULT_HIERARCHY>[Year]</DEFAULT_HIERARCHY>
     <DIMENSION_UNIQUE_SETTINGS>2</DIMENSION_UNIQUE_SETTINGS>
     <DIMENSION_IS_VISIBLE>true</DIMENSION_IS_VISIBLE>
    </row>
    < ................More Rows............. >
   </root>
  </m:return>
 </m:DiscoverResponse>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>