Adminer调用PostgreSQL函数时数组参数传递问题解析

在使用Adminer 5.2.1管理PostgreSQL 14.17数据库时，开发者遇到了一个关于函数调用的特殊问题。当尝试调用返回表格数据的PostgreSQL函数时，系统报错提示"column does not exist"，而实际上该列名是函数返回结果的列名而非数据库表中的列。

问题现象

开发者定义了一个名为get_vehicle_counts_by_report_category_and_age的函数，该函数接收多个参数并返回包含车辆年龄、报告类别ID和车辆数量的结果集。在Adminer界面中调用此函数时，系统错误地将返回结果的列名vehicle_age_in_months识别为数据库列，导致查询失败。

问题根源

经过分析，这个问题源于Adminer对PostgreSQL函数参数处理的两个关键点：

1. 数组参数格式处理：PostgreSQL要求数组参数使用'{}'格式传入，而Adminer生成的查询中使用了JSON数组格式'["912-19"]'，这与PostgreSQL的数组输入规范不符。

2. 输出列名识别：Adminer错误地将函数返回结果中的列名vehicle_age_in_months解析为查询中的实际列名，而非结果集的列名。

解决方案

针对这个问题，Adminer开发团队已经进行了修复，主要改进包括：

1. 修正了数组参数的传递格式，确保符合PostgreSQL规范，使用'{}'而非JSON格式。

2. 优化了函数调用时对返回列名的处理逻辑，避免将结果列名误认为查询列名。

技术要点

对于PostgreSQL函数调用，开发者需要注意以下几点：

1. 数组参数传递：在PostgreSQL中，数组参数应使用'{value1,value2}'格式传递，而不是JSON格式。

2. 函数返回处理：当函数返回表格数据时，Adminer会将返回的列名作为结果集的列名处理，不应将这些列名与数据库实际列名混淆。

3. 参数默认值：PostgreSQL函数支持参数默认值，在Adminer中调用时可以省略有默认值的参数。

最佳实践

为避免类似问题，建议：

1. 在Adminer中调用PostgreSQL函数时，确保参数格式符合PostgreSQL规范。

2. 对于复杂参数类型（如数组），先在PostgreSQL命令行或其它客户端测试确认正确的传递格式。

3. 保持Adminer版本更新，以获取最新的功能改进和错误修复。

4. 在定义返回表格数据的函数时，明确指定返回列名和数据类型，避免歧义。

通过理解这些技术细节，开发者可以更有效地使用Adminer管理PostgreSQL数据库，并正确处理函数调用中的各种参数类型。