LIST 函数 [Aggregate]

LIST( 
[ALL | DISTINCT ] string-expression
[, delimiter-string ]
[ ORDER BY order-by-expression [ ASC | DESC ], ... ] )

string-expression 字符串表达式，通常是列名。如果指定了 ALL（默认设置），对于组中的每一行，string-expression 的值会添加到结果字符串，并用 delimiter-string 分隔这些值。如果指定了 DISTINCT，则只添加唯一的 string-expression 值。
delimiter-string 列表项的分隔字符串。缺省设置是逗号。如果设为 NULL 值或空字符串，则没有分隔符。delimiter-string 必须是常量。

order-by-expression 对该函数返回的项进行排序。此参数之前没有逗号，以便在未提供 delimiter-string 的情况下使用。

order-by-expression 不能是整数值。但可以是包含整数的变量。

当 ORDER BY 子句包含常量时，由优化程序对常量进行解释，然后替换为等效的 ORDER BY 子句。例如，优化程序将 ORDER BY 'a' 解释为 ORDER BY 表达式。

如果几个有效的 ORDER BY 子句可以在逻辑上组合成一个 ORDER BY 子句，则可执行其中含有这几个 ORDER BY 子句的包含多个集合函数的查询块。例如，以下子句：

ORDER BY expression1, 'a', expression2

ORDER BY expression1, 'b', expression2, 'c', expression3

可归入下个子句：

ORDER BY expression1, expression2, expression3

LIST 函数返回一串组中每一行 X 的所有非 NULL 值（带分隔符）。如果组中没有任何一行具有明确的 X 值，则 LIST( X ) 返回空字符串。

LIST 函数会忽略 NULL 值和空字符串。

LIST 函数不能用作窗口函数，但可用作窗口函数的输入。

此函数支持 NCHAR 输入和/或输出。

SQL/2008 服务商扩充。
SQL Anywhere 支持 SQL/2008 语言功能 F441 "扩展集函数支持"，它允许集合函数的操作数是列引用以外的任意表达式。

SQL Anywhere 不支持可选的 SQL/2008 功能 F442 "集函数中的混合列引用"。SQL Anywhere 不允许集合函数参数既含有来自包含 LIST 函数的查询块的列引用，又含有外部引用。请参见集合函数和外部引用。有关示例内容，请参见AVG 函数 [Aggregate]。

以下语句返回值 487 Kennedy Court, 547 School Street。

SELECT LIST( Street ) FROM Employees
WHERE GivenName = 'Thomas';

以下语句列出雇员 ID。结果集中的每一行都包含某一部门雇员 ID 的逗号分隔列表。

SELECT LIST( EmployeeID )
FROM Employees
GROUP BY DepartmentID;

以下语句对职员 ID 按职员的姓进行排序：

SELECT LIST( EmployeeID ORDER BY Surname ) AS "Sorted IDs"
FROM Employees
GROUP BY DepartmentID;

Sorted IDs '1751,591,1062,1191,992,888,318,184,1576,207,1684,1643,1607,1740,409,1507'

以下语句返回以分号分隔的列表。请注意 ORDER BY 子句的位置和列表分隔符：

SELECT LIST( EmployeeID, ';' ORDER BY Surname ) AS "Sorted IDs"
FROM Employees
GROUP BY DepartmentID;

务必要将以下语句与前一个语句加以区分，以下语句返回以逗号分隔并按复合排序关键字 ( Surname, ';' ) 排序的雇员 ID 列表：

SELECT LIST( EmployeeID ORDER BY Surname, ';' ) AS "Sorted IDs"
FROM Employees
GROUP BY DepartmentID;