Share via


QNames に関係する関数 - local-name-from-QName

適用対象:SQL Server

$argで指定された QName のローカル部分を表す xs:NCNAME を返します。 $argが空のシーケンスの場合、結果は空のシーケンスになります。

構文

fn:local-name-from-QName($arg as xs:QName?) as xs:NCName?  

引数

$arg
ローカル名部分を抽出する QName です。

このトピックでは、データベース内のさまざまな xml 型の列に格納されている XML インスタンスに対する XQuery の例を AdventureWorks2022 示します。

次の例では、 local-name-from-QName() 関数を使用して、QName 型の値からローカル名と名前空間 URI の部分を取得します。 この例では、次の処理を実行します。

  • XML スキーマ コレクションを作成します。

  • xml 型の列を持つテーブルの作成。 xml 型は、XML スキーマ コレクションを使用して型指定されます。

  • サンプル XML インスタンスをテーブルに格納します。 xml データ型の query() メソッドを使用して、クエリ式が実行され、インスタンスから QName 型値のローカル名部分が取得されます。

DROP TABLE T  
go  
DROP XML SCHEMA COLLECTION SC  
go  
CREATE XML SCHEMA COLLECTION SC AS '  
<schema xmlns="http://www.w3.org/2001/XMLSchema"  
targetNamespace="QNameXSD" >  
      <element name="root" type="QName" nillable="true"/>  
</schema>'  
go  
  
CREATE TABLE T (xmlCol XML(SC))  
go  
-- following OK  
insert into T values ('<root xmlns="QNameXSD" xmlns:a="https://someURI">a:someLocalName</root>')  
 go  
-- Retrieve the local name.   
SELECT xmlCol.query('declare default element namespace "QNameXSD"; local-name-from-QName(/root[1])')  
FROM T  
-- Result = someLocalName  
-- You can retrieve namespace URI part from the QName using the namespace-uri-from-QName() function  
SELECT xmlCol.query('declare default element namespace "QNameXSD"; namespace-uri-from-QName(/root[1])')  
FROM T  
-- Result = https://someURI  

参照

QNames に関係する関数 (XQuery)