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 19)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档:application_name
application_name (PostgreSQL 18)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档:application_name
application_name (PostgreSQL 17)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档:application_name
application_name (PostgreSQL 16)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档:application_name
application_name (PostgreSQL 15)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档:application_name
application_name (PostgreSQL 14)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档:application_name
application_name (PostgreSQL 13)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档:application_name
application_name (PostgreSQL 12)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档:application_name
application_name (PostgreSQL 11)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档:application_name
application_name (PostgreSQL 10)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档:application_name
application_name (PostgreSQL 9.6)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档:application_name
application_name (PostgreSQL 9.5)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档:application_name
application_name (PostgreSQL 9.4)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
文档:application_name
application_name (PostgreSQL 9.3)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
文档:application_name
application_name (PostgreSQL 9.2)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
文档:application_name
application_name (PostgreSQL 9.1)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
文档:application_name
application_name (PostgreSQL 9.0)
| 设置 |
|
| 单位 |
|
| 类别 |
报告和日志记录 / 记录什么 |
| 简短描述 |
设置要在统计信息和日志中报告的应用程序名称。 |
| 扩展描述 |
|
| 上下文 |
user |
| 变量类型 |
string |
| 来源 |
默认 |
| 最小值 |
|
| 最大值 |
|
| 枚举值 |
|
| 启动值 |
|
| 重置值 |
|
| 源文件 |
|
| 源行 |
|
文档:application_name
变更历史
示例
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)