適用対象:
SQL Server
長さ 0 の文字列またはxs:NCNameの字句形式のxs:stringとして、$argの名前のローカル部分を返します。 引数が指定されていない場合、既定値はコンテキスト ノードです。
構文
fn:local-name() as xs:string
fn:local-name($arg as node()?) as xs:string
引数
$arg
ローカル名部分が取得されるノード名。
解説
SQL Server では、引数のない
fn:local-name()は、コンテキスト依存述語のコンテキストでのみ使用できます。 具体的には、角かっこ ([ ]) 内でのみ使用できます。引数が指定され、空のシーケンスである場合、関数は長さ 0 の文字列を返します。
ターゲット ノードに名前がない場合、ドキュメント ノード、コメント、またはテキスト ノードであるため、この関数は長さ 0 の文字列を返します。
例
この記事では、AdventureWorks データベースのさまざまな xml 型列に格納されている XML インスタンスに対する XQuery の例を示します。
A. 特定のノードのローカル名を取得する
型指定されていない XML インスタンスに対して、次のクエリを指定します。 クエリ式 local-name(/ROOT[1])、指定したノードのローカル名部分を取得します。
DECLARE @x AS XML;
SET @x = '<ROOT><a>111</a></ROOT>';
SELECT @x.query('local-name(/ROOT[1])');
-- result = ROOT
次のクエリは、ProductModel テーブルの型指定された xml 列である Instructions 列に対して指定されます。 式 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;
クエリは、<root>要素のすべての<Location>要素の子を返します。