postgres_output
`postgres_output` 指令指定从 PostgreSQL 查询返回的数据的输出格式。
PostgreSQL module for NGINX
·
httpserverlocationif in location
语法postgres_output rds | text | value | binary_value | none;
默认值rds
上下文http, server, location, if in location
参数1
说明
postgres_output 指令在 ngx_postgres 模块中配置 PostgreSQL 数据库输出的格式。该指令接受一个参数,用于决定返回给客户端的响应格式。可用的格式包括 rds,这是一种与 ngx_rds_json 和 ngx_drizzle 模块兼容的格式;text,提供纯文本响应;value,用于单个标量返回值;binary_value,用于二进制数据;以及 none,完全禁用输出格式化。
当设置为 rds 时,输出以便于在 NGINX 中与基于 JSON 的处理模块集成的方式进行结构化,从而使其更适合现代 Web 应用的集成。用户可以根据应用需求配置输出。例如,当需要文本数据时可以使用 text,而 value 适用于预计仅返回标量结果的查询。none 选项可用于不对输出进行任何处理的场景,实际上传递原始数据而不做转换。
该指令可以在不同上下文中定义,例如 http、server 和 location,允许基于不同路由或处理需求对数据输出进行细粒度控制。确保输出格式与客户端或应用的期望一致非常重要,以避免对返回数据的误解。
配置示例
location /query {
postgres_pass my_back_end;
postgres_query SELECT * FROM my_table;
postgres_output json;
}⚠
使用不受支持的输出格式可能导致意外结果或错误。
⚠
确保输出格式与接收该数据的应用程序的预期一致,以避免数据被误解。