コンテキスト関数 - position (XQuery)
適用対象: 
SQL Server
現在処理されているアイテムのシーケンス内のコンテキスト アイテムの位置を示す整数値を返します。
構文
fn:position() as xs:integer
解説
SQL Server では、 fn:position() はコンテキスト依存述語のコンテキストでのみ使用できます。 具体的には、角かっこ ([ ]) 内でのみ使用できます。この関数と比較しても、静的型推論中のカーディナリティは低下しません。
例
このトピックでは、AdventureWorks2022 データベースのさまざまな xml 型の列に格納されている XML インスタンスに対する XQuery の例を示します。
A. position() XQuery 関数を使用して最初の 2 つの製品機能を取得する
次のクエリでは、製品モデル カタログの説明から、 <Features> 要素の最初の 2 つの子要素である最初の 2 つの特徴を取得します。 さらに多くの特徴がある場合は、結果に <there-is-more/> 要素が追加されます。
SELECT CatalogDescription.query('
declare namespace pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
<Product>
{ /pd:ProductDescription/@ProductModelID }
{ /pd:ProductDescription/@ProductModelName }
{
for $f in /pd:ProductDescription/pd:Features/*[position()<=2]
return
$f
}
{
if (count(/pd:ProductDescription/pd:Features/*) > 2)
then <there-is-more/>
else ()
}
</Product>
') as x
FROM Production.ProductModel
WHERE CatalogDescription is not null
上のクエリに関して、次の点に注意してください。
XQuery Prolog の namespace キーワードは、クエリ本文で使用される名前空間プレフィックスを定義します。
クエリ本文は、ProductModelID 属性と ProductModelName 属性を持つ <Product> 要素を持ち、子要素として返される製品機能を持つ XML を構築します。
position()関数は、コンテキスト内の<Features>子要素の位置を決定するために述語で使用されます。 1 番目または 2 番目の特徴である場合は、返されます。
IF ステートメントは、製品カタログに 2 つ以上の機能がある場合に、結果に <there-is-more/> 要素を追加します。
カタログの記述がテーブルに保持されていない製品モデルもあるので、WHERE 句を使用して CatalogDescriptions が NULL の行を破棄しています。
これは部分的な結果です。
<Product ProductModelID="19" ProductModelName="Mountain 100">
<p1:Warranty xmlns:p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain">
<p1:WarrantyPeriod>3 year</p1:WarrantyPeriod>
<p1:Description>parts and labor</p1:Description>
</p1:Warranty>
<p2:Maintenance xmlns:p2="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain">
<p2:NoOfYears>10</p2:NoOfYears>
<p2:Description>maintenance contact available through your dealer or
any AdventureWorks retail store.</p2:Description>
</p2:Maintenance>
<there-is-more/>
</Product>
...