order by 節

FLWOR 式の中の order by 節は、return 節によって値が処理される順序を指定します。

order by 節には、1 つ以上の順序付けの指定が含まれます。 順序付けの指定は、where 節によるフィルタリング後に保持される変数バインディングのタプルを再配列するために使われます。 結果としてできる順序により、return 節が評価される順序が決まります。

それぞれの順序付け指定は、順序付けキーを作成するために評価される式、および順序付けキーのソート順序 (昇順または降順) を指定する順序修飾子で構成されます。 2 つのタプルの相対順序は、それらの順序付けキーの値を左から右の方向に比較することにより決定されます。

以下の例の FLWOR 式には、製品をその価格に基づいて降順にソートする order by 節が含まれています。
SELECT XMLQUERY(
  'declare namespace ipo="http://www.example.com/IPO";
  for $i in $po/ipo:purchaseOrder/items/item
  order by xs:decimal($i/USPrice) descending
  return fn:concat($i/productName, ":US$", $i/USPrice)'
  PASSING PORDER as "po")
FROM PURCHASEORDER
PURCHASEORDER 表の列 PORDER に、以下のデータが含まれているとします。
<ipo:purchaseOrder
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns:ipo="http://www.example.com/IPO"
   orderDate="2008-12-01">
  <shipTo exportCode="1" xsi:type="ipo:UKAddress">
    <name>Helen Zoe</name>
    <street>55 Eden Street</street>
    <city>San Jose</city>
    <state>CA</state>
    <postcode>CB1 1JR</postcode>
  </shipTo>
  <shipTo exportCode="1" xsi:type="ipo:UKAddress">
    <name>Joe Lee</name>
    <street>66 University Avenue</street>
    <city>Palo Alto</city>
    <state>CA</state>
    <postcode>CB1 1JR</postcode>
  </shipTo>
  <billTo xsi:type="ipo:USAddress">
    <name>Robert Smith</name>
    <street>8 Oak Avenue</street>
    <city>Old Town</city>
    <state>PA</state>
    <zip>95819</zip>
  </billTo>
  <items>
    <item partNum="833-AA">
      <productName>Lapis necklace</productName>
      <quantity>1</quantity>
      <USPrice>99.95</USPrice>
      <ipo:comment>Want this for the holidays!</ipo:comment>
      <shipDate>2008-12-05</shipDate>
    </item>
    <item partNum="945-ZG">
      <productName>Sapphire Bracelet</productName>
      <quantity>2</quantity>
      <USPrice>178.99</USPrice>
      <shipDate>2009-01-03</shipDate>
    </item>
  </items>
</ipo:purchaseOrder>

order by 節の処理時には、for 節によって生成される各タプルに関して順序付け指定の式が評価されます。 最初のタプルでは、式 xs:decimal($i/USPrice) によって戻される値は 99.95 です。 続いて、次のタプルに関して式が評価され、式は値 178.99 を戻します。 順序付けの指定で、item (品目)を降順にソートすることが示されているため、ソートにより価格 99.95 の製品は価格 178.99 の製品より後になります。 このソート・プロセスは、すべてのタプルが再配列されるまで継続されます。 続いて、再配列されたタプル・ストリーム内のタプルごとに return 節が 1 回ずつ実行されます。

この例の照会は以下の結果を戻します。
Sapphire Bracelet:US$178.99 Lapis necklace:US$99.95

この例では、順序付け指定内の式により、USPrice エレメントの値から xs:decimal 値が構成されます。 XML スキーマ内の USPrice エレメントのタイプ・アノテーションが xs:untypedAtomic であるため、このタイプ変換が必要になります。 この変換がないと、数値による順序付けの代わりにストリングによる順序付けが結果で使用されます。

さらに、順序付けキー値の動的タイプが xs:untypedAtomic である場合も、型のないアトミック・データをストリングとして扱うよう順序付けキーの比較規則で指示されているため、明示的タイプ変換が必要になります。

ヒント: FLWOR 式で order by 節を使用して、照会での値の順序付けを指定することができます。 順序付けをしなければ、反復処理は必要ありません。 例えば、以下のパス式は、顧客 ID (Cid) が 1000 より大きい customerinfo エレメントのリストを戻します。
$ci/customerinfo[@Cid > "1000"]
しかし、これらの項目を顧客名の昇順で戻すには、次のような order by 節を含む FLWOR 式を指定する必要があります。
SELECT XMLQUERY(
  'declare default element namespace "http://posample.org";
  for $custinfo in $ci/customerinfo
  where ($custinfo/@Cid > 1000)
  order by $custinfo/name ascending
  return $custinfo'
  PASSING XMLAGG(INFO) as "ci")
FROM CUSTOMER
順序付けキーは、出力に含まれる必要はありません。 以下の照会では、価格の降順で製品名のリストが生成されますが、出力には価格が含まれません。
SELECT XMLQUERY(
  'declare namespace ipo="http://www.example.com/IPO";
  for $i in $po/ipo:purchaseOrder/items/item
  order by xs:decimal($i/USPrice) descending
  return $i/productName'
  PASSING PORDER as "po")
FROM PURCHASEORDER

順序付け指定の比較の規則

順序付けの指定を評価して比較する処理は、以下の規則に基づきます。
  • 順序付け指定の中の式が評価されて、結果がアトミック値に変換されます。 変換の結果は、単一のアトミック値または空シーケンスのいずれかである必要があります。 そうでない場合、エラーが戻されます。 順序付け指定を評価した結果を、順序付けキーと呼びます。
  • 順序付けキーのタイプが xs:untypedAtomic である場合、そのキーは xs:string タイプにキャストされます。
  • 順序付けの指定によって生成される値がすべて同じタイプではない場合、それらの値 (キー) は、サブタイプ置換または タイプ・プロモーションによって共通のタイプに変換されます。 キーは、gt 演算子をサポートする最も共通性の低いタイプに変換されて、比較されます。 いずれかの順序付け指定により生成された順序付けキーに、gt 演算子をサポートする共通タイプがない場合は、結果としてエラーになります。
  • 順序付けキーの値を使用することで、バインド済み変数のタプルが return 節の実行用に渡される順序が決まります。 タプルの順序付けは、以下の規則を使って順序付けキーを左から右の方向に比較することにより決定されます。
    • ソート順が昇順の場合、他のタプルより大きい順序付けキーを持つタプルは、ソートによってそれらのタプルより後になります。
    • ソート順が降順の場合、他のタプルより大きい順序付けキーを持つタプルは、ソートによってそれらのタプルより前になります。
    順序付けキーの「より大きい」関係は、以下のように定義されます。
    • 空シーケンスは、他のすべての値より大きいものとして扱われます。
    • NaN は、空シーケンスを除く他のすべての値より大きいものとして扱われます。
    • ある値が別の値と比較されて gt 演算子が true を戻す場合、その値は別の値より大きいものとして扱われます。
    • +0.0 gt -0.0 および -0.0 gt +0.0 は両方とも false であるため、特別な浮動小数点値「正のゼロ」および「負のゼロ」は、どちらも他方より大きいものとして扱われません。