Compartir a través de

string-length (función de XQuery)

Devuelve la longitud de la cadena en caracteres.

Sintaxis

fn:string-length() as xs:integer
fn:string-length($arg as xs:string?) as xs:integer

Argumentos

  • $arg
    Cadena de origen cuya longitud se va a calcular.

Comentarios

Si el valor de $arg es una secuencia vacía, se devuelve un valor de xs:integer igual a cero.

El comportamiento de los pares suplentes en funciones XQuery depende del nivel de compatibilidad de la base de datos. Si el nivel de compatibilidad es 110 o superior, cada par suplente se cuenta como un carácter individual. Para los niveles de compatibilidad inferiores, se cuentan como dos caracteres. Para obtener más información, vea Nivel de compatibilidad de ALTER DATABASE (Transact-SQL) y Compatibilidad con la intercalación y Unicode.

Si el valor contiene un carácter Unicode de 4 bytes representado por dos caracteres suplentes, SQL Server contará los caracteres suplentes individualmente.

string-length() sin un parámetro se puede usar solo dentro de un predicado. Por ejemplo, la siguiente consulta devuelve el elemento <ROOT>:

DECLARE @x xml;
SET @x='<ROOT>Hello</ROOT>';
SELECT @x.query('/ROOT[string-length()=5]');

Caracteres adicionales (pares suplentes)

El comportamiento de pares suplentes en las funciones XQuery depende del nivel de compatibilidad de la base de datos y, en algunos casos, del URI del espacio de nombres predeterminado de las funciones. Para obtener más información, vea la sección "Las funciones de XQuery detectan los caracteres suplentes" en el tema Cambios recientes en las características del Motor de base de datos de SQL Server 2012. Consulte también Nivel de compatibilidad de ALTER DATABASE (Transact-SQL) y Compatibilidad con la intercalación y Unicode.

Ejemplos

En este tema se ofrecen ejemplos de XQuery con instancias XML almacenadas en varias columnas de tipo xml en la base de datos AdventureWorks.

A.Usar la función string-length() de XQuery para recuperar productos con descripciones resumidas largas

Para productos cuya descripción resumida tiene más de 50 caracteres, la consulta siguiente recupera el id. de producto, la longitud de la descripción resumida y el resumen en sí, el elemento <Summary>.

WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' as pd)
SELECT CatalogDescription.query('
      <Prod ProductID= "{ /pd:ProductDescription[1]/@ProductModelID }" >
       <LongSummary SummaryLength = 
           "{string-length(string( (/pd:ProductDescription/pd:Summary)[1] )) }" >
           { string( (/pd:ProductDescription/pd:Summary)[1] ) }
       </LongSummary>
      </Prod>
 ') as Result
FROM Production.ProductModel
WHERE CatalogDescription.value('string-length( string( (/pd:ProductDescription/pd:Summary)[1]))', 'decimal') > 200;

Observe lo siguiente en la consulta anterior:

  • La condición de la cláusula WHERE recupera solo las filas donde la descripción resumida almacenada en el documento XML tiene más de 200 caracteres. Utiliza el método de tipo de datos XML value().

  • La cláusula SELECT genera solo el XML que desea. Utiliza el método de tipo de datos XML query() para construir el XML y especificar la expresión XQuery necesaria para recuperar datos del documento XML.

Éste es un resultado parcial:

Result
-------------------
<Prod ProductID="19">
      <LongSummary SummaryLength="214">Our top-of-the-line competition 
             mountain bike. Performance-enhancing options include the
             innovative HL Frame, super-smooth front suspension, and 
             traction for all terrain.
      </LongSummary>
</Prod>
...

B.Usar la función de XQuery string-length() para recuperar productos cuya descripción de garantía es corta

Para los productos cuya descripción de garantía tiene menos de 20 caracteres, la consulta siguiente recupera XML que incluye el identificador de producto, la longitud, la descripción de garantía y el elemento <Warranty> en sí.

Warranty es una de las características del producto. Un elemento secundario <Warranty> opcional sigue al elemento <Features>.

WITH XMLNAMESPACES (
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS pd,
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain' AS wm)

SELECT CatalogDescription.query('
      for   $ProdDesc in /pd:ProductDescription,
            $pf in $ProdDesc/pd:Features/wm:Warranty
      where string-length( string(($pf/wm:Description)[1]) ) < 20
      return 
          <Prod >
             { $ProdDesc/@ProductModelID }
             <ShortFeature FeatureDescLength = 
                             "{string-length( string(($pf/wm:Description)[1]) ) }" >
                 { $pf }
             </ShortFeature>
          </Prod>
     ') as Result
FROM Production.ProductModel
WHERE CatalogDescription.exist('/pd:ProductDescription')=1;

Observe lo siguiente en la consulta anterior:

  • pd y wm son los prefijos de espacio de nombres utilizados en esta consulta. Identifican los mismos espacios de nombres utilizados en el documento que se va a consultar.

  • La consulta XQuery especifica un bucle FOR anidado. El bucle FOR externo es necesario, porque desea recuperar los atributos ProductModelID del elemento <ProductDescription>. El bucle FOR interno es necesario, porque solo desea obtener aquellos productos que tengan descripciones de garantía con menos de 20 caracteres.

Éste es el resultado parcial:

Result
-------------------------
<Prod ProductModelID="19">
  <ShortFeature FeatureDescLength="15">
    <wm:Warranty 
       xmlns:wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain">
      <wm:WarrantyPeriod>3 years</wm:WarrantyPeriod>
      <wm:Description>parts and labor</wm:Description>
    </wm:Warranty>
   </ShortFeature>
</Prod>
...

Vea también

Referencia

Funciones de XQuery con el tipo de datos xml

  • Last updated on