PostgreSQL 文档检索

jsonb 包含与存在章节正文PG188.14.3. jsonb 包含与存在测试包含是 jsonb 的一项重要能力。对于 json 类型，则没有与之对应的一组功能。包含测试用于检查一个 jsonb 文档中是否包含另一个文档。除特别说明外，下面这些示例都返回真：-- 简单的标量/基本值只包含相同的值： SELECT '"foo"'::jsonb @> '"foo"'::jsonb; -- 左侧数组包含右侧数组： SE…jsonb 包含与存在 jsonb 索引章节正文PG188.14.4. jsonb 索引 GIN 索引可用于高效搜索大量 jsonb 文档（数据项）中出现的键或键/值对。提供了两种 GIN “操作符类”，它们在性能和灵活性之间提供不同的权衡。jsonb 的默认 GIN 操作符类支持使用键存在操作符 ?、?| 和 ?&，包含操作符 @>，以及 jsonpath 匹配操作符 @? 和 @@ 的查询。（关于这些操作符所实现语义的细节，见表…jsonb 索引 jsonpath 类型章节正文PG188.14.7. jsonpath 类型 jsonpath 类型在 PostgreSQL 中实现了对 SQL/JSON 路径语言的支持，以便高效查询 JSON 数据。它提供了解析后的 SQL/JSON 路径表达式的二进制表示，该表达式指定路径引擎应从 JSON 数据中检索哪些项，以便由 SQL/JSON 查询函数做进一步处理。SQL/JSON 路径谓词和操作符的语义通常遵循 SQ…jsonpath 类型 key_column_usage章节正文PG1835.32. key_column_usage 视图key_column_usage标识当前数据库中所有被某种唯一、主键或外键约束限制的列。检查约束不被包括在这个视图中。只有那些当前用户能够访问的列才会被显示（作为拥有者或具有某些权限）。表 35.30. key_column_usage 列 列类型 描述 constraint_catalog sql_identifier 包含…key_column_usage LATERAL子查询章节正文PG187.2.1.5. LATERAL子查询可以在出现于FROM中的子查询前放置关键词LATERAL。这允许它们引用前面的FROM项提供的列（如果没有LATERAL，每一个子查询将被独立计算，并且因此不能交叉引用其他FROM项）。出现在FROM中的表函数的前面也可以被放上关键词LATERAL，但对于函数该关键词是可选的，在任何情况下函数的参数都可以包含对前面的FROM项提供的列的引用…LATERAL子查询 LDAP 认证章节正文PG1820.10. LDAP 认证这种认证方法的工作方式与 password 类似，只不过它使用 LDAP 作为密码验证方法。LDAP 只用于验证用户名/密码对。因此，在使用 LDAP 进行认证之前，用户必须已经存在于数据库中。LDAP 认证可以在两种模式下工作。第一种模式称为简单绑定模式，服务器会绑定到按 prefix username suffix 形式构造出的可分辨名称。通常，…LDAP 认证 Levenshtein章节正文PG18F.16.3. Levenshtein 该函数计算两个字符串之间的 Levenshtein 距离：levenshtein(source text, target text, ins_cost int, del_cost int, sub_cost int) returns int levenshtein(source text, target text) returns int…Levenshtein libc 排序规则章节正文PG1823.2.2.2.1. libc 排序规则例如，操作系统可能提供一个名为de_DE.utf8的区域设置。initdb随后会为UTF8编码创建一个名为de_DE.utf8的排序规则，其 LC_COLLATE和LC_CTYPE都设置为 de_DE.utf8。它还会再创建一个从名称中去掉 .utf8标签的排序规则。因此，你也可以使用 de_DE这个名称来使用该排序规则，这样写起来更方…libc 排序规则 libc 排序规则章节正文PG1823.2.2.3.1. libc 排序规则新的 libc 排序规则可以这样创建：CREATE COLLATION german (provider = libc, locale = 'de_DE'); 该命令中locale子句可接受的确切值取决于操作系统。在类 Unix 系统上，命令locale -a会给出一个列表。由于预定义的 libc 排序规则已经包含了数据库实例初始化时操…libc 排序规则 Libpq章节正文PG18E.6.3.5. Libpq 添加函数 PQfullProtocolVersion() 以报告完整的（包括次要版本）协议版本号（Jacob Champion, Jelte Fennema-Nio）§ 添加 libpq 连接参数和环境变量以指定连接的最小和最大可接受协议版本（Jelte Fennema-Nio）§ § 向客户端报告search_path更改（Alexander K…Libpq LIKE章节正文PG189.7.1. LIKE string LIKE pattern [ESCAPE escape-character] string NOT LIKE pattern [ESCAPE escape-character] 如果该string匹配了提供的pattern，那么LIKE表达式返回真（和预期的一样，如果LIKE返回真，那么NOT LIKE表达式返回假，反之亦然。一个等效的表达…LIKE LIKE 子句章节正文PG18LIKE 子句虽然 SQL 标准中存在 LIKE 子句，但 PostgreSQL 接受的许多 LIKE 选项并不在标准中，而标准中的某些选项又没有被 PostgreSQL 实现。LIKE 子句 LIMIT 子句章节正文PG18LIMIT 子句该 LIMIT 子句由两个独立的子句组成：LIMIT { count | ALL } OFFSET start 参数 count 指定最多返回多少行，而 start 指定开始返回行之前要跳过的行数。如果两者都指定，则先跳过 start 行，然后开始计数并返回 count 行。如果 count 表达式计算结果为 NULL，则视为 LIMIT ALL，即不限制。如果…LIMIT 子句 LIMIT和OFFSET章节正文PG187.6. LIMIT和OFFSET LIMIT和OFFSET允许你只检索查询剩余部分产生的行的一部分：SELECT select_list FROM table_expression [ ORDER BY ... ] [ LIMIT { count | ALL } ] [ OFFSET start ] 如果给出了一个限制计数，那么会返回数量不超过该限制的行（但可能更少些，因为查…LIMIT和OFFSET LIMIT和OFFSET章节正文PG18LIMIT和OFFSET LIMIT和OFFSET子句是 PostgreSQL特有的语法，在 MySQL中也被使用。SQL:2008 标准已经引入了具有相同功能的子句OFFSET ... FETCH {FIRST|NEXT} ...（如上文LIMIT Clause中所示）。这种语法也被IBM DB2使用（为Oracle编写的应用常常使用自动生成的 rownum列来实现这些子句的…LIMIT和OFFSET Linux 内存过量分配章节正文PG1818.4.4. Linux 内存过量分配 Linux 上默认的虚拟内存行为对PostgreSQL并非最佳。由于内核实现内存过量分配的方式，如果 PostgreSQL 或其他进程的内存需求导致系统耗尽虚拟内存，内核可能会终止 PostgreSQL 的 postmaster（主管服务器进程）。如果发生这种情况，你会看到类似下面的内核消息（至于应到哪里查看此类消息，请参阅你的系统文档…Linux 内存过量分配 Linux 大页章节正文PG1818.4.5. Linux 大页使用大页可以减少PostgreSQL这类会使用大块连续内存的软件所带来的开销，尤其是在shared_buffers取值较大时。要在PostgreSQL中使用这一特性，你需要一个启用了CONFIG_HUGETLBFS=y和CONFIG_HUGETLB_PAGE=y的内核。你还需要把操作系统配置为提供足够多、且大小合适的大页。运行时计算参数share…Linux 大页 LISTEN章节正文PG18LISTEN LISTEN — 监听通知大纲 LISTEN channelLISTEN lo — 管理大对象章节正文PG18F.21. lo — 管理大对象 lo模块为管理大对象（也称为 LO 或 BLOB）提供支持，其中包括数据类型lo和触发器lo_manage。该模块被认为是“受信任的”，也就是说，它可以由在当前数据库上具有CREATE权限的非超级用户安装。lo — 管理大对象 LOAD章节正文PG18LOAD LOAD — 载入共享库文件大纲 LOAD 'filename'LOAD LOCK章节正文PG18LOCK LOCK — 锁定表大纲 LOCK [ TABLE ] [ ONLY ] name [ * ] [, ...] [ IN lockmode MODE ] [ NOWAIT ] 其中 lockmode 可以是以下之一： ACCESS SHARE | ROW SHARE | ROW EXCLUSIVE | SHARE UPDATE EXCLUSIVE | SHARE | …LOCK login章节正文PG1838.1.1. login 当已认证用户登录系统时，会发生 login 事件。该事件的触发器过程中的任何缺陷都可能导致系统无法成功登录。可以通过在连接字符串或配置文件中将event_triggers设为 false 来绕过这类问题。或者，也可以将系统重启到单用户模式（该模式下事件触发器被禁用）。关于如何使用单用户模式的细节，参见postgres参考页。login 事件也会在备库…login LOOP章节正文PG1841.6.5.1. LOOP [ <<label>> ] LOOP statements END LOOP [ label ]; LOOP定义一个无条件的循环，它会无限重复直到被EXIT或RETURN语句终止。可选的label可以被EXIT和CONTINUE语句用在嵌套循环中指定这些语句引用的是哪一层循环。LOOP ltree — 层次树状数据类型章节正文PG18F.22. ltree — 层次树状数据类型该模块实现了数据类型ltree，用于表示存储在层次化树状结构中的数据标签。它还提供了丰富的标签树搜索能力。该模块被认为是“受信任的”，也就是说，它可以由在当前数据库上具有CREATE权限的非超级用户安装。ltree — 层次树状数据类型 LWLocks章节正文PG1836.10.12. LWLocksLWLocks macaddr章节正文PG188.9.4. macaddr macaddr类型存储 MAC 地址，例如以太网卡硬件地址（尽管 MAC 地址还用于其它用途）。可以接受下列格式的输入：'08:00:2b:01:02:03' '08-00-2b-01-02-03' '08002b:010203' '08002b-010203' '0800.2b01.0203' '0800-2b01-0203' '08002b01…macaddr macaddr8章节正文PG188.9.5. macaddr8 macaddr8 类型以 EUI-64 格式存储 MAC 地址，例如以太网卡的硬件地址（尽管 MAC 地址也用于其他目的）。该类型既接受 6 字节也接受 8 字节长度的 MAC 地址，并统一以 8 字节格式存储。以 6 字节格式给出的 MAC 地址，会在转换为 8 字节格式时，将第 4 和第 5 个字节分别设置为 FF 和 FE。请注意，IPv6…macaddr8 macOS章节正文PG18J.2.4. macOS 如果你使用 MacPorts，执行以下命令即可完成设置：sudo port install docbook-xml docbook-xsl-nons libxslt fop 如果你使用 Homebrew，请使用：brew install docbook docbook-xsl libxslt fop Homebrew 提供的程序要求设置下列环境变量。对…macOS macOS章节正文PG1817.7.2. macOS 要在 macOS 上从源代码构建 PostgreSQL，你需要安装 Apple 的命令行开发工具，可通过执行下列命令完成：xcode-select --install（注意，这会弹出一个 GUI 对话框要求确认。）你也可以视需要另外安装 Xcode。在较新的 macOS 版本中，需要把“sysroot”路径嵌入到用于查找某些系统头文件的 includ…macOS MCV 列表章节正文PG1869.2.3. MCV 列表如第 69.2.1 节中所述，函数依赖是一种非常廉价且高效的统计信息类型，但其主要局限在于它具有全局性（只在列层面跟踪依赖关系，而不是跟踪各个列值之间的依赖关系）。本节介绍MCV（高频值）列表的多元变体，它是第 69.1 节中按列统计信息的直接扩展。这类统计信息通过存储单个值来解决上述限制，但无论是在ANALYZE中构建统计信息，还是在存储和规划时间…MCV 列表 MERGE章节正文PG18MERGE MERGE — 有条件地插入、更新或删除表中的行大纲 [ WITH with_query [, ...] ] MERGE INTO [ ONLY ] target_table_name [ * ] [ [ AS ] target_alias ] USING data_source ON join_condition when_clause [...] [ RETUR…MERGE MERGES章节正文PG1836.15.6. MERGES 如果存在 MERGES 子句，它会告知系统：在基于该操作符的连接中，可以使用归并连接方法。MERGES 只对返回 boolean 的二元操作符有意义；在实践中，该操作符还必须表示某种数据类型或某对数据类型上的相等关系。归并连接的基本思想，是先把左表和右表分别排序，然后同步扫描它们。因此，两种数据类型都必须能够被完全排序，而连接操作符必须只能在那对…MERGES meson setup 选项章节正文PG1817.4.3. meson setup 选项下面解释 meson setup 的命令行选项。这个列表并不完整（可使用 meson configure --help 获取完整列表）。此处未涉及的选项主要用于高级用例，并记录在标准 Meson 文档中。这些参数也可用于 meson setup。meson setup 选项 meson 构建目标章节正文PG1817.4.4. meson 构建目标可以使用 ninja target 构建单个目标。如果不指定目标，则会构建除文档之外的所有内容。也可以把路径/文件名作为 target，从而构建单独的构建产物。meson 构建目标 Metaphone章节正文PG18F.16.4. Metaphone Metaphone 与 Soundex 一样，基于为输入字符串构造一个代表性代码的思想。如果两个字符串具有相同的代码，则认为它们相似。该函数计算输入字符串的 Metaphone 代码：metaphone(source text, max_output_length int) returns text source 必须是非 NULL 字符串，…Metaphone MinGW章节正文PG1817.7.3. MinGW 可以使用 MinGW 这个 Windows 上的类 Unix 构建环境来构建 Windows 版 PostgreSQL。推荐为此使用 MSYS2 环境，并安装所需的前置软件包。MinGW moddatetime — 用于跟踪最后修改时间的函数章节正文PG18F.41.4. moddatetime — 用于跟踪最后修改时间的函数 moddatetime() 是一个将当前时间存入 timestamp 字段的触发器。它有助于跟踪表中某一特定行最后一次被修改的时间。使用时，创建一个使用该函数的 BEFORE UPDATE 触发器。指定一个触发器参数：要修改的列名。该列必须是 timestamp 或 timestamp with time …moddatetime — 用于跟踪最后修改时间的函数 MOVE章节正文PG1841.7.3.2. MOVE MOVE [ direction { FROM | IN } ] cursor; MOVE重新定位一个游标而不检索任何数据。MOVE的工作方式与FETCH类似，但只重新定位游标且不返回移动到的行。direction 子句可以是 SQL FETCH命令允许的任意变体，包括可提取多行的变体；在这种情况下，游标会定位到其中最后一行。（不过，在 PL/pg…MOVE MOVE章节正文PG18MOVE MOVE — 定位游标大纲 MOVE [ direction ] [ FROM | IN ] cursor_name 其中 direction 可以是以下之一： NEXT PRIOR FIRST LAST ABSOLUTE count RELATIVE count count ALL FORWARD FORWARD count FORWARD ALL BACKWARD…MOVE NEGATOR章节正文PG1836.15.2. NEGATOR 如果给出 NEGATOR 子句，它指定一个与正在定义的操作符互为求反器的操作符。若操作符 A 和 B 都返回布尔结果，并且对所有可能的输入 x、y，都有 (x A y) 等于 NOT (x B y)，则称 A 是 B 的求反器。注意，B 也同样是 A 的求反器。例如，对大多数数据类型而言，< 和 >= 构成一对求反器。一个操作符永远不可能合法地…NEGATOR