La funzione SINGULAR restituisce un valore BOOLEAN che indica se un elenco contiene esattamente un elemento.
Se l'elenco specificato da ListExpression contiene esattamente un elemento, SINGULAR restituisce TRUE. Se l'elenco contiene un numero maggiore o minore di elementi, SINGULAR restituisce FALSE.
Se si desidera solo sapere se un elenco contiene un solo elemento oppure un numero diverso di elementi, SINGULAR viene eseguita più rapidamente di un'espressione che utilizza la funzione CARDINALITY (ad esempio, CARDINALITY(ListExpression ) = 1).
Un utilizzo comune di questa funzione è quello di determinare se un campo è univoco.
-- Determine whether there is just one F1 field in the message. -- Note that the [ ] are required DECLARE Field1Unique BOOLEAN SINGULAR(OutputRoot.XML.Data.Source.F1[]);
-- Determine whether there is just one field called F1 with the value 'F12' -- in the message. Again note that the [ ] are required DECLARE Field1F12Unique BOOLEAN SINGULAR(SELECT F.* FROM OutputRoot.XML.Data.Source.F1[] AS F where F = 'F12');