STRING_AGG (Transact-SQL)

Se aplica a: SQL Server 2017 (14.x) y versiones posteriores, Azure SQL Database Azure SQL Instancia administrada punto de conexión de SQL Analytics de Azure Synapse Analytics en Microsoft Fabric Warehouse en Microsoft Fabric

Concatena los valores de expresiones de cadena y coloca valores de separador entre ellos. El separador no se agrega al final de la cadena.

Convenciones de sintaxis de Transact-SQL

Sintaxis

STRING_AGG ( expression, separator ) [ <order_clause> ]

<order_clause> ::=   
    WITHIN GROUP ( ORDER BY <order_by_expression_list> [ ASC | DESC ] )   

Argumentos

expression
Es una expresión de cualquier tipo. Las expresiones se convierten en tipos NVARCHAR o VARCHAR durante la concatenación. Los tipos que no son de cadena se convierten en NVARCHAR.

separator
Es una expresión de tipo NVARCHAR o VARCHAR que se usa como separador de cadenas concatenadas. Puede ser un literal o una variable.

<order_clause>
Si quiere, especifique el orden de los resultados concatenados con la cláusula WITHIN GROUP:

WITHIN GROUP ( ORDER BY <order_by_expression_list> [ ASC | DESC ] )

<order_by_expression_list>

Lista de expresiones no constantes que se pueden usar para ordenar los resultados. Solo se permite un parámetro order_by_expression por consulta. El criterio de ordenación predeterminado es ascendente.

Tipos de valor devuelto

El tipo de valor devuelto depende del primer argumento (expresión). Si el argumento de entrada es de tipo string (NVARCHAR, VARCHAR), el tipo del resultado será igual que el tipo de la entrada. En la siguiente tabla se enumeran las conversiones automáticas:

Comentarios

STRING_AGG es una función de agregado que toma todas las expresiones de las filas y las concatena en una sola cadena. Los valores de la expresión se convierten implícitamente a tipos string y, después, se concatenan. La conversión implícita de cadenas sigue las reglas existentes para las conversiones de tipos de datos. Para más información sobre las conversiones de tipo de datos, vea CAST y CONVERT (Transact-SQL).

Si la expresión de entrada es de tipo VARCHAR, el separador no puede ser de tipo NVARCHAR.

Los valores NULL se omiten y no se agrega el separador correspondiente. Para devolver un marcador de posición para valores NULL, use la función ISNULL como se muestra en el ejemplo B.

STRING_AGG está disponible en cualquier nivel de compatibilidad.

Ejemplos

La mayoría de los ejemplos de este artículo hacen referencia a las bases de datos de ejemplo AdventureWorks.

A. Generar una lista de nombres separados en líneas nuevas

En el siguiente ejemplo se genera una lista de nombres en una única celda de resultados separados por retornos de carro.

USE AdventureWorks2022;
GO
SELECT STRING_AGG (CONVERT(NVARCHAR(max),FirstName), CHAR(13)) AS csv 
FROM Person.Person;
GO

Este es el conjunto de resultados.

Los valores NULL detectados en las celdas name no se incluyen en el resultado.

B. Generar una lista de nombres separados por coma sin valores NULL

En el siguiente ejemplo los valores NULL se reemplazan por "N/A" y se devuelven los nombres separados por comas en una única celda de resultados.

USE AdventureWorks2022;
GO
SELECT STRING_AGG(CONVERT(NVARCHAR(max), ISNULL(FirstName,'N/A')), ',') AS csv 
FROM Person.Person;
GO

Este es el conjunto de resultados.

C. Generar nombres separados por comas

USE AdventureWorks2022;
GO
SELECT STRING_AGG(CONVERT(NVARCHAR(max), CONCAT(FirstName, ' ', LastName, '(', ModifiedDate, ')')), CHAR(13)) AS names 
FROM Person.Person;
GO

Este es el conjunto de resultados.

D. Devolver artículos de noticias con etiquetas relacionadas

Imagine una base de datos donde los artículos y sus etiquetas se separan en tablas diferentes. Un desarrollador quiere que se devuelva una fila por cada artículo con todas las etiquetas asociadas. La consulta siguiente logra este resultado:

SELECT a.articleId, title, STRING_AGG (tag, ',') as tags
FROM dbo.Article AS a
LEFT JOIN dbo.ArticleTag AS t
    ON a.ArticleId = t.ArticleId
GROUP BY a.articleId, title;
GO

Este es el conjunto de resultados.

E. Generar una lista de correos electrónicos por ciudades

Con la siguiente consulta se buscan las direcciones de correo electrónico de los empleados y se agrupan por ciudad:

USE AdventureWorks2022;
GO

SELECT TOP 10 City, STRING_AGG(CONVERT(NVARCHAR(max), EmailAddress), ';') AS emails 
FROM Person.BusinessEntityAddress AS BEA  
INNER JOIN Person.Address AS A ON BEA.AddressID = A.AddressID
INNER JOIN Person.EmailAddress AS EA ON BEA.BusinessEntityID = EA.BusinessEntityID 
GROUP BY City;
GO

Este es el conjunto de resultados.

Los correos electrónicos devueltos en la columna emails se pueden usar para enviar mensajes de correo electrónico al grupo de personas que trabajan en determinadas ciudades.

F. Generar una lista ordenada de correos electrónicos por ciudades

Al igual que el ejemplo anterior, con la siguiente consulta se buscan las direcciones de correo electrónico de los empleados, se agrupan por ciudad y se ordenan alfabéticamente:

USE AdventureWorks2022;
GO

SELECT TOP 10 City, STRING_AGG(CONVERT(NVARCHAR(max), EmailAddress), ';') WITHIN GROUP (ORDER BY EmailAddress ASC) AS Emails 
FROM Person.BusinessEntityAddress AS BEA  
INNER JOIN Person.Address AS A ON BEA.AddressID = A.AddressID
INNER JOIN Person.EmailAddress AS EA ON BEA.BusinessEntityID = EA.BusinessEntityID 
GROUP BY City;
GO

Este es el conjunto de resultados.

Pasos siguientes

Aprenda más sobre las funciones de Transact-SQL en los artículos siguientes:

• STRING_ESCAPE (Transact-SQL)
• STUFF (Transact-SQL)
• CONCAT (Transact-SQL)
• CONCAT_WS (Transact-SQL)
• Funciones de agregado (Transact-SQL)
• String Functions (Transact-SQL) [Funciones de cadena (Transact-SQL)]