다음을 통해 공유

  • 아티클

sql:variable() 함수(XQuery)

XQuery 식 내의 SQL 관계형 값을 포함하는 변수를 제공합니다.

구문

sql:variable("variableName") as xdt:anyAtomicType?

주의

XML 데이터 내 관계형 데이터 바인딩 항목에 설명된 것과 같이 XML 데이터 형식 메서드를 사용할 때 이 함수를 사용하여 XQuery 내에 관계형 값을 제공할 수 있습니다.

예를 들어 query() 메서드를 사용하여 xml 데이터 형식 변수 또는 열에 저장된 XML 인스턴스에 대해 쿼리를 지정합니다. 일부 경우에는 쿼리에서 Transact-SQL 변수 또는 매개 변수로부터 값을 사용하거나 관계형 및 XML 데이터를 함께 사용할 수 있습니다. 이렇게 하려면 sql:variable 함수를 사용합니다.

SQL 값은 해당 XQuery 값으로 매핑되고 이 값의 유형은 해당 SQL 유형과 같은 XQuery 기본 유형이 됩니다.

XML-DML 삽입 문의 원본 식 컨텍스트에 있는 xml 인스턴스만 참조할 수 있으며 그외의 경우에는 xml 유형 또는 CLR(공용 언어 런타임) 사용자 정의 형식의 열을 참조할 수 없습니다.

예

1. sql:variable() 함수를 사용하여 Transact-SQL 변수 값을 XML로 가져오기

다음 예에서는 다음으로 구성된 XML 인스턴스를 생성합니다.

  • 비 XML 열의 값(ProductID). XML에서 이 값을 바인딩하는 데에는 sql:column() 함수가 사용됩니다.

  • 다른 테이블에 있는 비 XML 열의 값(ListPrice). 여기에서도 XML에서 이 값을 바인딩하는 데 sql:column()이 사용됩니다.

  • Transact-SQL 변수의 값(DiscountPrice). XML로 이 값을 바인딩하는 데 sql:variable() 메서드가 사용됩니다.

  • 쿼리를 보다 효율적으로 만들기 위한 xml 유형 열의 값(ProductModelName)

다음은 쿼리입니다.

DECLARE @price money

SET @price=2500.00
SELECT ProductID, Production.ProductModel.ProductModelID,CatalogDescription.query('
declare namespace pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";

       <Product 
           ProductID="{ sql:column("Production.Product.ProductID") }"
           ProductModelID= "{ sql:column("Production.Product.ProductModelID") }"
           ProductModelName="{/pd:ProductDescription[1]/@ProductModelName }"
           ListPrice="{ sql:column("Production.Product.ListPrice") }"
           DiscountPrice="{ sql:variable("@price") }"
        />') 
FROM Production.Product 
JOIN Production.ProductModel
ON Production.Product.ProductModelID = Production.ProductModel.ProductModelID
WHERE ProductID=771

이전 쿼리에서 다음을 유의하십시오.

  • query() 메서드 내부의 XQuery는 XML을 생성합니다.

  • XQuery 프롤로그에서 네임스페이스 접두사를 정의하는 데 namespace 키워드가 사용됩니다. 이러한 작업은 스키마가 연결되어 있는 CatalogDescription xml 유형의 열에서 ProductModelName 특성 값이 검색되기 때문에 수행됩니다.

다음은 결과입니다.

<Product ProductID="771" ProductModelID="19" 
         ProductModelName="Mountain 100" 
         ListPrice="3399.99" DiscountPrice="2500" />