PostgreSQL 文档检索

半内部选项章节正文PG18半内部选项这里描述的选项主要用于调试，并且在某些情况下可协助恢复严重损坏的数据库。在生产数据库环境中没有理由使用它们。这里列出这些选项，仅供 PostgreSQL 系统开发者使用。此外，这些选项在未来版本中可能会更改或被移除，且不另行通知。-f { s | i | o | b | t | n | m | h } 禁止使用某些扫描和连接方法：s 和 i 分别禁用顺序扫描和索引扫描…半内部选项 协议版本章节正文PG1854.1.4. 协议版本当前最新协议版本为 3.2。不过，为了兼容尚不支持版本协商的旧服务器和中间件，libpq 默认仍使用 3.0。单个服务器可以支持多个协议版本。初始启动请求消息会告诉服务器客户端尝试使用的协议版本。如果客户端请求的主版本服务器不支持，则连接会被拒绝（例如客户端请求 4.0，而截至本文编写时并不存在该版本）。如果客户端请求的次版本服务器不支持（例如客户端请求…协议版本 单一行比较章节正文PG189.24.6. 单一行比较 row_constructor operator (subquery) 左侧是一个行构造器，如第 4.2.13 节所述。右侧是一个用圆括号括起来的子查询，必须返回与左侧行中表达式数量完全相同的列数。此外，该子查询不能返回超过一行；如果它返回零行，则结果为空值。对左侧求值后，将所得的行与子查询返回的唯一一行进行比较。关于行构造器比较的详细含义请见第 9…单一行比较 单列统计信息章节正文PG1814.2.1. 单列统计信息如上一节所见，查询规划器需要估计查询将检索多少行，才能对查询计划做出良好选择。本节简要介绍系统用于这些估计的统计信息。统计信息的一部分，是每个表和索引中的项总数，以及每个表和索引占用的磁盘块数。这些信息保存在 pg_class 表的 reltuples 和 relpages 列中。可以用类似下面的查询查看这些信息：SELECT relname, re…单列统计信息 单用户模式章节正文PG18单用户模式要启动单用户模式服务器，可以使用类似下面的命令：postgres --single -D /usr/local/pgsql/data other-options my_database 使用 -D 提供正确的数据库目录路径，或者确保已经设置了环境变量 PGDATA。还要指定你想要操作的那个数据库的名称。通常，单用户模式服务器将换行视为命令输入终止符；它不像 psql …单用户模式 历法的历史章节正文PG18B.6. 历法的历史 SQL 标准指出，“在‘日期时间字面量’的定义中，‘日期时间值’受格里高利历中日期和时间自然规则的约束”。PostgreSQL 遵循 SQL 标准的做法，即便对于该历法尚未实际使用之前的年份，也完全按照格里高利历计算日期。这一规则称为外推格里高利历。儒略历由 Julius Caesar 于公元前 45 年引入。在 1582 年各国开始改用格里高利历之前，它…历法的历史 压缩的归档日志章节正文PG1825.3.7.2. 压缩的归档日志如果归档存储的大小是个问题，你可以使用 gzip 来压缩归档文件：archive_command = 'gzip < %p > /mnt/server/archivedir/%f.gz' 那么在恢复时就需要使用 gunzip：restore_command = 'gunzip < /mnt/server/archivedir/%f.gz > %…压缩的归档日志 原始加密函数章节正文PG18F.26.4. 原始加密函数这些函数只是对数据应用密码算法；它们不具备 PGP 加密的任何高级特性。因此存在一些严重问题：它们直接把用户提供的密钥用作密码算法的密钥。 它们不提供任何完整性检查，无法判断加密数据是否被修改。 它们希望用户自己管理所有加密参数，甚至是 IV。 它们无法处理文本。因此，在引入 PGP 加密之后，不建议使用原始加密函数。encrypt(data byt…原始加密函数 原理章节正文PG18F.9.1. 原理在 PostgreSQL 中进行大小写不敏感匹配的标准方法，一直是在比较值时使用 lower 函数，例如：SELECT * FROM tab WHERE lower(col) = LOWER(?); 这种做法效果尚可，但有几个缺点：它会让 SQL 语句变得冗长，而且你必须时刻记得同时对列和查询值调用 lower。 除非你创建一个使用 lower 的函数索引，否…原理 原理章节正文PG18F.21.1. 原理 JDBC 驱动的一个问题是（ODBC 驱动也受此影响），其规范假定对 BLOB（二进制大对象）的引用存储在表内，并且如果该表项被更改，相关的 BLOB 就会从数据库中删除。但在目前的 PostgreSQL 中并非如此。大对象被视为独立对象；表中的一个项可以通过 OID 引用某个大对象，但也可能有多个表项引用同一个大对象 OID，因此系统不会仅因你更改或删除…原理 原理章节正文PG18F.39.1. 原理测量值的几何形态通常比数值连续体中的一个点更复杂。一次测量通常是该连续体上的一段，其边界多少有些模糊。测量结果之所以会呈现为区间，一方面是由于不确定性和随机性，另一方面也是因为被测值本身可能天然就是表示某种状态的区间，例如蛋白质的稳定温度范围。凭常识也能看出，把这类数据存储为区间比存储为一对数字更方便。实际上，在大多数应用中，这样做甚至更高效。再顺着这一常识…原理 去重章节正文PG1865.1.4.3. 去重重复项是这样一种叶页元组（即指向表中行的元组）：其中所有被索引的键列值，都与同一索引中至少另一个叶页元组对应列的值相匹配。重复元组在实践中相当常见。当启用一种可选技术时，B-树索引可以为重复项采用一种特殊且节省空间的表示形式：去重。去重通过周期性地把一组组重复元组合并起来，为每一组形成一个倒排列表元组。在这种表示中，列键值只出现一次，后面跟着一个排好序的…去重 参数章节正文PG18参数 Size size 要分配的存储空间大小（以字节计）参数 参数章节正文PG18参数 connname # 要使用的连接名称。参数 参数章节正文PG18参数 connname # 要使用的连接名称；省略该参数则使用未命名连接。 cursorname # 要关闭的游标名。 fail_on_error # 如果为真（省略时默认），则连接远程端抛出的错误也会在本地抛出。如果为假，远程端错误会在本地报告为一个 NOTICE，并且该函数的返回值会被设为 ERROR。参数 参数章节正文PG18参数 connname # 要关闭的命名连接名称。参数 参数章节正文PG18参数 connname # 要使用的连接名称。参数 参数章节正文PG18参数 connname # 要使用的连接名称；省略该参数则使用未命名连接。 connstr # 如前面对 dblink_connect 所描述的连接信息字符串。 sql # 要在远程数据库中执行的 SQL 命令，例如 insert into foo values(0, 'a', '{"a0","b0","c0"}')。 fail_on_error # 如果为真（省略时默认），则…参数 参数章节正文PG18参数 connname # 要使用的连接名称；省略该参数则使用未命名连接。 cursorname # 要从中提取数据的游标名称。 howmany # 要检索的最大行数。从当前游标位置开始，向前提取接下来的 howmany 行。一旦游标到达末尾，就不会再产生更多行。 fail_on_error # 如果为真（省略时默认），则连接远程端抛出的错误也会在本地抛出。如果为假，远程端错误…参数 参数章节正文PG18参数 relname # 本地关系的名称，例如 foo 或 myschema.mytab。如果该名称是大小写混合的或包含特殊字符，则应包含双引号，例如 "FooBar"；如果没有引号，字符串将被折叠为小写形式。参数 参数章节正文PG18参数 connname # 要检查的连接名称。参数 参数章节正文PG18参数 relname # 本地关系的名称，例如 foo 或 myschema.mytab。如果该名称是大小写混合的或包含特殊字符，则应包含双引号，例如 "FooBar"；如果没有引号，字符串将被折叠为小写形式。 primary_key_attnums # 主键字段的属性编号（从 1 开始），例如 1 2。 num_primary_key_atts # 主键字段数量。 tgt_p…参数 参数章节正文PG18参数 relname # 本地关系的名称，例如 foo 或 myschema.mytab。如果该名称是大小写混合的或包含特殊字符，则应包含双引号，例如 "FooBar"；如果没有引号，字符串将被折叠为小写形式。 primary_key_attnums # 主键字段的属性编号（从 1 开始），例如 1 2。 num_primary_key_atts # 主键字段数量。 src_p…参数 参数章节正文PG18参数 relname # 本地关系的名称，例如 foo 或 myschema.mytab。如果该名称是大小写混合的或包含特殊字符，则应包含双引号，例如 "FooBar"；如果没有引号，字符串将被折叠为小写形式。 primary_key_attnums # 主键字段的属性编号（从 1 开始），例如 1 2。 num_primary_key_atts # 主键字段数量。 src_p…参数 参数章节正文PG18参数 connname # 要使用的连接名称；省略该参数则使用未命名连接。 connstr # 如前面对 dblink_connect 所描述的连接信息字符串。 sql # 要在远程数据库中执行的 SQL 查询，例如 select * from foo。 fail_on_error # 如果为真（省略时默认），则连接远程端抛出的错误也会在本地抛出。如果为假，远程端错误会在本地报…参数 参数章节正文PG18参数 connname # 要使用的连接名称。 fail_on_error # 如果为真（省略时默认），则连接远程端抛出的错误也会在本地抛出。如果为假，远程端错误会在本地报告为一个 NOTICE，并且该函数不返回任何行。参数 参数章节正文PG18参数 connname # 要使用的连接名称；省略该参数则使用未命名连接。 cursorname # 要分配给该游标的名称。 sql # 要在远程数据库中执行的 SELECT 语句，例如 select * from pg_class。 fail_on_error # 如果为真（省略时默认），则连接远程端抛出的错误也会在本地抛出。如果为假，远程端错误会在本地报告为一个 NOTIC…参数 参数章节正文PG18参数 HeapTuple row 要复制的行参数 参数章节正文PG18参数 const char * name 该 portal 的名称参数 参数章节正文PG18参数 const char * command 命令字符串 const SPIExecuteOptions * options 包含可选参数的结构体调用者应始终先将整个 options 结构体清零，然后再填写想设置的字段。这样可以保证代码的前向兼容性，因为未来添加到该结构体中的任何字段，都会被定义为在取零值时保持向后兼容。当前可用的 options 字段如下：ParamList…参数 参数章节正文PG18参数 const char * command 命令字符串 int nargs 输入参数的数量（$1、$2 等） Oid * argtypes 一个长度为 nargs 的数组，包含参数数据类型的 OID Datum * values 一个长度为 nargs 的数组，包含实际参数值 const char * nulls 一个长度为 nargs 的数组，用于描述哪些参数为空值 如果…参数 参数章节正文PG18参数 const char * command 包含待执行命令的字符串 bool read_only true 表示只读执行 long count 要返回的最大行数，或者用 0 表示不限制参数 参数章节正文PG18参数 TupleDesc rowdesc 输入行描述 int colnumber 列号（从 1 开始计）参数 参数章节正文PG18参数 SPITupleTable * tuptable 要释放的结果行集指针，或传入 NULL 表示不执行任何操作参数 参数章节正文PG18参数 HeapTuple row 要检查的输入行 TupleDesc rowdesc 输入行描述 int colnumber 列号（从 1 开始计） bool * isnull 列中是否为空值的标志参数 参数章节正文PG18参数 Relation rel 输入关系参数 参数章节正文PG18参数 const char * command 命令字符串 int nargs 输入参数的数量（$1、$2 等） Oid * argtypes 一个数组指针，它指向的数组包含参数的数据类型的 OID int cursorOptions 整数形式的游标选项位掩码，零会导致默认行为参数 参数章节正文PG18参数 const char * command 命令字符串 const SPIPrepareOptions * options 包含可选参数的结构体调用者应始终先将整个 options 结构体清零，然后再填写想设置的字段。这样可以保证代码的前向兼容性，因为未来添加到该结构体中的任何字段，都会被定义为在取零值时保持向后兼容。当前可用的 options 字段如下：ParserSet…参数 参数章节正文PG18参数 const char * command 命令字符串 ParserSetupHook parserSetup 解析器钩子设置函数 void * parserSetupArg 传递给 parserSetup 的透传参数 int cursorOptions 整数形式的游标选项位掩码，零会导致默认行为参数 参数章节正文PG18参数 EphemeralNamedRelation enr 临时命名关系的注册表项参数