XQuery コードのアップグレード

この節では、インライン XQuery コードとスタンドアロン XQuery ファイルを XQuery 2002 から 2004 にアップグレードする手順について説明します。

インライン XQuery コードのアップグレード

WLI 8.x プロジェクトを 10g Release 3 (10.1.3) にアップグレードする場合、デフォルトでは、インラインの (JPD ファイルに埋め込まれている) XQuery 2002 コードは XQuery 2004 に変換されません。インライン XQuery コードを XQuery 2004 に変換するには、アップグレードウィザードの [ソースのアップグレード] ウィザード画面で以下の手順を実行します。

XQuery ファイルのアップグレード

XQuery 2002 準拠の XQuery ファイルは (インライン XQuery コード とは異なり) アプリケーションのアップグレードプロセス中に XQuery 2004 に自動変換されません。

Workshop の [ナビゲーター] ビューで XQuery ファイルを右クリックし、[XQuery 2004 へのアップグレード] を選択すると、XQuery 2002 準拠の XQuery ファイルを XQuery 2004 にアップグレードできます。ただし、以下の XQuery の構文と関数は XQuery 2004 に変換されません。

XQuery 2004 で変更された構文

表 A-1 XQuery 2004 で変更された構文
XQuery 2002	XQuery 2004	注意
`precedes`	`<<`	場合によっては、単に構文が変わっただけでも正しい結果にならない可能性がある。
`follows`	`>>`	場合によっては、単に構文が変わっただけでも正しい結果にならない可能性がある。
`add-timezone-to-dateTime`	`fn:adjust-dateTime-to-timezone`	構文とパラメータの型が変更された。XQuery 2002 の構文では、パラメータの符号に関係なく、この処理は追加操作になった。XQuery 2004 では、パラメータの符号によって処理が異なる。
`remove-timezone-from-dateTime`	`fn:adjust-dateTime-to-timezone`
`document()`	`fn:doc()`	パラメータの型と戻り値の型が異なる可能性がある。
`foreach`	`for $i in ….`	`foreach` に直接代わるものがない。`for` ループを使用して構文を記述し直す必要がある。
`some $x in (1, 2, 3), xs:integer $y in (2, 3, 4)`	`some $x in (1,2,3),$y in (2,3,4)`	省略可能な型宣言があるため、この構文を確実に変換するのは難しい。
`every $x in (1, 2, 3), xs:integer $y in (2, 3, 4)`	`every $x in (1,2,3), $y in (2,3,4)`	省略可能な型宣言があるため、この構文を確実に変換するのは難しい。

XQuery 2004 でセマンティクスが変更された関数

表 A-2 XQuery 2004 でセマンティクスが変更された関数
XQuery 2002	XQuery 2004
`xf:resolve-uri(anyURI $base, anyURI $relative)`	`fn:resolve-uri($relative as xs:string?, $base as xs:string)`
`xf:distinct-values(item* $srcval) => item*`	`fn:distinct-values ($arg as xdt:anyAtomicType) as xdt:anyAtomicType`

キャストのルールが変更された構文 : eq、ne、lt、gt、le、ge
XQuery 2004 で戻り値の型が変更された関数

時間/日付関連の関数と演算子の大部分
sortby を含むクエリ
generic-divide
div
expanded-QName
namespaces
QName
node-name
namespace-uri
subsequence
integer-divide
round
name

XQuery 2004 ではサポートされない関数 : julianDay-from-date

アップグレードプロセス中、XQuery 2004 でサポートされていない XQuery 2002 の構文と関数には、コード内に「: Warning :」というコメントエントリが付けられます。また、アップグレードプロセス中に、サポートされない構文と関数があることを示す警告メッセージが表示されます。

アップグレードプロセス後に、XQuery 2004 にアップグレードされていない構文と関数を特定するには、「: Warning :」というコメントを探します。その後で、XQuery 2004 標準に準拠するように、サポートされない構文と関数を手動で変更する必要があります。

XQuery Mapper を使用したデータの変換

XQuery コードのアップグレード

インライン XQuery コードのアップグレード

XQuery ファイルのアップグレード