A função SINGULAR retorna um valor Booleano que indica se uma lista contém exatamente um elemento.
Se a lista especificada por ListExpression contiver exatamente um elemento, SINGULAR retornará TRUE. Se a lista contiver mais ou menos elementos, SINGULAR retornará FALSE.
Se desejar saber apenas se uma lista contém apenas um elemento ou algum outro número, SINGULAR é executado mais rapidamente que uma expressão envolvendo a função CARDINALITY (por exemplo, CARDINALITY(ListExpression ) = 1).
Um uso típico desta função é para determinar se um campo é exclusivo.
-- Determinar se existe apenas um campo F1 na mensagem.
-- Observe que os [ ] são requeridos
DECLARE Field1Unique BOOLEAN SINGULAR(OutputRoot.XMLNS.Data.Source.F1[]);
-- Determinar se existe apenas um campo chamado F1 com o valor 'F12'
-- na mensagem. Novamente, observe que os [ ] são requeridos
DECLARE Field1F12Unique BOOLEAN
SINGULAR(SELECT F.* FROM OutputRoot.XMLNS.Data.Source.F1[] AS F where F = 'F12');