Aria

Apache Derby – tutorial

Apache Derby: operator XMLQUERY

Opis

Pobiera dane z kolumn typu XML

Składnia

XMLQUERY (string PASSING BY REF value [RETURNING SEQUENCE [BY REF]] EMPTY ON EMPTY)

Objaśnienia

‘string’ musi być ‘stringiem’, który jest jednocześnie prawidłowym wyrażeniem XPath obsługiwanym przez Apache
Xalan. Więcej informacji o XPath można znaleźć, według dokumentacji Derby, na tej stronie.

‘string’ nie może być parametrem ani wyrażeniem, które nie jest literałem, albo literałem, który jest np. typu
int . Derby nie obługuje XQuery, ponieważ używa Xalan-u, który nie obsługuje tego standardu.

‘value’ musi być typu XML i musi być prawidłowym dokumentem SQL/XML. Nie może być parametrem. Ponieważ Derby nie
wykonuje domyślnego parsowania ani rzutowania XML, dlatego nie można używać ‘stringów’ ani innych typów danych.
Może być wynikiem zwracanym przez XMLQUERY, pod warunkiem, że jest to sekwencja złożna tylko z jednego węzła,
który jest węzłem dokumentu.

BY REF jest jedynym sposobem zwracania wartości i jest wartością domyślną, więc może być pominięty.

RETURNING SEQUENCE może być pominięte, gdyż dotyczy jedynej możliwej zwracanej wartości (XML), która jest
jednocześnie wartością domyślną.

EMPTY ON EMPTY – jest elementem obowiązkowym. Oznacza, że wartości puste są zwracane jako sekwencja i nie są
zamieniane na wartość null.

Zwracaną wartością jest wartość typu XML i jest sekwencją węzłów albo wartości. Nie ma gwarancji, że wynik będzie
prawidłowym dokumentem XML i dlatego może zaistnieć sytacja, że wynik nie będzie mógł być użyty w operatorze
XMLPARSE. Aby wynik mógł być zapamiętany w kolumnie typu XML musi on być sekwencją z dokładnie jedną jednostką w
sekwencji i musi być prawidłowym węzłem dokumentu.

Aby obejrzeć wynik, należy użyć operatora XMLSERIALIZE.

Przykład 1

SELECT id, XMLSERIALIZE(XMLQUERY('//pies[country=\"PL\"]' PASSING BY REF pies EMPTY ON EMPTY) AS CLOB) FROM
psy

Niezależnie czy XMLQUERY zwraca wynik czy nie to w zbiorze wynikowym znajdą się i tak wszystkie wyniki. Aby je
odczytać z CLOB należy użyć stosownych metod JDBC.

Przykład 2

Aby w ‘Przykładzie 1’ prawidłowo odczytać wyniki należy użyć operatora XMLEXISTS w po słowie kluczowym WHERE, np.

WHERE XMLEXISTS('//pies[@country=\"PL\"]' PASSING BY REF pies)

Przykład

Przykład zbiorczy dla operatorów XML znajduje się we wpisie Apache Derby: operatory
XML