SQLParser-rs 新增对 WITH ORDINALITY 语法的支持

在 PostgreSQL 数据库中，WITH ORDINALITY 是一个非常有用的语法特性，它允许用户在调用集合返回函数(SRF)时为结果集中的每一行添加一个序号列。最近，SQLParser-rs 项目增加了对这一语法的解析支持，使得该解析器能够更好地兼容 PostgreSQL 的特定语法。

什么是 WITH ORDINALITY

WITH ORDINALITY 是 PostgreSQL 特有的语法扩展，它通常与集合返回函数(Set-Returning Functions)一起使用。当在 FROM 子句中的函数调用后添加 WITH ORDINALITY 时，PostgreSQL 会在结果集中自动添加一个名为 "ordinality" 的列，该列包含从1开始递增的行号。

例如，以下查询：

SELECT * FROM my_srf() WITH ORDINALITY;

会返回 my_srf() 函数的所有结果行，并在每行前面添加一个序号列。

技术实现细节

在 SQLParser-rs 的实现中，这一特性是通过扩展 TableFactor 的语法结构来实现的。具体来说，在解析 FROM 子句时，解析器现在能够识别并处理函数调用后跟的 WITH ORDINALITY 关键字。

这种语法结构在 PostgreSQL 中特别有用，因为它提供了一种简单的方法来为集合返回函数的结果添加行号，而无需使用复杂的窗口函数或子查询。例如，在处理 JSON 或 XML 数据时，当需要分解数组元素并保留原始顺序信息时，这一特性就显得尤为重要。

兼容性考虑

虽然 WITH ORDINALITY 是 PostgreSQL 特有的语法，但 SQLParser-rs 作为一个通用的 SQL 解析器，增加对这一语法的支持有助于提高其对不同数据库方言的兼容性。这一变化不会影响解析器对其他标准 SQL 语法的处理能力，同时为需要解析 PostgreSQL 特定语法的用户提供了更好的支持。

实际应用场景

在实际应用中，WITH ORDINALITY 可以用于多种场景：

1. 当需要处理 JSON 或 XML 数组并保留元素顺序时
2. 在需要为结果集添加连续行号的报表生成场景中
3. 在需要按顺序处理函数返回的多行结果时

通过 SQLParser-rs 对这一语法的支持，开发者现在可以更方便地在 Rust 生态中构建需要解析 PostgreSQL 特定 SQL 的工具和应用。