Compartilhar via


Elemento row (XMLA)

Contém uma única linha de dados para um elemento root que contém dados tabulares retornados por uma chamada do método Discover ou Execute .

Syntax

  
<root xmlns="urn:schemas-microsoft-com:xml-analysis:rowset">  
   <row>  
      <!-- One or more column elements -->  
   </row>  
</root>  

Características do elemento

Característica Descrição
Comprimento e tipo de dados Nenhum
Valor padrão Nenhum
Cardinalidade 0-n: Elemento opcional que pode ocorrer mais de uma vez.

Relações de elemento

Relação Elemento
Elementos pai root (usando o tipo de dados Rowset )
Elementos filho Um ou mais elementos de coluna.

Comentários

Cada linha retornada por um elemento root que contém dados tabulares tem um elemento row correspondente. Cada coluna no elemento root é representada por um elemento XML separado. O valor da coluna para o elemento row equivale aos dados contidos pelo elemento XML e o nome da coluna corresponde ao nome do elemento XML.

Há dois modos para expressar um valor nulo para uma coluna em uma linha:

  • Um elemento de coluna ausente indica que a coluna é nula.

  • O elemento de coluna pode usar o atributo xsi:nil='true' para indicar que tem um valor nulo.

Por exemplo, se uma linha tiver uma única coluna chamada Store_Name e seu valor for NULL, ela poderá ser representada como:

<row>  
</row>  

Ou:

<row>  
   <Store_name xsi:nil='true'/>  
</row>  

Se um elemento de coluna contiver um erro, um elemento Error fornecerá informações sobre o erro, conforme descrito no exemplo a seguir:

<row>   <Store_name>  
      <Error xmlns="urn:schemas-microsoft-com:xml-analysis:exception">  
         <ErrorCode>3238658054</ErrorCode>  
         <Description>The object [X] was not found in the cube when [X] was parsed.</Description>  
      </Error>  
   </Store_name>  
</row>