PostgreSQL 文档检索
PG 18 · 按类别浏览,或输入名称与关键词
分类索引819
psql --no-psqlrc-X--no-psqlrc
不读取启动文件(既不读取系统范围的psqlrc文件,也不读取用户的~/.psqlrc文件)。psql › 选项
psql --no-readline-n--no-readline
不要使用Readline进行行编辑,也不要使用命令历史记录(请参见下面的“命令行编辑”一节)。psql › 选项
psql --output=filename-o filename--output=filename
把所有查询输出放到文件filename中。这等效于命令\o。psql › 选项
psql --password-W--password
强制psql在连接数据库之前提示输入密码,即使该密码实际上不会被使用。 如果服务器要求密码认证,而密码又无法从其他来源获得,例如.pgpass文件,则psql无论如何都会提示输入密码。不过,psql需要先浪费一次连接尝试,才能知道服务器要求密码。在某些情况下,显式指定-W值得用来避免这次额外的连接尝试。 请注意,这个选项在整个会话期间都会保持生效,因此…psql › 选项
psql --port=port-p port--port=port
指定服务器正在监听连接的 TCP 端口,或本地 Unix 域套接字文件扩展名。默认值取自 PGPORT 环境变量;如果未设置,则取编译时指定的端口,通常为 5432。psql › 选项
psql --pset=assignment-P assignment--pset=assignment
以\pset的形式指定打印选项。注意,这里你必须用一个等号而不是空格来分隔名称和值。例如,要设置输出格式为LaTeX,应该写成-P format=latex。psql › 选项
psql --quiet-q--quiet
指定psql应该安静地工作。默认情况下,它会打印出欢迎消息和各种提示信息。如果使用了这个选项,以上那些就都不会输出。在使用-c选项时,配合这个选项很有用。这等效于设置变量QUIET为on。psql › 选项
psql --record-separator-zero-0--record-separator-zero
设置非对齐输出的记录分隔符为零字节。例如,这有助于与xargs -0配合使用。这等效于\pset recordsep_zero。psql › 选项
psql --record-separator=separator-R separator--record-separator=separator
把separator用作非对齐输出的记录分隔符。这等效于\pset recordsep命令。psql › 选项
psql --single-line-S--single-line
运行在单行模式中,其中换行符会终止一个 SQL 命令,就像分号的作用一样。 注意 这种模式是为坚持使用它的用户提供的,但并不一定值得推荐。特别是,如果在一行中混合了SQL和元命令,对于没有经验的用户来说,它们的执行顺序未必总是清楚的。psql › 选项
psql --single-step-s--single-step
运行在单步模式中。这意味着在每个命令被发送给服务器之前都会提示用户,并允许取消执行。使用这个选项可以调试脚本。psql › 选项
psql --single-transaction-1--single-transaction
这个选项只能与一个或多个-c和/或-f选项结合使用。它会导致psql在第一个这样的选项之前发出一个BEGIN命令,并在最后一个选项之后发出一个COMMIT命令,从而将所有命令包装成一个单独的事务。如果任何命令失败且变量ON_ERROR_STOP被设置,则会改为发送一个ROLLBACK命令。这确保要么所有命令都成功完成,要么不应用任何…psql › 选项
psql --table-attr=table_options-T table_options--table-attr=table_options
指定要放在HTML table标签内的选项。详见\pset tableattr。psql › 选项
psql --tuples-only-t--tuples-only
关闭打印列名和结果行计数页脚等。这等效于\t或者\pset tuples_only命令。psql › 选项
psql --username=username-U username--username=username
作为用户username而不是默认用户连接到数据库(当然,你必须具有这样做的权限)。psql › 选项
psql --variable=assignment-v assignment--set=assignment--variable=assignment
执行一次变量赋值,和\set元命令相似。注意你必须在命令行上用等号分隔名字和值(如果有)。要取消变量的设置,去掉等号就行。要把一个变量设为空字符串,使用等号但是去掉值。这些赋值在命令行处理期间被完成,因此反映连接状态的变量将在稍后被覆盖。psql › 选项
psql --version-V--version
打印psql版本并且退出。psql › 选项
reindexdbreindexdb — 重建一个 PostgreSQL 数据库中的索引
客户端程序
reindexdb [ connection-option ...] [ option ...] [ -S | --schema schema ] ... [ -t | --table table ] ... [ -i | --index index ] ... [ dbname ]
rein…命令行工具 · 客户端程序
reindexdb --all-a--all
重建所有数据库的索引。reindexdb › 选项
reindexdb --concurrently--concurrently
使用 CONCURRENTLY 选项。参见REINDEX,其中详细解释了该选项的所有注意事项。reindexdb › 选项
reindexdb --echo-e--echo
回显reindexdb生成并发送给服务器的命令。reindexdb › 选项
reindexdb --help-?--help
显示关于reindexdb命令行参数的帮助信息,并退出。reindexdb › 选项
reindexdb --host=host-h host--host=host
指定服务器所在机器的主机名。如果该值以斜杠开头,则它将被用作 Unix 域套接字的目录。reindexdb › 选项
reindexdb --index=index-i index--index=index
只重建index。可以通过写多个-i开关来重建多个索引。reindexdb › 选项
reindexdb --jobs=njobs-j njobs--jobs=njobs
通过同时运行njobs个命令来并行执行重建索引命令。此选项可能缩短处理时间,但也会增加数据库服务器上的负载。 reindexdb将打开njobs个到数据库的连接,因此请确保max_connections设置足够高,能容纳所有连接。 注意,该选项与--system选项不兼容。reindexdb › 选项
reindexdb --maintenance-db=dbname--maintenance-db=dbname
当使用-a/--all时,连接到该数据库以收集要重建索引的数据库列表。如果未指定,则使用postgres数据库;如果它不存在,则使用template1。这可以是一个连接字符串。如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。此外,除数据库名称本身以外的连接字符串参数,在连接到其他数据库时也会被重复使用。reindexdb › 选项
reindexdb --no-password-w--no-password
永远不发出密码提示。如果服务器要求密码认证,而又无法通过其他方式获取密码,例如通过.pgpass文件,则连接尝试会失败。此选项可用于没有用户可输入密码的批处理作业和脚本。reindexdb › 选项
reindexdb --password-W--password
强制reindexdb在连接数据库前提示输入密码。 该选项并非必需,因为如果服务器要求密码认证,reindexdb会自动提示输入密码。不过,reindexdb会先浪费一次连接尝试来确认服务器需要密码。在某些场景下,值得使用 -W,以避免这次额外的连接尝试。reindexdb › 选项
reindexdb --port=port-p port--port=port
指定服务器监听连接所用的 TCP 端口或本地 Unix 域套接字文件扩展名。reindexdb › 选项
reindexdb --quiet-q--quiet
不显示进度消息。reindexdb › 选项
reindexdb --schema=schema-S schema--schema=schema
只重建schema中的索引。可以通过写多个-S开关来重建多个模式中的索引。reindexdb › 选项
reindexdb --system-s--system
仅重建数据库的系统目录上的索引。reindexdb › 选项
reindexdb --table=table-t table--table=table
只重建table上的索引。可以通过写多个-t开关来重建多个表上的索引。reindexdb › 选项
reindexdb --tablespace=tablespace--tablespace=tablespace
指定重建索引所在的表空间。(该名称会按双引号标识符处理。)reindexdb › 选项
reindexdb --username=username-U username--username=username
连接时所使用的用户名。reindexdb › 选项
reindexdb --verbose-v--verbose
在处理过程中打印详细信息。reindexdb › 选项
reindexdb --version-V--version
打印reindexdb的版本并退出。reindexdb › 选项
reindexdb [--dbname=]dbname[-d] dbname[--dbname=]dbname
在未使用-a/--all时,指定要重建索引的数据库名称。如果未指定该选项,则从环境变量PGDATABASE中读取数据库名称。如果该变量未设置,则使用为连接指定的用户名。dbname可以是一个连接字符串。如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。reindexdb › 选项
replication这个选项确定连接是否应该使用复制协议而不是正常协议。这就是PostgreSQL复制连接以及诸如 pg_basebackup 这样的工具在内部使用的方式,但也可以被第三方应用程序使用。要了解复制协议的描述,请参考 第 54.4 节 。
会话与协议
对应版本的 libpq 源码声明了关键字 replication,但“参数关键字”一节并未记载它。此处保留声明作为源码证据;这不代表…连接参数 · 会话与协议
require_auth指定客户端要求服务器采用的认证方法。如果服务器没有使用所要求的方法来认证客户端,或者服务器没有完整完成认证握手,则连接将失败。也可以提供一个以逗号分隔的方法列表,此时服务器必须恰好使用其中一种方法,连接才会成功。默认情况下接受任意认证方法,并且服务器也可以完全跳过认证。
身份认证
require_auth
客户端库 libpq 16.15
手册定义 手册已记载
源码中的环境变…连接参数 · 身份认证
更多结果
输入名称或关键词,从 PostgreSQL 手册与扩展目录中直接找到定义。
pg17: 限定版本 ex: 只搜扩展 ↑↓ 选择 ↵ 打开