ExtractValue(xml_frag, xpath_expr)

Diese Funktion nimmt zwei String-Argumente – ein XML-Fragment xml_frag und einen XPath-Ausdruck xpath_expr (auch Lokator genannt) – entgegen und gibt den xpath_expr entsprechenden Wert zurück. Beachten Sie, dass ExtractValue() nur das CDATA zurückgibt, das direkt im xpath_expr entsprechenden Tag enthalten ist, nicht jedoch Tags, die innerhalb des entsprechenden Tags enthalten sind, oder deren Inhalte (siehe auch das als val1 im folgenden Beispiel zurückgegebene Ergebnis).

Wird keine Übereinstimmung für xpath_expr gefunden, dann gibt die Funktion einen Leer-String zurück. Werden mehrere Übereinstimmungen gefunden, dann werden die Inhalte aller entsprechenden Elemente (in der Reihenfolge der Übereinstimmung) in einem leerzeichengetrennten String zurückgegeben.

mysql> SELECT
    ->   ExtractValue('<a>ccc<b>ddd</b></a>', '/a') AS val1,
    ->   ExtractValue('<a>ccc<b>ddd</b></a>', '/a/b') AS val2,
    ->   ExtractValue('<a>ccc<b>ddd</b></a>', '//b') AS val3,
    ->   ExtractValue('<a>ccc<b>ddd</b></a>', '/b') AS val4,
    ->   ExtractValue('<a>ccc<b>ddd</b><b>eee</b></a>', '//b') AS val5;

+------+------+------+------+---------+
| val1 | val2 | val3 | val4 | val5    |
+------+------+------+------+---------+
| ccc  | ddd  | ddd  |      | ddd eee |
+------+------+------+------+---------+

UpdateXML(xml_target, xpath_expr, new_xml)

Diese Funktion ersetzt einen Teil eines gegebenen XML-Fragments xml_target durch ein neues XML-Fragment new_xml und gibt das geänderte XML dann zurück. Der Teil von xml_target, der ersetzt wird, entspricht einem XPath-Ausdruck xpath_expr, der vom Benutzer übergeben wurde. Wird kein Ausdruck entdeckt, der xpath_expr entspricht, dann gibt die Funktion das ursprüngliche XML-Fragment xml_target zurück. Alle drei Argumente müssen Strings sein.

mysql> SELECT
    ->   UpdateXML('<a><b>ccc</b><d></d></a>', '/a', '<e>fff</e>') AS val1,
    ->   UpdateXML('<a><b>ccc</b><d></d></a>', '/b', '<e>fff</e>') AS val2,
    ->   UpdateXML('<a><b>ccc</b><d></d></a>', '//b', '<e>fff</e>') AS val3,
    ->   UpdateXML('<a><b>ccc</b><d></d></a>', '/a/d', '<e>fff</e>') AS val4
    -> \G

*************************** 1. row ***************************
val1: <e>fff</e>
val2: <a><b>ccc</b><d></d></a>
val3: <a><e>fff</e><d></d></a>
val4: <a><b>ccc</b><e>fff</e></a>

/tag

Entspricht <tag/>, wenn (und nur wenn) <tag/> das Stammelement ist.

Beispiel: /a findet eine Übereinstimmung in <a><b/></a>, weil es dem äußersten Tag (Stamm-Tag) entspricht. Es entspricht nicht dem inneren a-Element in <b><a/></b>, weil es in dieser Instanz ein einem anderen Element untergeordnetes Element ist.

/tag1/tag2

Entspricht <tag2/>, wenn (und nur wenn) es ein untergeordnetes Element von <tag1/> und <tag1/> das Stammelement ist.

Beispiel: /a/b entspricht dem Element b im XML-Fragment <a><b/></a>, weil es ein untergeordnetes Element des Stammelements a ist. Keine Entsprechung liegt in <b><a/></b> vor, weil in diesem Fall b das Stammelement (und damit kein einem anderen Element untergeordnetes Element) ist. Ebenso wenig hat der XPath-Ausdruck eine Übereinstimmung in <a><c><b/></c></a>; hier stammt b zwar von a ab, ist aber im engen Sinne kein a untergeordnetes Element.

Dieses Konstrukt ist auf drei oder mehr Elemente erweiterbar. So entspricht beispielsweise der XPath-Ausdruck /a/b/c dem Element c im Fragment <a><b><c/></b></a>.

//tag

Entspricht jeder Instanz von tag.

Beispiel: //a entspricht dem Element a in allen folgenden Fragmenten: <a><b><c/></b></a>; <c><a><b/></a></b>; <c><b><a/></b></c>.

// kann mit / kombiniert werden. Beispielsweise entspricht //a/b dem Element b in den Fragmenten <a><b/></a> und <a><b><c/></b></a>.

Der Operator * agiert als Jokerzeichen, welches jedem Element entspricht. So entspricht beispielsweise der Ausdruck /*/b dem Element b in den XML-Fragmenten <a><b/></a> und <c><b/></c>. Allerdings erzeugt der Ausdruck keine Übereinstimmung im Fragment <b><a/></b>, weil b ein einem anderen Element untergeordnetes Element sein muss. Das Jokerzeichen kann an beliebiger Position verwendet werden: Der Ausdruck /*/b/* entspricht jedem untergeordneten Element eines Elements b, welches selbst nicht das Stammelement ist.

Mehrere Lokatoren können mit dem Operator | (logisches OR) verglichen werden. So entspricht etwa der Ausdruck //b|//c allen b- und c-Elementen im XML-Ziel.

Es ist auch möglich, ein Element basierend auf dem Wert eines oder mehrerer seiner Attribute zu vergleichen. Dies erfolgt mit der Syntax tag[@attribute="value"]. So entspricht beispielsweise der Ausdruck //b[@id="idB"] dem zweiten Element b im Fragment <a><b id="idA"/><c/><b id="idB"/></a>. Um einen Vergleich mit einem beliebigen Element mit attribute="value" durchzuführen, benutzen Sie den XPath-Ausdruck //*[attribute="value"].

Um mehrere Attributwerte zu filtern, benutzen Sie einfach mehrere aufeinander folgende Attributvergleichsklauseln. Der Ausdruck //b[@c="x"][@d="y"] beispielsweise entspricht dem Element <b c="x" d="y"/> an beliebiger Stelle in einem gegebenen XML-Fragment.

Um Elemente zu finden, für die dasselbe Attribut genau einem von mehreren Werten entspricht, müssen Sie mehrere Lokatoren benutzen, die mit dem Operator | verknüpft werden. Um also etwa eine Übereinstimmung für alle Elemente b zu erzielen, deren Attribute c entweder den Wert 17 oder den Wert 23 haben, verwenden Sie den Ausdruck //b[@c="23"]|b[@c="17"].

Nodeset-Nodeset-Vergleiche (wie etwa '/a/b[@c=@d]') werden nicht unterstützt. Nur Vergleiche der Form [@attribute="const"], wobei const ein konstanter Wert ist, sind zurzeit möglich. Beachten Sie, dass Gleichheit und Ungleichheit (= und !=) die einzigen unterstützten Vergleichsoperatoren sind.

Relative Lokatorausdrücke werden nicht unterstützt. XPath-Ausdrücke müssen mit / oder // beginnen.

Der Operator :: wird nicht unterstützt.

Die folgenden XPath-Funktionen werden nicht unterstützt:

Die folgenden Axes werden nicht unterstützt: