Artigo
04/01/2012

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.

Sintaxe

<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
Tipo e comprimentos dos dados	Nenhum
Valor padrão	Nenhum
Cardinalidade	0-n: elemento opcional que pode ocorrer mais de uma vez.

Relações do 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>

Para obter mais informações sobre a nomeação de colunas e informações de esquema para dados tabulares, consulte Tipo de dados Rowset (XMLA).

Consulte também

Conceitos

Função Properties (XMLA)

Partilhar via