【灵活设置PostgreSQL的PROMPT1客户端提示符】

Prompting是指psql的客户端提示符,有三个变量:PROMPT1, PROMPT2, ROMPT3,具体区别如下:

  • PROMPT1 : 当psql等待新命令发出时的常规提示符,PROMPT1最常见。
  • PROMPT2: 在命令输入过程中等待更多输入时发出的提示符,例如当命令没有使用分号终止或者引用没有被关闭时就会发出这个提示符。
  • PROMPT3 : 在运行一个COPY FROM STDIN命令,并且需要在终端上输入一个行值时发出的提示符。

官网的解释如下:

Prompting

The prompts psql issues can be customized to your preference. The three variables PROMPT1, PROMPT2, and PROMPT3 contain strings and special escape sequences that describe the appearance of the prompt. Prompt 1 is the normal prompt that is issued when psql requests a new command. Prompt 2 is issued when more input is expected during command entry, for example because the command was not terminated with a semicolon or a quote was not closed. Prompt 3 is issued when you are running an SQL COPY FROM STDIN command and you need to type in a row value on the terminal.

PROMPT1和PROMPT2的默认设置值一样,默认值都为%/%R%#,这三个字符的解释如下:

  • %/: 当前的数据库名称。
  • %R: PROMPT1通常为=,如果会话断开,则显示!;PROMPT2中-表示命令等待更多输入,*表示未完成的注释。
  • %#: 如果是超级用户则显示#,其他用户显示>。

一、常用的提示符

PROMPT1和PROMPT2可以设置的一些常用的提示符如下,也可以参考官网PostgreSQL: Documentation: 13: psql

复制代码
%>   端口
%p   当前连接的后端的进程ID。
%M   数据库服务器的完整主机名
%m   数据库服务器的主机名,在第一个点处截断
%n   数据库会话用户名。(在数据库会话期间,该值的扩展可能会因命令的结果而发生变化SET SESSION AUTHORIZATION。)
%/   当前数据库的名称。
%#   如果会话用户是数据库超级用户,则为 a #,否则为>。(在数据库会话期间,该值的扩展可能会因命令的结果而发生变化SET SESSION AUTHORIZATION。)
%p   当前连接的后端的进程ID。

二、灵活设置PROMPT1的一些例子

PROMPT1最常见。设置psql启动时执行的命令,可以把如下的\set ...相关命令加入.psqlrc。定义在 psql 启动时自动运行的命令,更改提示显示并设置别名。

但是不建议设置过多,设置过多反而臃肿了。一行的提示的显示就占了大半行。

有时候使用gdb调试PostgreSQL的时候,需要根据pid去attach对应连接。这个时候如果我们增加了%p的变量,这样pid就直接在前边提示符里打印出来了,就不需要再去查询pg_backend_pid();获取pid了。同时也可以在前边加上%n得到当前连接使用的用户

复制代码
postgres=#  \set PROMPT1 '%/(ConnAs[%n]:PID[%p])%R# '
postgres(ConnAs[postgres]:PID[24683])=#
postgres(ConnAs[postgres]:PID[24683])=#

也可以加上系统的时间

复制代码
postgres=# \set PROMPT1 '%/(ConnAs[%n]:PID[%p] %`date +"%Y-%m-%d/%H:%M:%S"`)%R# '
postgres(ConnAs[postgres]:PID[24618] 2024-02-01/15:26:34)=#
postgres(ConnAs[postgres]:PID[24618] 2024-02-01/15:26:35)=#
postgres(ConnAs[postgres]:PID[24618] 2024-02-01/15:26:36)=#

加上 postgrers server的版本

复制代码
postgres=#  \set PROMPT1 '%/<%:SERVER_VERSION_NAME:>(ConnAs[%n]:PID[%p] %`date +"%Y-%m-%d/%H:%M:%S"`)%R# '
postgres<16.1>(ConnAs[postgres]:PID[25950] 2024-02-01/15:34:26)=#
postgres<16.1>(ConnAs[postgres]:PID[25950] 2024-02-01/15:34:27)=#

甚至可以使用返引号加上一些自定义的东西进去,例如把PGDATA的变量打印进去。

复制代码
postgres=# \set PROMPT1 '%/<%:SERVER_VERSION_NAME:>(ConnAs[%n]:PID[%p] %`date +"%Y-%m-%d/%H:%M:%S"` %`echo $PGDATA`)%R# '
postgres<16.1>(ConnAs[postgres]:PID[26909] 2024-02-01/15:40:10 /home/postgres/data-16)=#
postgres<16.1>(ConnAs[postgres]:PID[26909] 2024-02-01/15:40:12 /home/postgres/data-16)=#

或者在进行某些测试的时候,临时更改这个显示,例如我把pg_xlog下的xlog数量加到这个里边,便于我每次进入的时候,都能看到它的数量,直接回车也可以看到

复制代码
postgres@ubuntu-linux-22-04-desktop:~$ cd $PGDATA/pg_wal
postgres@ubuntu-linux-22-04-desktop:~/data-16/pg_wal$ ls
000000010000000000000038  000000010000000000000039  00000001000000000000003A  archive_status
postgres@ubuntu-linux-22-04-desktop:~/data-16/pg_wal$ psql
psql (16.1)
Type "help" for help.

postgres=#  \set PROMPT1 '%/<%:SERVER_VERSION_NAME:>(ConnAs[%n]:PID[%p] %`date +"%Y-%m-%d/%H:%M:%S"` pg_wal_count:%`ls $PGDATA/pg_wal|grep -v archive_status| wc -l`)%R# '
postgres<16.1>(ConnAs[postgres]:PID[28068] 2024-02-01/15:46:42 pg_wal_count:3)=#

再或者结合psql可以把数据库里查询到的东西作为前边的显示选项,例如把活跃连接数加到前边。(只不过有点笨,可能没必要,可以结合需求来。而且不建议设置那种执行时间比较长的SQL,否则可能造成性能问题,具体以实际环境为准,可以设置一些秒出,较简单的SQL)

复制代码
postgres=#  \set PROMPT1 '%/<%:SERVER_VERSION_NAME:>(ConnAs[%n]:PID[%p] %`date +"%Y-%m-%d/%H:%M:%S"` conn_count:%`psql -c" select count(*) from pg_stat_activity where state=\'active\';" -tAq`)%R# '
postgres<16.1>(ConnAs[postgres]:PID[30521] 2024-02-01/15:58:53 conn_count:1)=#
postgres<16.1>(ConnAs[postgres]:PID[30521] 2024-02-01/15:59:21 conn_count:2)=#
相关推荐
LucianaiB37 分钟前
【金仓数据库征文】_AI 赋能数据库运维:金仓KES的智能化未来
运维·数据库·人工智能·金仓数据库 2025 征文·数据库平替用金仓
时序数据说1 小时前
时序数据库IoTDB在航空航天领域的解决方案
大数据·数据库·时序数据库·iotdb
.生产的驴1 小时前
SpringBoot 封装统一API返回格式对象 标准化开发 请求封装 统一格式处理
java·数据库·spring boot·后端·spring·eclipse·maven
AnsenZhu1 小时前
2025年Redis分片存储性能优化指南
数据库·redis·性能优化·分片
oydcm2 小时前
MySQL数据库概述
数据库·mysql
oioihoii2 小时前
C++23中if consteval / if not consteval (P1938R3) 详解
java·数据库·c++23
带娃的IT创业者2 小时前
《AI大模型趣味实战》基于RAG向量数据库的知识库AI问答助手设计与实现
数据库·人工智能
husterlichf3 小时前
MYSQL 常用数值函数 和 条件函数 详解
数据库·sql·mysql
我的golang之路果然有问题3 小时前
快速了解redis,个人笔记
数据库·经验分享·redis·笔记·学习·缓存·内存
卡皮巴拉爱吃小蛋糕4 小时前
MySQL的MVCC【学习笔记】
数据库·笔记·mysql