ノードの関数 - local-name
適用対象:SQL Server
長さ 0 の文字列になるか、xs:NCName の字句形式になる xs:string として、$argの名前のローカル部分を返します。 引数が指定されていない場合、既定値はコンテキスト ノードです。
構文
fn:local-name() as xs:string
fn:local-name($arg as node()?) as xs:string
引数
$arg
local-name 部分が取得されるノード名。
解説
SQL Serverでは、引数を指定しない fn:local-name() は、コンテキスト依存述語のコンテキストでのみ使用できます。 具体的には、角かっこ (
[ ]
) 内でのみ使用できます。引数が指定され、空のシーケンスである場合、関数は長さ 0 の文字列を返します。
ターゲット ノードに名前がない場合は、ドキュメント ノード、コメント、またはテキスト ノードであるため、関数は長さ 0 の文字列を返します。
例
このトピックでは、AdventureWorks データベースのさまざまな xml 型列に格納されている XML インスタンスに対する XQuery の例を示します。
A. 特定のノードのローカル名を取得する
型指定されていない XML インスタンスに対して、次のクエリを指定します。 クエリ式 は、 local-name(/ROOT[1])
指定したノードのローカル名部分を取得します。
declare @x xml
set @x='<ROOT><a>111</a></ROOT>'
SELECT @x.query('local-name(/ROOT[1])')
-- result = ROOT
次のクエリは、ProductModel テーブルの Instructions 列 (型指定された xml 列) に対して指定されます。 式 は、 local-name(/AWMI:root[1]/AWMI:Location[1])
指定したノードのローカル名 Location
である を返します。
SELECT Instructions.query('
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions" ;
local-name(/AWMI:root[1]/AWMI:Location[1])') as Result
FROM Production.ProductModel
WHERE ProductModelID=7
-- result = Location
B. 述語で引数を指定せずに local-name を使用する
次のクエリは、ProductModel テーブルの Instructions 列 (型指定された xml 列) に対して指定されます。 式は、QName のローカル名部分が "Location" である要素のすべての要素の子を <root
> 返します。 local-name() 関数は述語で指定され、引数がありません。コンテキスト ノードは関数によって使用されます。
SELECT Instructions.query('
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions" ;
/AWMI:root//*[local-name() = "Location"]') as Result
FROM Production.ProductModel
WHERE ProductModelID=7
クエリは、 要素のすべての要素の <Location
> 子を <root
> 返します。