Élément row (XMLA)
Contient une ligne unique de données pour un élément root contenant les données sous forme de tableau retournées par un appel de méthode Discover ou Execute.
Syntaxe
<root xmlns="urn:schemas-microsoft-com:xml-analysis:rowset">
<row>
<!-- One or more column elements -->
</row>
</root>
Element Characteristics
Caractéristique |
Description |
---|---|
Type de données et longueur |
Aucun |
Valeur par défaut |
None |
Cardinality |
0-n : élément facultatif susceptible d'apparaître plusieurs fois. |
Relations entre les éléments
Relation |
Élément |
---|---|
Éléments parents |
|
Éléments enfants |
Un ou plusieurs éléments de colonne. |
Notes
Chaque ligne retournée par un élément root contenant des données sous forme de tableau a un élément row correspondant. Chaque colonne dans l'élément root est représentée par un élément XML distinct. La valeur de la colonne pour l'élément row correspond aux données figurant dans l'élément XML, et le nom de la colonne correspond au nom de l'élément XML.
Il existe deux moyens d'exprimer une valeur NULL pour une colonne au sein d'une ligne :
Un élément de colonne manquant implique que la colonne est NULL.
L'élément de colonne peut utiliser l'attribut xsi:nil='true' pour indiquer qu'il possède une valeur NULL.
Par exemple, si une ligne comporte une seule colonne appelée Store_Name, dont la valeur est NULL, elle peut être représentée des deux façons suivantes :
<row>
</row>
- ou -
<row>
<Store_name xsi:nil='true'/>
</row>
Si un élément de colonne contient une erreur, un élément Error fournit des informations à propos de cette erreur, comme le décrit l'exemple suivant :
<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>
Pour obtenir plus d'informations sur l'affectation de noms aux colonnes et des informations de schéma pour les données sous forme de tableau, consultez Type de données Rowset (XMLA).