value() 메서드(xml 데이터 형식)
XML에 대해 XQuery를 수행하고 SQL 유형의 값을 반환합니다. 이 메서드는 스칼라 값을 반환합니다.
이 메서드는 일반적으로 xml 유형 열, 매개 변수 또는 변수에 저장된 XML 인스턴스로부터 값을 추출하는 데 사용됩니다. 이 방식으로 비-XML 열에 있는 데이터와 XML 데이터를 조합 또는 비교하는 SELECT 쿼리를 지정할 수 있습니다.
구문
value (XQuery, SQLType)
인수
XQuery
XML 인스턴스 내에서 데이터를 검색하는 XQuery 식(문자열 리터럴)입니다. XQuery는 최대 하나의 값을 반환해야 합니다. 그렇지 않으면 오류가 반환됩니다.SQLType
반환되는 기본 SQL 유형(문자열 리터럴)입니다. 이 메서드의 반환 형식은 SQLType 매개 변수와 일치합니다. SQLType은 xml 데이터 형식, CLR(공용 언어 런타임) 사용자 정의 형식, image, text, ntext 또는 sql_variant 데이터 형식이 될 수 없습니다. SQLType은 SQL 사용자 정의 데이터 형식일 수 있습니다.
value() 메서드는 Transact-SQL CONVERT 연산자를 암시적으로 사용하고 직렬화된 문자열 표현인 XQuery 식의 결과를 XSD 유형에서 Transact-SQL 변환으로 지정된 해당 SQL 유형으로 변환하려고 시도합니다. CONVERT에 대한 캐스트 규칙에 대한 자세한 내용은 CAST 및 CONVERT(Transact-SQL)를 참조하십시오.
[!참고]
성능상의 이유로 조건자에서 value() 메서드를 사용하여 관계형 값과 비교하는 대신 sql:column()에서 exist()를 사용하십시오. 뒤에 나오는 예 4에서 이러한 작업 방법을 보여 줍니다.
예
1.xml 유형 변수에 대해 value() 메서드 사용
다음 예에서 XML 인스턴스는 xml 유형의 변수에 저장됩니다. value() 메서드는 XML에서 ProductID 특성 값을 검색합니다. 그런 다음 이 값은 int 변수에 할당됩니다.
DECLARE @myDoc xml
DECLARE @ProdID int
SET @myDoc = '<Root>
<ProductDescription ProductID="1" ProductName="Road Bike">
<Features>
<Warranty>1 year parts and labor</Warranty>
<Maintenance>3 year parts and labor extended maintenance is available</Maintenance>
</Features>
</ProductDescription>
</Root>'
SET @ProdID = @myDoc.value('(/Root/ProductDescription/@ProductID)[1]', 'int' )
SELECT @ProdID
값 1이 결과로 반환됩니다.
XML 인스턴스에 ProductID 특성이 하나만 있지만 정적 형식 지정 규칙에 따라 경로 식이 단일 항목을 반환하도록 명시적으로 지정해야 합니다. 따라서 추가 항목 [1]은 경로 식의 끝에 지정됩니다. 정적 형식 지정에 대한 자세한 내용은 XQuery 및 정적 형식 지정을 참조하십시오.
2.value() 메서드를 사용하여 xml 유형 열에서 값 검색
AdventureWorks 데이터베이스의 xml 유형 열(CatalogDescription)에 대해서는 다음 쿼리가 지정됩니다. 이 쿼리는 열에 저장된 각 XML 인스턴스로부터 ProductModelID 특성 값을 검색합니다.
SELECT CatalogDescription.value('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
(/PD:ProductDescription/@ProductModelID)[1]', 'int') AS Result
FROM Production.ProductModel
WHERE CatalogDescription IS NOT NULL
ORDER BY Result desc
이전 쿼리에서 다음을 유의하십시오.
namespace 키워드는 네임스페이스 접두사를 정의하는 데 사용됩니다.
각 정적 형식 지정 요구 사항에 따라 value() 메서드에 있는 경로 식의 끝에 [1]이 추가되어 해당 경로 식이 단일 항목을 반환함을 명시적으로 나타냅니다.
다음은 결과의 일부입니다.
-----------
35
34
...
3.value() 및 exist() 메서드를 사용하여 xml 유형 열로부터 값 검색
다음 예에서는 xml 데이터 형식의 value() 메서드 및 exist() 메서드를 사용하는 방법을 보여 줍니다. value() 메서드는 XML로부터 ProductModelID 특성 값을 검색하는 데 사용됩니다. WHERE 절에 있는 exist() 메서드는 테이블의 행을 필터링하는 데 사용됩니다.
이 쿼리는 여러 기능 중 하나로 보증 정보(<Warranty> 요소)가 포함된 제품 모델 ID를 XML 인스턴스로부터 검색합니다. WHERE 절의 조건에서는 exist() 메서드를 사용하여 이 조건을 만족하는 행만 검색합니다.
SELECT CatalogDescription.value('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
(/PD:ProductDescription/@ProductModelID)[1] ', 'int') as Result
FROM Production.ProductModel
WHERE CatalogDescription.exist('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
/PD:ProductDescription/PD:Features/wm:Warranty ') = 1
이전 쿼리에서 다음을 유의하십시오.
CatalogDescription 열은 형식화된 XML 열입니다. 즉, 이 열에는 이와 관련된 스키마 컬렉션이 있습니다. XQuery 프롤로그에서 네임스페이스 선언은 나중에 쿼리 본문에서 사용되는 접두사를 정의하기 위해 사용됩니다.
exist() 메서드가 1(True)을 반환하는 경우는 XML 인스턴스에 여러 기능 중 하나로 <Warranty> 자식 요소가 포함되어 있음을 나타냅니다.
그런 다음 SELECT 절의 value() 메서드는 ProductModelID 특성 값을 정수로 검색합니다.
다음은 결과의 일부입니다.
Result
-----------
19
23
...
4.value() 메서드 대신 exist() 메서드 사용
성능상의 이유로 조건자에서 value() 메서드를 사용하여 관계형 값과 비교하는 대신 sql:column()에서 exist()를 사용하십시오. 예를 들면 다음과 같습니다.
CREATE TABLE T (c1 int, c2 varchar(10), c3 xml)
GO
SELECT c1, c2, c3
FROM T
WHERE c3.value( '/root[1]/@a', 'integer') = c1
GO
다음은 이에 대한 예입니다.
SELECT c1, c2, c3
FROM T
WHERE c3.exist( '/root[@a=sql:column("c1")]') = 1
GO
참고 항목
개념
WITH XMLNAMESPACES를 사용하여 쿼리에 네임스페이스 추가