문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

value() 메서드(xml 데이터 형식)

XML에 대해 XQuery를 수행하고 SQL 유형의 값을 반환합니다. 이 메서드는 스칼라 값을 반환합니다.

이 메서드는 일반적으로 xml 유형 열, 매개 변수 또는 변수에 저장된 XML 인스턴스로부터 값을 추출하는 데 사용됩니다. 이 방식으로 비-XML 열에 있는 데이터와 XML 데이터를 조합 또는 비교하는 SELECT 쿼리를 지정할 수 있습니다.

value (XQuery, SQLType)

XQuery

XML 인스턴스 내에서 데이터를 검색하는 XQuery 식(문자열 리터럴)입니다. XQuery는 최대 하나의 값을 반환해야 합니다. 그렇지 않으면 오류가 반환됩니다.

SQLType

반환되는 기본 SQL 유형(문자열 리터럴)입니다. 이 메서드의 반환 형식은 SQLType 매개 변수와 일치합니다. SQLTypexml 데이터 형식, 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="http://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="http://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="http://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
     declare namespace wm="http://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

커뮤니티 추가 항목

추가
표시: