↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / psql 命令 / 查询执行

\g

将当前查询缓冲区发送给服务器执行。

当前查看 PostgreSQL 18。

中文定义与说明

将当前查询缓冲区发送给服务器执行。

如果在\g 后面出现括号,则括号中是用空格分隔的 option=value 格式选项子句列表。这些子句的解释方式与\pset option value 命令相同,但仅在此查询执行期间生效。在此列表中,=符号周围不允许有空格,但选项子句之间必须有空格。如果=value 被省略,则指定的 option 会按以下命令的方式更改:\pset option,其中不显式指定 value。

如果给出了 filename 或|command 参数,查询输出就会写入指定文件,或通过管道传给指定的 shell 命令,而不是照常显示。只有当查询成功返回零个或多个元组时,才会向文件或命令写入;如果查询失败,或执行的是不返回数据的 SQL 命令,则不会写入。

如果当前查询缓冲区为空,则最近发送的查询将被重新执行。除此之外,没有任何参数的\g 基本上等同于一个分号。带有参数的\g 提供了一个“一次性”替代\o 命令的选择,并且还允许一次性调整通常由\pset 设置的输出格式选项。

当最后一个参数以|开头时,该行剩余的全部内容都会被视为要执行的 command,其中既不进行变量插值,也不进行反引号扩展。该行剩余部分会直接按字面传给 shell。

说明

将当前查询缓冲区发送给服务器执行。

客户端
psql 18.7
区分大小写的写法
\g

用法

\g [ ( option = value [...]) ] [ filename ] \g [ ( option = value [...]) ] [ | command ]

本版手册中的写法

命令手册中的后缀修饰符
\g此语法签名未列出

手册定义

将当前查询缓冲区发送给服务器执行。

如果在\g 后面出现括号,则括号中是用空格分隔的 option=value 格式选项子句列表。这些子句的解释方式与\pset option value 命令相同,但仅在此查询执行期间生效。在此列表中,=符号周围不允许有空格,但选项子句之间必须有空格。如果=value 被省略,则指定的 option 会按以下命令的方式更改:\pset option,其中不显式指定 value。

如果给出了 filename 或|command 参数,查询输出就会写入指定文件,或通过管道传给指定的 shell 命令,而不是照常显示。只有当查询成功返回零个或多个元组时,才会向文件或命令写入;如果查询失败,或执行的是不返回数据的 SQL 命令,则不会写入。

如果当前查询缓冲区为空,则最近发送的查询将被重新执行。除此之外,没有任何参数的\g 基本上等同于一个分号。带有参数的\g 提供了一个“一次性”替代\o 命令的选择,并且还允许一次性调整通常由\pset 设置的输出格式选项。

当最后一个参数以|开头时,该行剩余的全部内容都会被视为要执行的 command,其中既不进行变量插值,也不进行反引号扩展。该行剩余部分会直接按字面传给 shell。

相关条目

文档与源码

来源构建
版本
18.7
构建
https://ftp.postgresql.org/pub/source/v18.7/postgresql-18.7.tar.bz2
来源指纹
1b2d62b4845aa46374f2cb680f95d3392322cc8128646992ae4e18d0e7084915

版本比较

PostgreSQL 17 → 18: 无变化。

比较已记录的接口与属性,排除来源指纹和构建元数据。某个样本中没有记录,不能据此判断实际引入或移除的版本。

相关条目

导出 JSON · 返回psql 命令 · 收录范围为 PostgreSQL 10 至 20;最早采样版本不一定是实际引入版本。