STRING_AGG (Transact-SQL)

Область применения: SQL Server 2017 (14.x) и более поздних версий База данных SQL Azure Управляемый экземпляр SQL Azure конечной точке аналитики SQL Azure Synapse Analytics в хранилище Microsoft Fabric в Microsoft Fabric

Сцепляет значения строковых выражений, помещая между ними значения-разделители. В конце строки разделитель не добавляется.

Соглашения о синтаксисе Transact-SQL

Синтаксис

STRING_AGG ( expression, separator ) [ <order_clause> ]

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

Аргументы

выражение
Выражение любого типа данных. Во время объединения выражения преобразуются в тип NVARCHAR или VARCHAR. Нестроковые типы преобразуются в тип NVARCHAR.

separator
Выражение типа NVARCHAR или VARCHAR, которое используется в качестве разделителя сцепляемых строк. Может быть литералом или переменной.

<order_clause>
При необходимости укажите очередность сцепляемых результатов с помощью предложения WITHIN GROUP:

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

<order_by_expression_list>

Список неконстантных выражений, который можно использовать для сортировки результатов. В запросе допускается только один аргумент order_by_expression. По умолчанию задан порядок сортировки по возрастанию.

Типы возвращаемых данных

Тип возвращаемого значения зависит от первого аргумента (выражения). Если входной аргумент имеет строковый тип (NVARCHAR, VARCHAR), результат будет иметь тот же тип. В приведенной ниже таблице перечислены автоматические преобразования.

Замечания

STRING_AGG — это агрегатная функция, которая принимает все выражения из строк и сцепляет их в одну строку. Значения выражений неявно преобразуются в строковые типы и затем сцепляются. Неявное преобразование в строки выполняется по существующим правилам преобразования типов данных. Дополнительные сведения о преобразовании типов данных см. в статье Функции CAST и CONVERT (Transact-SQL).

Если входное выражение имеет тип VARCHAR, разделитель не может иметь тип NVARCHAR.

Значения NULL пропускаются, и соответствующий разделитель не добавляется. Чтобы вернуть заполнитель для значений NULL, используйте функцию ISNULL, как показано в примере Б.

Функция STRING_AGG доступна на любом уровне совместимости.

Примеры

Большинство примеров в этой статье ссылаются на образцы баз данных AdventureWorks.

А. Формирование списка имен, разделенного по строкам

В приведенном ниже примере формируется список имен в одной результирующей ячейке, разделенный символами возврата каретки.

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

Вот результирующий набор.

Значения NULL, найденные в ячейках name, не возвращаются в результатах.

B. Формирование списка имен, разделенного запятыми, без значений NULL

В приведенном ниже примере значения NULL заменяются на "N/A" и имена, разделенные запятыми, возвращаются в одной результирующей ячейке.

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

Вот результирующий набор.

C. Формирование списка значений с разделителями-запятыми

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

Вот результирующий набор.

D. Получение новых статей со связанными тегами

Представьте базу данных, в которой статьи и их теги разделены по разным таблицам. Разработчику необходимо вернуть одну строку для каждой статьи со всеми связанными тегами. Этот результат имеет следующий запрос:

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

Вот результирующий набор.

Е. Формирование списка адресов электронной почты по городам

Следующий запрос находит адреса электронной почты сотрудников и группирует их по городам:

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

Вот результирующий набор.

Адреса, возвращенные в столбце emails, можно использовать для рассылки сообщений группе людей, работающих в определенном городе.

F. Формирование отсортированного списка адресов электронной почты по городам

Так же как в предыдущем примере, следующий запрос находит адреса электронной почты сотрудников, группирует их по городам и сортирует по алфавиту:

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

Вот результирующий набор.

Следующие шаги

Дополнительные сведения о функциях Transact-SQL см. в следующих статьях:

• STRING_ESCAPE (Transact-SQL)
• STUFF (Transact-SQL)
• CONCAT (Transact-SQL)
• CONCAT_WS (Transact-SQL)
• Агрегатные функции (Transact-SQL)
• Строковые функции (Transact-SQL)