Método Discover (XMLA)

Artigo
08/01/2012

Recupera informações, como a lista de banco de dados disponíveis ou detalhes de um objeto específico, de uma instância do Microsoft SQL Server Analysis Services. Os dados recuperados com o método Discover dependem dos valores dos parâmetros configurados.

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

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

Sintaxe

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

Características do elemento

Característica	Descrição
Comprimento e tipo de dados	Nenhum
Valor padrão	Nenhum
Cardinalidade	0-1: elemento opcional que pode ocorrer apenas uma única vez.

Relações do elemento

Relação	Elemento
Elemento pai	Nenhum
Elementos filho	Properties, RequestType, Restrictions

Comentários

O método Discover solicita metadados sobre instâncias e objetos do Analysis Services. Os metadados são retomados com o tipo de dados Rowset XMLA.

Exemplo

No exemplo de código a seguir, o cliente envia a chamada Discover para solicitar uma lista de cubos do banco de dados do Adventure Works DW Multidimensional 2012 de exemplo da Analysis Services:

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