Метод exist() (тип данных xml)
Возвращает значение типа bit, которое представляет одно из следующих состояний:
- 1, означающее True, если выражение на языке XQuery при запросе возвращает непустой результат, то есть возвращается как минимум один узел XML.
- 0, означающее False при возвращении пустого результата.
- Значение NULL, если экземпляр типа xml, к которому был выполнен запрос, содержит значение NULL.
Синтаксис
exist (XQuery)
Аргументы
- XQuery
Выражение на языке XQuery, строковый литерал.
Примеры
А. Указание метода exist() по отношению к переменной типа xml
В следующем примере @x является переменной типа xml (нетипизированный xml), а @f является переменной целочисленного типа, которая хранит значение, возвращенное методом exist(). Метод exist() возвращает значение True (1), если значение даты, хранимое в экземпляре XML, равно 2002-01-01.
declare @x xml
declare @f bit
set @x = '<root Somedate = "2002-01-01Z"/>'
set @f = @x.exist('/root[(@Somedate cast as xs:date?) eq xs:date("2002-01-01Z")]')
select @f
В сравнении дат в методе exist() обратите внимание на следующее:
- Код
cast as xs:date?используется для приведения значения к типу xs:date с целью сравнения. - Значение атрибута @Somedate является нетипизированным. При сравнении это значение неявно приводится к типу правой части выражения сравнения, а именно к типу xs:date.
- Вместо выражения cast as xs:date() можно использовать функцию-конструктор xs:date(). Дополнительные сведения см. в разделе Функции-конструкторы (XQuery).
Следующий пример похож на предыдущий, отличаясь только наличием элемента <Somedate>.
DECLARE @x xml
DECLARE @f bit
SET @x = '<Somedate>2002-01-01Z</Somedate>'
SET @f = @x.exist('/Somedate[(text()[1] cast as xs:date ?) = xs:date("2002-01-01Z") ]')
SELECT @f
В предыдущем запросе обратите внимание на следующее:
- Метод text() возвращает текстовый узел, содержащий нетипизированное значение
2002-01-01. (XQuery имеет тип xdt:untypedAtomic.) Необходимо явно привести это типизированное значение с x к xsd:date, поскольку неявное приведение в данном случае не поддерживается.
Б. Применение метода exist() к типизированной переменной типа xml
В следующем примере иллюстрируется применение метода exist() к переменной типа xml. Это типизированная переменная XML, поскольку она указывает имя схемы коллекции пространства имен, ManuInstructionsSchemaCollection.
В этом примере переменной вначале присваивается документ с инструкциями по производству, а затем используется метод exist(), чтобы выяснить, содержится ли в документе элемент <Location>, атрибут которого LocationID имеет значение 50.
Метод exist(), примененный к переменной @x, возвращает значение 1 (True), если документ с инструкциями по производству содержит элемент <Location> с атрибутом LocationID=50. В противном случае метод возвращает значение 0 (False).
DECLARE @x xml (Production.ManuInstructionsSchemaCollection)
SELECT @x=Instructions
FROM Production.ProductModel
WHERE ProductModelID=67
--SELECT @x
DECLARE @f int
SET @f = @x.exist(' declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
/AWMI:root/AWMI:Location[@LocationID=50]
')
SELECT @f
В. Применение метода exist() к столбцу типа xml
В следующем запросе производится поиск идентификаторов моделей продукции, описания которых в каталоге не содержат спецификаций, то есть элемента <Specifications>:
SELECT ProductModelID, CatalogDescription.query('
declare namespace pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
<Product
ProductModelID= "{ sql:column("ProductModelID") }"
/>
') AS Result
FROM Production.ProductModel
WHERE CatalogDescription.exist('
declare namespace pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
/pd:ProductDescription[not(pd:Specifications)]'
) = 1
Обратите внимание на следующее в предыдущем запросе:
- Предложение WHERE выбирает только те строки из таблицы ProductDescription, которые удовлетворяют условию, указанному в отношении столбца типа xml CatalogDescription.
- Метод exist() в предложении WHERE возвращает 1 (True), если XML не содержит элемента <
Specifications>. Обратите внимание на использование функции not() (XQuery). - Функция sql:column() (XQuery) используется для импорта значения из столбца, имеющего не XML тип.
- Этот запрос возвращает пустой набор строк.
Данный запрос указывает методы query() и exist() типа xml, и оба эти метода объявляют одинаковые пространства имен в прологе запроса. В этом случае для объявления префикса и использования его в запросе можно использовать предложение WITH XMLNAMESPACES.
WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS pd)
SELECT ProductModelID, CatalogDescription.query('
<Product
ProductModelID= "{ sql:column("ProductModelID") }"
/>
') AS Result
FROM Production.ProductModel
WHERE CatalogDescription.exist('
/pd:ProductDescription[not(pd:Specifications)]'
) = 1
См. также
Основные понятия
Добавление пространств имен с помощью предложения WITH XMLNAMESPACES
Типизированный и нетипизированный XML
Тип данных xml
Формирование XML-экземпляров
Язык модификации XML-данных (XML DML)
Образцы приложений XML