application_name 是一个 配置参数，可用于指示客户端应用程序的名称。
application_name 在 PostgreSQL 9.0 中添加。
用法
application_name 是一种纯粹的建议性设置，任何客户端应用程序都可以提供。它最多可以包含 63 个可打印的 ASCII 字符（任何其他字符都将显示为 ?）。
虽然 application_name 可以像任何其他 配置参数 一样进行配置，但通常由应用程序作为 libpq conninfo 字符串的一部分提供，这将覆盖任何现有的配置设置。它也可以通过环境变量 PGAPPNAME 提供。
如果既未设置 application_name 也未设置 PGAPPNAME，但设置了 fallback_application_name，则后者将用作有效的应用程序名称。
application_name 将显示在系统目录视图 pg_stat_activity 中的同名字段中。它将包含在 CSV 日志 输出中，并通过 log_line_prefix 参数包含在其他日志输出中。
按 PostgreSQL 版本详细说明
application_name (PostgreSQL 17)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待重启 | 否 |
文档: application_name
application_name (PostgreSQL 16)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待重启 | 否 |
文档: application_name
application_name (PostgreSQL 15)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待重启 | 否 |
文档: application_name
application_name (PostgreSQL 14)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待重启 | 否 |
文档: application_name
application_name (PostgreSQL 13)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待重启 | 否 |
文档: application_name
application_name (PostgreSQL 12)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待重启 | 否 |
文档: application_name
application_name (PostgreSQL 11)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待重启 | 否 |
文档: application_name
application_name (PostgreSQL 10)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待重启 | 否 |
文档: application_name
application_name (PostgreSQL 9.6)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待重启 | 否 |
文档: application_name
application_name (PostgreSQL 9.5)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待重启 | 否 |
文档: application_name
application_name (PostgreSQL 9.4)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 |
文档: application_name
application_name (PostgreSQL 9.3)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 |
文档: application_name
application_name (PostgreSQL 9.2)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 |
文档: application_name
application_name (PostgreSQL 9.1)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 |
文档: application_name
application_name (PostgreSQL 9.0)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录内容 |
| 简短描述 | 设置要在统计信息和日志中报告的应用程序名称。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 |
文档: application_name
更改历史记录
- PostgreSQL 9.0
- 添加（初始提交 8217cfbd）。
示例
postgres$ psql psql (15.1) Type "help" for help. postgres=# ALTER SYSTEM SET application_name ='foo'; ALTER SYSTEM postgres=# SELECT pg_reload_conf(); pg_reload_conf ---------------- t (1 row) postgres=# SHOW application_name; application_name ------------------ psql (1 row) postgres=# SELECT datname, usename, application_name FROM pg_stat_activity WHERE pid = pg_backend_pid(); datname | usename | application_name ----------+----------+------------------ postgres | postgres | psql (1 row) postgres=# \q postgres$ psql -d 'application_name=myapp' psql (15.1) Type "help" for help. postgres=# SHOW application_name; application_name ------------------ myapp (1 row) postgres$ psql -d 'application_name=' psql (15.1) Type "help" for help. postgres=# SHOW application_name; application_name ------------------ foo (1 row)
参考文献
- PostgreSQL 文档： application_name
- PostgreSQL 文档： 环境变量 - PGAPPNAME