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

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

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

WLI 8.x プロジェクトを 10.2 にアップグレードする場合、デフォルトでは、(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 ファイルのアップグレード