PostgreSQL 文档检索

ssl_max_protocol_version连接参数本站词条指定连接允许使用的最高 SSL/TLS 协议版本。有效值为 TLSv1、TLSv1.1、TLSv1.2 和 TLSv1.3。支持哪些协议取决于所用 OpenSSL 版本，旧版本不支持最新协议。未设置时忽略此参数；如果后端定义了版本上限，则使用该上限。限制最高协议版本主要用于测试，或某个组件无法正常使用较新协议的场景。 TLS ssl_max_protocol_version …连接参数 · TLS ssl_min_protocol_version配置参数本站词条设置允许使用的最低 SSL/TLS 协议版本。 Sets the minimum SSL/TLS protocol version to use. ssl_min_protocol_version 定义允许使用的最低 SSL/TLS 协议版本。 ssl_min_protocol_version：设置允许使用的最低 SSL/TLS 协议版本。协商版本低于下限的连接会被拒绝；上游默…配置参数 · 连接和认证 / SSL ssl_min_protocol_version连接参数本站词条指定连接允许使用的最低 SSL/TLS 协议版本。有效值为 TLSv1、TLSv1.1、TLSv1.2 和 TLSv1.3。支持哪些协议取决于所用 OpenSSL 版本，旧版本不支持最新协议。未指定时默认为 TLSv1.2，符合本文撰写时的行业最佳实践。 TLS ssl_min_protocol_version 客户端库 libpq 13.23 手册定义 手册已记载 源码中的…连接参数 · TLS ssl_passphrase_command配置参数本站词条设置用于获取 SSL 私钥口令的命令。 Command to obtain passphrases for SSL. ssl_passphrase_command 定义用于获取 SSL 私钥口令的命令。 ssl_passphrase_command 是 PostgreSQL 需要解密加密私钥等 SSL 文件时调用的外部助手。助手必须把口令写到标准输出并以状态零退出；Postgr…配置参数 · 连接和认证 / SSL ssl_passphrase_command_supports_reload配置参数本站词条控制重新加载服务器配置时是否调用 ssl_passphrase_command。 Controls whether "ssl_passphrase_command" is called during server reload. ssl_passphrase_command_supports_reload 是 PostgreSQL 中用于控制重新加载服务器配置时是否调用 ssl…配置参数 · 连接和认证 / SSL ssl_prefer_server_ciphers配置参数本站词条优先采用服务器端的密码套件顺序。 Give priority to server ciphersuite order. ssl_prefer_server_ciphers 是 PostgreSQL 中用于优先采用服务器端的密码套件顺序的参数。 ssl_prefer_server_ciphers：优先采用服务器端的密码套件顺序。它只影响 TLS 1.2 及更低版本采用服务器还是客…配置参数 · 连接和认证 / SSL ssl_renegotiation_limit配置参数本站词条设置重新协商加密密钥前允许收发的流量。 Set the amount of traffic to send and receive before renegotiating the encryption keys. ssl_renegotiation_limit：设置重新协商加密密钥前允许收发的流量。实测在档范围为 PG9.0–9.4；最后在档的 PG9.4 启动默认值为 0 …配置参数 · 连接和认证 / 安全和认证 ssl_sni配置参数本站词条设置是否解释 SSL 连接中的 SNI 扩展。 Sets whether to interpret SNI extensions in SSL connections. ssl_sni：设置是否解释 SSL 连接中的 SNI 扩展。实测在档范围为 PG19 Beta 4；最后在档的 PG19 Beta 4 启动默认值为 off，context 为 sighup。这是测试版快照事…配置参数 · 连接和认证 / SSL ssl_tls13_ciphers配置参数本站词条设置 TLS 1.3 允许使用的密码套件列表。 Sets the list of allowed TLSv1.3 cipher suites. ssl_tls13_ciphers 定义 TLS 1.3 允许使用的密码套件列表。 ssl_tls13_ciphers：设置 TLS 1.3 允许使用的密码套件列表。空值把 TLS 1.3 套件选择交给 SSL 库默认值，其语法也不同于…配置参数 · 连接和认证 / SSL sslcert连接参数本站词条指定客户端 SSL 证书的文件名，代替默认的 ~/.postgresql/postgresql.crt。未建立 SSL 连接时，此参数被忽略。 TLS sslcert 客户端库 libpq 10.23 手册定义 手册已记载 源码中的环境变量回退 PGSSLCERT 编译时回退表达式 NULL 默认值解析与服务文件优先级 以下环境变量可用于选择连接参数的默认值，供 PQconn…连接参数 · TLS sslcertmode连接参数本站词条此选项决定是否可以向服务器发送客户端证书，以及服务器是否必须请求客户端证书。共有三种模式： TLS sslcertmode 客户端库 libpq 16.15 手册定义 手册已记载 源码中的环境变量回退 PGSSLCERTMODE 编译时回退表达式 NULL 默认值解析与服务文件优先级 以下环境变量可用于选择连接参数的默认值，供 PQconnectdb 、 PQsetdbLog…连接参数 · TLS sslcompression连接参数本站词条设为 1 时，对 SSL 连接上传输的数据进行压缩；设为 0 时禁用压缩。默认值为 0。未使用 SSL 连接时，此参数被忽略。 TLS 设为 1（默认值）时，对 SSL 连接上传输的数据进行压缩；设为 0 时禁用压缩，后者要求 OpenSSL 1.0.0 或更新版本。未使用 SSL 连接，或所用 OpenSSL 版本不支持此功能时，此参数被忽略。 sslcompression…连接参数 · TLS sslcrl连接参数本站词条指定 SSL 服务器证书吊销列表（CRL）的文件名。如果文件存在，其中列出的证书将在认证服务器证书时被拒绝。如果 sslcrl 和 sslcrldir 均未设置，则使用 ~/.postgresql/root.crl。 TLS 指定 SSL 服务器证书吊销列表（CRL）的文件名。如果文件存在，其中列出的证书将在认证服务器证书时被拒绝。默认为 ~/.postgresql/root…连接参数 · TLS sslcrldir连接参数本站词条指定 SSL 服务器证书吊销列表（CRL）的目录名。如果目录存在，其中各文件列出的证书将在认证服务器证书时被拒绝。 TLS sslcrldir 客户端库 libpq 14.24 手册定义 手册已记载 源码中的环境变量回退 PGSSLCRLDIR 编译时回退表达式 NULL 默认值解析与服务文件优先级 以下环境变量可用于选择连接参数的默认值，供 PQconnectdb 、 PQ…连接参数 · TLS sslinfo扩展与模块PG18F.42. sslinfo — 获取客户端 SSL 信息 sslinfo 模块提供关于当前客户端在连接到 PostgreSQL 时所提供 SSL 证书的信息。如果当前连接没有使用 SSL，则该模块没有用处（大多数函数将返回 NULL）。通过本模块可获得的部分信息，也可以使用内置系统视图 pg_stat_ssl 获得。如果安装时没有配置 --with-ssl=openssl，则该…sslinfo — 获取客户端 SSL 信息 sslinfo — 获取客户端 SSL 信息章节正文PG18F.42. sslinfo — 获取客户端 SSL 信息 sslinfo 模块提供关于当前客户端在连接到 PostgreSQL 时所提供 SSL 证书的信息。如果当前连接没有使用 SSL，则该模块没有用处（大多数函数将返回 NULL）。通过本模块可获得的部分信息，也可以使用内置系统视图 pg_stat_ssl 获得。如果安装时没有配置 --with-ssl=openssl，则该…sslinfo — 获取客户端 SSL 信息 sslkey连接参数本站词条指定客户端证书私钥的位置。可以是文件名，代替默认的 ~/.postgresql/postgresql.key；也可以指定来自外部引擎的密钥，引擎是 OpenSSL 的可加载模块。外部引擎的指定格式是引擎名与引擎专用密钥标识符，两者用冒号分隔。未建立 SSL 连接时，此参数被忽略。 TLS sslkey 客户端库 libpq 10.23 手册定义 手册已记载 源码中的环境变量回…连接参数 · TLS sslkeylogfile连接参数本站词条这个参数指定 libpq 记录此 SSL 上下文所用密钥的位置。这对于调试 PostgreSQL 协议交互，或者借助 Wireshark 之类的网络检查工具分析客户端连接很有用。如果未建立 SSL 连接，或者使用的是 LibreSSL （其不支持密钥记录），则会忽略此参数。密钥将按 NSS 格式记录。 TLS sslkeylogfile 客户端库 libpq 18.6 手册定…连接参数 · TLS sslmode连接参数本站词条决定是否与服务器协商安全的 SSL TCP/IP 连接，以及协商时的优先级。共有六种模式： TLS sslmode 客户端库 libpq 10.23 手册定义 手册已记载 源码中的环境变量回退 PGSSLMODE 编译时回退表达式 DefaultSSLMode 默认值解析与服务文件优先级 以下环境变量可用于选择连接参数的默认值，供 PQconnectdb 、 PQsetdbL…连接参数 · TLS sslnegotiation连接参数本站词条使用 SSL 时，此选项控制与服务器协商 SSL 加密的方式。默认 postgres 模式下，客户端先询问服务器是否支持 SSL；direct 模式下，建立 TCP/IP 连接后立即开始标准 SSL 握手。传统 PostgreSQL 协议协商对不同服务器配置的适应性最强。如果已知服务器支持直接 SSL 连接，则 direct 可减少一次往返，降低连接延迟，还可使用不识别 Pos…连接参数 · TLS SslOpenServer等待事件本站词条在尝试连接时等待SSL。 Waiting for SSL while attempting connection. `WAIT_EVENT_SSL_OPEN_SERVER` 位于 `src/backend/libpq/be-secure-openssl.c:508`，是经 grep 核验的报告路径。公共身份/资源映射位于 `src/backend/utils/activity/…客户端 · 等待事件 sslpassword连接参数本站词条指定 sslkey 所指私钥的密码，使客户端证书私钥即使在不便交互输入密码时，也能以加密形式存储在磁盘上。 TLS sslpassword 客户端库 libpq 13.23 手册定义 手册已记载 源码中的环境变量回退 选项表中未声明 编译时回退表达式 NULL 默认值解析与服务文件优先级 以下环境变量可用于选择连接参数的默认值，供 PQconnectdb 、 PQsetdbL…连接参数 · TLS SSLRequest协议消息本站词条SSLRequest 是前端协议消息。消息内容长度以字节为单位，包含长度字段本身。 前端消息 SSLRequest (F) 方向 前端 → 后端 首个线上协议字段 Int32(8) 字段条目 2 手册中的交互阶段 SSL 会话加密 消息边界与重复字段 下方完整定义保留重复项、计数与条件字段。表格行号表示文档中的字段定义，并非固定字节偏移量。整数编码与交互流程以同版本协议章节为…协议消息 · 前端消息 sslrootcert连接参数本站词条指定包含 SSL 证书颁发机构（CA）证书的文件名。如果文件存在，会验证服务器证书是否由其中某个机构签发。默认为 ~/.postgresql/root.crt。 TLS sslrootcert 客户端库 libpq 10.23 手册定义 手册已记载 源码中的环境变量回退 PGSSLROOTCERT 编译时回退表达式 NULL 默认值解析与服务文件优先级 以下环境变量可用于选择…连接参数 · TLS sslsni连接参数本站词条设为 1（默认值）时，libpq 在启用 SSL 的连接上设置 TLS 的服务器名称指示（SNI）扩展；设为 0 可关闭此行为。 TLS sslsni 客户端库 libpq 14.24 手册定义 手册已记载 源码中的环境变量回退 PGSSLSNI 编译时回退表达式 "1" 默认值解析与服务文件优先级 以下环境变量可用于选择连接参数的默认值，供 PQconnectdb 、 PQ…连接参数 · TLS sslutils扩展与模块扩展目录使用SQL管理SSL证书 A Postgres extension for managing SSL certificates through SQL pgdg-flaw sslutils 安全安全 · 扩展目录 ssn扩展与模块扩展目录PostgreSQL中的SSN类型实现 SSN type implementation for PostgreSQL ssn 数据类型数据类型 · 扩展目录 sspi认证方法本站词条使用 SSPI 认证用户，仅适用于 Windows。详情参见第 20.7 节。 身份认证与访问控制 使用 SSPI 认证用户，仅适用于 Windows。详情参见第 20.3.4 节。 方法 sspi 配置 pg_hba.conf 清单 用户可见的源码认证方法 手册中的方法选项与替代方式 include_realm 如果设为 0，则在通过用户名映射（ 第 20.2 节 ）之前，…认证方法 · 身份认证与访问控制 SSPI 认证章节正文PG1820.7. SSPI 认证 SSPI 是一种用于安全认证和单点登录的 Windows 技术。PostgreSQL 将在 negotiate 模式下使用 SSPI，该模式会在可能时使用 Kerberos，并在其他情况下自动回退到 NTLM。SSPI 和 GSSAPI 作为客户端和服务器是可互操作的，例如，SSPI 客户端可以向 GSSAPI 服务器完成认证。建议在 Windows…SSPI 认证 standard_conforming_strings配置参数本站词条使普通单引号字符串中的反斜杠按字面处理。 Nonstandard strings are no longer supported; this can only be true. standard_conforming_strings：使普通单引号字符串中的反斜杠按字面处理。实测在档范围为 PG9.0–19 Beta 4；最后在档的 PG19 Beta 4 启动默认值为 on，c…配置参数 · 版本和平台兼容性 / 以前的 PostgreSQL 版本 stannum扩展与模块扩展目录提供 TINQL、BM25 与持久索引的实验性文本搜索扩展 Experimental TINQL text search with BM25 and persistent indexes text-search bm25 tinql stannum 全文检索全文检索 · 扩展目录 starrocks_fdw扩展与模块扩展目录腾讯云数据库 PostgreSQL 自研的 StarRocks 外部数据包装器，通过 MySQL 兼容接口查询 StarRocks 表。 TencentDB for PostgreSQL foreign data wrapper for querying StarRocks tables through a MySQL-compatible interface. cold-st…外部数据源 · 扩展目录 START TRANSACTIONSQL 命令与语法本站词条开始一个事务块 START TRANSACTION [ transaction_mode [, ...] ] 其中 transaction_mode 是下列之一： ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED } READ WRITE | READ …SQL 命令 · 事务控制 START TRANSACTION章节正文PG18START TRANSACTION START TRANSACTION — 开始一个事务块大纲 START TRANSACTION [ transaction_mode [, ...] ] 其中 transaction_mode 是下列之一： ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | …START TRANSACTION starts_with函数与运算符本站词条如果 string 以 prefix开始就返回真。 Returns true if string starts with prefix. starts_with ( string text, prefix text ) → boolean 字符串函数和操作符函数 · 字符串函数和操作符 StartupMessage协议消息本站词条StartupMessage 是前端协议消息。消息内容长度以字节为单位，包含长度字段本身。 前端消息 StartupMessage (F) 方向 前端 → 后端 首个线上协议字段 Int32 字段条目 8 手册中的交互阶段 取消正在执行的请求；SSL 会话加密 消息边界与重复字段 下方完整定义保留重复项、计数与条件字段。表格行号表示文档中的字段定义，并非固定字节偏移量。整数编…协议消息 · 前端消息 stat_record扩展与模块扩展目录通过后台工作进程定期保存 PostgreSQL 服务器统计快照并生成报表。 Background-worker snapshot recorder and reporting suite for PostgreSQL server statistics. background-worker monitoring pg-stat-statements snapshots stat…监控统计 · 扩展目录 statement_timeout配置参数本站词条设置单条语句允许执行的最长时间。 Sets the maximum allowed duration of any statement. statement_timeout 定义单条语句允许执行的最长时间。 statement_timeout：设置单条语句允许执行的最长时间。计时从命令到达开始；现代版本会分别计算简单查询字符串中的各条语句，扩展协议则按 Parse/Bind/E…配置参数 · 客户端连接默认值 / 语句行为 statement_timestamp函数与运算符本站词条当前日期和时间（当前语句开始时）；参见第 9.9.5 节 Current date and time (start of current statement); see Section 9.9.5 statement_timestamp ( ) → timestamp with time zone statement_timestamp() 日期/时间函数和操作符函数 · 日期/时间函数和操作符 stats_fetch_consistency配置参数本站词条设置读取累计统计信息时的一致性方式。 Sets the consistency of accesses to statistics data. stats_fetch_consistency：设置读取累计统计信息时的一致性方式。实测在档范围为 PG15–19 Beta 4；最后在档的 PG19 Beta 4 启动默认值为 cache，context 为 user。这是测试版快照…配置参数 · 运行时统计数据 / 累积查询和索引统计