PostgreSQL 文档检索

NFS章节正文PG1818.2.2.1. NFS 可以使用 NFS 文件系统存放 PostgreSQL 数据目录。PostgreSQL不会对NFS文件系统作任何特殊处理，这意味着它假定NFS的行为与本地直连磁盘完全一致。PostgreSQL也不会使用任何已知在NFS上行为不标准的功能，例如文件锁定。对于在PostgreSQL中使用NFS，唯一硬性要求是文件系统必须使用hard选项挂载。使用hard选…NFS normal_rand章节正文PG18F.43.1.1. normal_rand normal_rand(int numvals, float8 mean, float8 stddev) returns setof float8 normal_rand 生成一组正态分布（高斯分布）的随机值。numvals 是该函数要返回的值的个数。mean 是这些值所服从的正态分布的均值，stddev 是这些值所服从的正态分布的标…normal_rand NOT IN章节正文PG189.24.3. NOT IN expression NOT IN (subquery) 右手边是一个圆括号括起来的子查询，它必须恰好返回一列。左手边表达式会被求值，并与子查询结果逐行比较。如果只找到不相等的子查询行（包括子查询不返回任何行的情况），那么NOT IN的结果是“真”。如果找到任何相等行，则结果为“假”。请注意，如果左侧表达式得到空值，或者右侧没有相等的值且至少有一行…NOT IN NOT IN章节正文PG189.25.2. NOT IN expression NOT IN (value [, ...]) 右侧是一个用圆括号括起来的表达式列表。如果左侧表达式的结果与右侧所有表达式的结果都不相等，则结果为“真”。这等价于以下写法：expression <> value1 AND expression <> value2 AND ... 请注意如果左手边表达式得到空值，或者没有相等的右手…NOT IN NOTIFY章节正文PG18NOTIFY NOTIFY — 发出一个通知大纲 NOTIFY channel [ , payload ]NOTIFY NULL “约束”章节正文PG18NULL “约束” NULL “约束”（实际上并不是约束）是 PostgreSQL 对 SQL 标准的扩展；提供它是为了与其他一些数据库系统兼容（以及与 NOT NULL 约束保持对称）。由于它本来就是任意列的默认情况，所以它的存在只是噪声。NULL “约束” NULL 处理章节正文PG18F.26.8.2. NULL 处理按照 SQL 的标准，只要任一参数为 NULL，所有函数都返回 NULL。这在使用不慎时可能带来安全风险。NULL 处理 NULLIF章节正文PG189.18.3. NULLIF NULLIF(value1, value2) 当value1和value2相等时，NULLIF返回 null。否则它返回value1。这可以用于执行前文给出的COALESCE示例的逆操作：SELECT NULLIF(value, '(none)') ... 在这个示例中，如果value是(none)，将返回 null，否则返回value的值。这两个…NULLIF numeric 类型章节正文PG1834.6.2. numeric 类型 numeric 类型支持任意精度计算。PostgreSQL服务器中的等效类型见第 8.1 节。为了支持任意精度，这类变量需要能够动态扩展和收缩。因此，numeric 变量只能在堆上创建，并通过PGTYPESnumeric_new和PGTYPESnumeric_free函数管理。decimal 类型与之相似，但精度有限，既可以在栈上创建，也可…numeric 类型 numeric, decimal章节正文PG1834.4.4.2.3. numeric, decimal numeric和decimal类型的处理类似于interval类型：需要定义一个指针、在堆上分配一些内存空间并且使用 pgtypes 库函数访问该变量。关于 pgtypes 库函数的更多细节，请参考第 34.6 节。pgtypes 库没有特别为decimal类型提供函数。一个应用必须使用一个 pgtypes 库函数把它转…numeric, decimal OAuth 授权/认证章节正文PG1820.15. OAuth 授权/认证 OAuth 2.0 是一个行业标准框架，定义见 RFC 6749，它允许第三方应用获得对受保护资源的受限访问。在构建 PostgreSQL 时必须启用 OAuth 客户端支持；详见第 17 章。本文档在讨论 OAuth 生态系统时使用下列术语：资源所有者（或终端用户） 拥有受保护资源并能够授予访问权限的用户或系统。当资源所有者是人时，本文档…OAuth 授权/认证 OAuth 支持章节正文PG1832.20. OAuth 支持 libpq通过一个可选模块实现了对 OAuth v2 设备授权客户端流程的支持，该流程记录在 RFC 8628中。关于如何启用内置的设备授权流程，请参见安装文档。当启用支持并安装该可选模块后，如果服务器在认证期间请求 Bearer 令牌，libpq默认会使用内置流程。即使运行客户端应用的系统没有可用的 Web 浏览器，例如通过SSH运行客户端时，…OAuth 支持 OAuth 验证器回调章节正文PG1850.3. OAuth 验证器回调 OAuth 验证器模块通过定义一组回调来实现其功能。服务器会按需调用这些回调，以处理来自用户的认证请求。OAuth 验证器回调 OAUTHBEARER 认证章节正文PG1854.3.2. OAUTHBEARER 认证 OAUTHBEARER 是一种基于令牌的联合认证机制。其详细说明见 RFC 7628。典型交互取决于客户端是否已为当前用户缓存 Bearer 令牌。如果没有，交互将通过两次连接完成：第一次“发现”连接从服务器获取 OAuth 元数据，第二次连接在客户端取得令牌后发送该令牌。（libpq 的内置流程目前没有实现缓存方法，因此使用两次连…OAUTHBEARER 认证 OID 分配章节正文PG1868.2.2. OID 分配出现在初始数据中的目录行，可以通过写一个 oid => nnnn 元数据字段来手工指定 OID。此外，如果已经指定了 OID，还可以通过写一个 oid_symbol => name 元数据字段，为该 OID 创建一个 C 宏。如果其他预装载行中有对某个预装载目录行的 OID 引用，那么该行就必须预先分配 OID。如果该行的 OID 需要在 C 代码中…OID 分配 OID 引用查找章节正文PG1868.2.3. OID 引用查找原则上，一个初始目录行到另一个初始目录行的交叉引用，只要在引用字段中写入被引用行预先分配的 OID 即可。不过，这违反项目策略，因为这样容易出错、难以阅读，而且如果新分配的 OID 被重新编号，也很容易失效。因此，genbki.pl 提供了使用符号引用的机制。规则如下：在某个特定目录列上启用符号引用的方法，是在该列定义后附加 BKI_LOOKUP…OID 引用查找 oid2name章节正文PG18oid2name oid2name — 解析 PostgreSQL 数据目录中的 OID 和文件节点大纲 oid2name [option...]oid2name ON CONFLICT 子句章节正文PG18ON CONFLICT 子句可选的ON CONFLICT子句指定一种替代动作，用来替代抛出唯一约束或排他约束违背错误。对于每一条拟插入的行，要么插入继续进行；要么如果违反了由conflict_target 指定的某个仲裁约束或索引，就执行替代的 conflict_action。ON CONFLICT DO NOTHING的替代动作只是跳过该行的插入。ON CONFLICT DO…ON CONFLICT 子句 ONLY与继承章节正文PG18ONLY与继承 SQL 标准要求在使用ONLY时用圆括号括起表名，例如SELECT * FROM ONLY (tab1), ONLY (tab2) WHERE ...。PostgreSQL认为这些圆括号是可选的。PostgreSQL允许在末尾写上*，显式指定包含子表的非ONLY行为。标准不允许这种写法。（这些要点同样适用于所有支持ONLY选项的 SQL 命令。）ONLY与继承 OPEN章节正文PG18OPEN OPEN — 打开一个动态游标大纲 OPEN cursor_name OPEN cursor_name USING value [, ... ] OPEN cursor_name USING SQL DESCRIPTOR descriptor_nameOPEN OPEN FOR EXECUTE章节正文PG1841.7.2.2. OPEN FOR EXECUTE OPEN unbound_cursorvar [ [ NO ] SCROLL ] FOR EXECUTE query_string [ USING expression [, ... ] ]; 该游标变量会被打开，并被赋予要执行的指定查询。该游标不能已经处于打开状态，并且必须已被声明为未绑定游标变量（即，一个简单的refcu…OPEN FOR EXECUTE OPEN FOR query章节正文PG1841.7.2.1. OPEN FOR query OPEN unbound_cursorvar [ [ NO ] SCROLL ] FOR query; 该游标变量会被打开，并被赋予要执行的指定查询。该游标不能已经处于打开状态，并且它必须已被声明为未绑定游标变量（即，一个简单的refcursor变量）。该查询必须是SELECT，或其他会返回行的命令（例如EXPLAIN）。该查询…OPEN FOR query OpenSSL 支持函数章节正文PG18F.26.6. OpenSSL 支持函数 fips_mode() returns boolean 如果OpenSSL正在以 FIPS 模式运行，则返回true；否则返回false。OpenSSL 支持函数 OpenSSL 配置章节正文PG1818.9.2. OpenSSL 配置 PostgreSQL会读取系统范围的OpenSSL配置文件。默认情况下，该文件名为openssl.cnf，位于openssl version -d报告的目录中。可以通过把环境变量OPENSSL_CONF设为所需配置文件的名称，覆盖这一默认值。OpenSSL支持种类繁多、强度不一的密码套件和认证算法。虽然可以在OpenSSL配置文件中指定密码…OpenSSL 配置 Oracle 兼容模式章节正文PG1834.16. Oracle 兼容模式 ecpg可以在所谓的Oracle兼容模式下运行。如果此模式激活，它会尝试表现得好像它是Oracle的Pro*C。具体来说，此模式以三种方式更改ecpg：在接收字符串类型数据的字符数组末尾填充空格，直至指定长度 以零字节终止这些字符数组，并在截断发生时设置指示符变量 当字符数组接收空字符串时，将空值指示符设为-1Oracle 兼容模式 ORDER BY 子句章节正文PG18ORDER BY 子句可选的ORDER BY子句的形式如下：ORDER BY expression [ ASC | DESC | USING operator ] [ NULLS { FIRST | LAST } ] [, ...] ORDER BY子句导致结果行被按照指定的表达式排序。如果两行按照最左边的表达式是相等的，则会根据下一个表达式比较它们，依次类推。如果按照所有指定…ORDER BY 子句 pageinspect — 数据库页的底层检查章节正文PG18F.23. pageinspect — 数据库页的底层检查 pageinspect模块提供了一组函数，允许你在底层检查数据库页的内容，这对调试很有帮助。所有这些函数都只能由超级用户使用。pageinspect — 数据库页的底层检查 PAM 认证章节正文PG1820.13. PAM 认证这种认证方法的工作方式与 password 类似，只不过它使用 PAM（可插拔认证模块）作为认证机制。默认的 PAM 服务名是 postgresql。PAM 只用于验证用户名/密码对，以及可选地验证已连接远程主机的主机名或 IP 地址。因此，在使用 PAM 进行认证之前，用户必须已经存在于数据库中。关于 PAM 的更多信息，请阅读 Linux-PAM …PAM 认证 parameters章节正文PG1835.33. parameters 视图parameters包含当前数据库中所有函数的参数的有关信息。只有那些当前用户能够访问（作为拥有者或具有某些权限）的函数才会被显示。表 35.31. parameters 列 列类型 描述 specific_catalog sql_identifier 包含该函数的数据库名称（总是当前数据库） specific_schema sql_id…parameters PARTITION BY 子句章节正文PG18PARTITION BY 子句 PARTITION BY 子句是 PostgreSQL 的扩展。PARTITION BY 子句 PARTITION OF 子句章节正文PG18PARTITION OF 子句 PARTITION OF 子句是 PostgreSQL 的扩展。PARTITION OF 子句 passwordcheck — 验证密码强度章节正文PG18F.24. passwordcheck — 验证密码强度每当通过CREATE ROLE或ALTER ROLE设置用户密码时，passwordcheck模块都会检查密码强度。如果密码被认为过弱，就会被拒绝，该命令也会因错误而终止。要启用该模块，请将'$libdir/passwordcheck'加入 postgresql.conf中的shared_preload_libraries…passwordcheck — 验证密码强度 PDF章节正文PG18J.3.3. PDF 要使用FOP生成文档的 PDF 版本，可根据所偏好的纸张格式使用下列命令之一：对于 A4 格式： doc/src/sgml$ make postgres-A4.pdf 对于美国信纸格式： doc/src/sgml$ make postgres-US.pdf 由于 PostgreSQL 文档相当庞大，FOP需要占用相当多的内存。因此，在某些系统上，构建会因内…PDF Peer 认证章节正文PG1820.9. Peer 认证 Peer 认证通过从内核获取客户端的操作系统用户名，并把它用作被允许的数据库用户名（可结合可选的用户名映射）来工作。这种方法只支持本地连接。peer 支持下列配置选项：map # 允许在系统用户名和数据库用户名之间进行映射。详见第 20.2 节。Peer 认证只在提供 getpeereid() 函数、SO_PEERCRED 套接字参数或类似机制的操作…Peer 认证 pg_aggregate章节正文PG1852.2. pg_aggregate 目录pg_aggregate存储关于聚合函数的信息。聚合函数是对一组值（典型的是每个匹配查询条件的行中的同一个列的值）进行操作的函数，它返回从这些值中计算出的单个值。典型的聚合函数是 sum、count和max。pg_aggregate里的每个项都是一个pg_proc项的扩展。pg_proc项记载该聚合的名字、输入和输出数据类型，以及其他一…pg_aggregate pg_aios章节正文PG1853.2. pg_aios pg_aios 视图列出当前正在使用的全部异步 I/O句柄。I/O 句柄用于引用正在准备、执行或处于完成过程中的 I/O 操作。pg_aios 为每个 I/O 句柄提供一行。该视图主要对 PostgreSQL 开发者有用，但在调优 PostgreSQL 时也可能有帮助。表 53.2. pg_aios 列 列类型 描述 pid int4 发起该 I/O…pg_aios pg_am章节正文PG1852.3. pg_am 目录pg_am存储关于关系访问方法的信息。系统支持的每种访问方法在这个目录中都有一行。目前只有表和索引拥有访问方法。表和索引访问方法的需求分别在第 62 章和第 63 章中详细讨论。表 52.3. pg_am 列 列类型 描述 oid oid 行标识符 amname name 访问方法的名字 amhandler regproc（引用 pg_proc.oi…pg_am pg_amcheck章节正文PG18pg_amcheck pg_amcheck — 检查一个或多个PostgreSQL数据库中的损坏情况大纲 pg_amcheck [option...] [dbname]pg_amcheck pg_amop章节正文PG1852.4. pg_amop 目录pg_amop存储关于与访问方法操作符族相关的操作符信息。对于操作符族中的每个成员操作符，此目录中都有一行。一个成员可以是搜索操作符，也可以是排序操作符。一个操作符可以出现在多个族中，但在同一个族中既不能出现在多个搜索位置，也不能出现在多个排序位置（虽然不太可能，但允许一个操作符同时用于搜索和排序）。表 52.4. pg_amop 列 列类型 描…pg_amop pg_amproc章节正文PG1852.5. pg_amproc 目录pg_amproc存储与访问方法操作符族相关的支持函数的信息。属于一个操作符族的每一个支持函数在这个目录中都有一行。表 52.5. pg_amproc 列 列类型 描述 oid oid 行标识符 amprocfamily oid（引用 pg_opfamily.oid） 此项所属的操作符族 amproclefttype oid（引用 pg_ty…pg_amproc