PostgreSQL 文档检索

ALTER TABLESPACE章节正文PG18ALTER TABLESPACE ALTER TABLESPACE — 更改一个表空间的定义大纲 ALTER TABLESPACE name RENAME TO new_name ALTER TABLESPACE name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER TABL…ALTER TABLESPACE ALTER TEXT SEARCH CONFIGURATION章节正文PG18ALTER TEXT SEARCH CONFIGURATION ALTER TEXT SEARCH CONFIGURATION — 更改一个文本检索配置的定义大纲 ALTER TEXT SEARCH CONFIGURATION name ADD MAPPING FOR token_type [, ... ] WITH dictionary_name [, ... ] ALTER…ALTER TEXT SEARCH CONFIGURATION ALTER TEXT SEARCH DICTIONARY章节正文PG18ALTER TEXT SEARCH DICTIONARY ALTER TEXT SEARCH DICTIONARY — 更改一个文本检索词典的定义大纲 ALTER TEXT SEARCH DICTIONARY name ( option [ = value ] [, ... ] ) ALTER TEXT SEARCH DICTIONARY name RENAME TO new_…ALTER TEXT SEARCH DICTIONARY ALTER TEXT SEARCH PARSER章节正文PG18ALTER TEXT SEARCH PARSER ALTER TEXT SEARCH PARSER — 更改一个文本检索解析器的定义大纲 ALTER TEXT SEARCH PARSER name RENAME TO new_name ALTER TEXT SEARCH PARSER name SET SCHEMA new_schemaALTER TEXT SEARCH PARSER ALTER TEXT SEARCH TEMPLATE章节正文PG18ALTER TEXT SEARCH TEMPLATE ALTER TEXT SEARCH TEMPLATE — 更改一个文本检索模板的定义大纲 ALTER TEXT SEARCH TEMPLATE name RENAME TO new_name ALTER TEXT SEARCH TEMPLATE name SET SCHEMA new_schemaALTER TEXT SEARCH TEMPLATE ALTER TRIGGER章节正文PG18ALTER TRIGGER ALTER TRIGGER — 更改触发器的定义大纲 ALTER TRIGGER name ON table_name RENAME TO new_name ALTER TRIGGER name ON table_name [ NO ] DEPENDS ON EXTENSION extension_nameALTER TRIGGER ALTER TYPE章节正文PG18ALTER TYPE ALTER TYPE — 更改类型的定义大纲 ALTER TYPE name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER TYPE name RENAME TO new_name ALTER TYPE name SET SCHEMA new_schema…ALTER TYPE ALTER USER章节正文PG18ALTER USER ALTER USER — 更改数据库角色大纲 ALTER USER role_specification [ WITH ] option [ ... ] 其中 option 可以是： SUPERUSER | NOSUPERUSER | CREATEDB | NOCREATEDB | CREATEROLE | NOCREATEROLE | INHERIT |…ALTER USER ALTER USER MAPPING章节正文PG18ALTER USER MAPPING ALTER USER MAPPING — 更改用户映射的定义大纲 ALTER USER MAPPING FOR { user_name | USER | CURRENT_ROLE | CURRENT_USER | SESSION_USER | PUBLIC } SERVER server_name OPTIONS ( [ ADD | SET…ALTER USER MAPPING ALTER VIEW章节正文PG18ALTER VIEW ALTER VIEW — 更改视图的定义大纲 ALTER VIEW [ IF EXISTS ] name ALTER [ COLUMN ] column_name SET DEFAULT expression ALTER VIEW [ IF EXISTS ] name ALTER [ COLUMN ] column_name DROP DEFAULT AL…ALTER VIEW amcheck — 用于验证表和索引一致性的工具章节正文PG18F.1. amcheck — 用于验证表和索引一致性的工具 amcheck模块提供了一组函数，可用于验证关系结构的逻辑一致性。B-树检查函数会验证特定关系表示结构中的多种不变式。索引扫描以及其他重要操作背后的访问方法函数是否正确，依赖于这些不变式始终成立。例如，某些函数除其他事项外，还会验证所有 B-树页面中的项都按“逻辑”顺序排列（例如，对于text上的 B-树索引，索引元组…amcheck — 用于验证表和索引一致性的工具 ANALYZE章节正文PG18ANALYZE ANALYZE — 收集数据库的统计信息大纲 ANALYZE [ ( option [, ...] ) ] [ table_and_columns [, ...] ] 其中option可以是下列之一： VERBOSE [ boolean ] SKIP_LOCKED [ boolean ] BUFFER_USAGE_LIMIT size 其中table_and_c…ANALYZE ANALYZE 的 FDW 例程章节正文PG1858.2.8. ANALYZE 的 FDW 例程 bool AnalyzeForeignTable(Relation relation, AcquireSampleRowsFunc *func, BlockNumber *totalpages); 当在外部表上执行ANALYZE时会调用这个函数。如果 FDW 能为该外部表收集统计信息，它应返回true，并在 func 中提供一个…ANALYZE 的 FDW 例程 ANALYZE 进度报告章节正文PG1827.4.1. ANALYZE 进度报告每当ANALYZE运行时，pg_stat_progress_analyze视图将包含当前运行该命令的每个后端的一行。下面的表描述了将要报告的信息，并提供了关于如何解释它们的信息。表 27.38. pg_stat_progress_analyze 视图 列类型 描述 pid integer 后端的进程ID。 datid oid 后端连接到的…ANALYZE 进度报告 ANY/SOME章节正文PG189.24.4. ANY/SOME expression operator ANY (subquery) expression operator SOME (subquery) 这种形式的右侧是一个用括号括起来的子查询，它必须恰好返回一列。左侧表达式会被求值，并使用给定的 operator 与子查询结果的每一行进行比较。该操作符必须产生布尔结果。如果得到任何真值结果，那么ANY的…ANY/SOME ANY/SOME（数组）章节正文PG189.25.3. ANY/SOME（数组）expression operator ANY (array expression) expression operator SOME (array expression) 右侧是一个用括号括起来的表达式，它必须产生一个数组值。左侧表达式会被求值，并使用给定的operator与数组的每个元素进行比较，该操作符必须产生布尔结果。如果得到了任…ANY/SOME（数组） API 兼容性章节正文PG1836.10.6.2. API 兼容性 API，即应用程序编程接口，是编译时使用的接口。API 兼容性 applicable_roles章节正文PG1835.5. applicable_roles 视图applicable_roles标识当前用户可以使用其权限的所有角色。这意味着从当前用户到相关角色之间存在某条角色授予链。当前用户本身也是一个适用角色。适用角色的集合通常用于权限检查。表 35.3. applicable_roles 列 列类型 描述 grantee sql_identifier 被授予该角色成员资格的角色名称（…applicable_roles archive_command脚本章节正文PG1825.3.7.3. archive_command脚本很多人选择使用脚本来定义自己的archive_command，这样postgresql.conf中的配置项就会显得非常简单：archive_command = 'local_backup_script.sh "%p" "%f"' 只要你希望在归档过程中使用不止一条命令，就建议使用单独的脚本文件。这样一来，所有复杂性都可以在脚…archive_command脚本 armor(), dearmor()章节正文PG18F.26.3.6. armor(), dearmor() armor(data bytea [ , keys text[], values text[] ]) returns text dearmor(data text) returns bytea 这些函数将二进制数据封装/解封装为 PGP ASCII-armor 格式，它本质上就是带 CRC 和附加格式信息的 Base64…armor(), dearmor() AT TIME ZONE 和 AT LOCAL章节正文PG189.9.4. AT TIME ZONE 和 AT LOCAL AT TIME ZONE 操作符可将不带时区的时间戳转换为带时区的时间戳或反向转换，也可将 time with time zone 值转换到不同的时区。表 9.34展示了它的各种变体。表 9.34. AT TIME ZONE 和 AT LOCAL 变体 操作符 描述 示例 timestamp without time…AT TIME ZONE 和 AT LOCAL attributes章节正文PG1835.6. attributes 视图attributes包含数据库中定义的复合数据类型的属性信息。（注意，该视图不提供表列的信息，而表列在 PostgreSQL 的语境中有时也称为属性。）只显示当前用户能够访问的属性（作为该类型的拥有者或具有该类型上的某种权限）。表 35.4. attributes 列 列类型 描述 udt_catalog sql_identifier 包含…attributes auth_delay — 在认证失败时暂停章节正文PG18F.2. auth_delay — 在认证失败时暂停 auth_delay会使服务器在报告认证失败之前短暂暂停，从而增加对数据库密码进行暴力破解攻击的难度。注意，它并不能阻止拒绝服务攻击，甚至可能加剧此类攻击，因为在报告认证失败前处于等待状态的进程仍会占用连接槽位。为了使该模块正常工作，必须在postgresql.conf中通过shared_preload_libraries加…auth_delay — 在认证失败时暂停 Authdata 钩子章节正文PG1832.20.1. Authdata 钩子客户端可以通过下面的钩子 API 修改或替换 OAuth 流程的行为：PQsetAuthDataHook # 设置PGauthDataHook，以覆盖libpq对其 OAuth 客户端流程一个或多个方面的处理。 void PQsetAuthDataHook(PQauthDataHook_type hook); 如果hook是NULL，则会…Authdata 钩子 auto_explain — 记录慢查询的执行计划章节正文PG18F.3. auto_explain — 记录慢查询的执行计划 auto_explain模块提供了一种自动记录慢语句执行计划的方法，而无须手工运行EXPLAIN。这对于在大型应用中追查未优化的查询尤其有帮助。该模块不提供可通过 SQL 访问的函数。要使用它，只需将其加载到服务器中。可以将其加载到单个会话中：LOAD 'auto_explain';（要这样做，必须是超级用户。）更典…auto_explain — 记录慢查询的执行计划 autoinc — 用于字段自动递增的函数章节正文PG18F.41.2. autoinc — 用于字段自动递增的函数 autoinc() 是一个将序列的下一个值存入整数字段的触发器。这与内置的“serial 列”功能有一些重叠，但并不相同。只有当该字段的值最初为零或空值时（也就是在插入或更新该行的 SQL 语句动作执行之后），触发器才会替换该字段值。此外，如果序列的下一个值为零，则会再次调用 nextval()，以取得一个非零值。使用…autoinc — 用于字段自动递增的函数 B-树章节正文PG1811.2.1. B-树 B-树能够处理可以按某种顺序排序的数据上的等值查询和范围查询。特别是，只要已索引列参与了下列任一操作符的比较，PostgreSQL查询规划器就会考虑使用 B-树索引：< <= = >= > 与这些操作符组合等价的构造，例如BETWEEN和IN，也可以通过 B-树索引搜索来实现。此外，索引列上的IS NULL或IS NOT NULL条件也可以配合 B-树索…B-树 B-树函数章节正文PG18F.23.3. B-树函数 bt_metap(relname text) returns record bt_metap返回 B-树索引元页的信息。例如： test=# SELECT * FROM bt_metap('pg_cast_oid_index'); -[ RECORD 1 ]-------------+------- magic | 340322 version | …B-树函数 B-树操作符类的行为章节正文PG1865.1.2. B-树操作符类的行为正如表 36.3所示，B-树操作符类必须提供五个比较操作符，<、<=、=、>= 和 >。人们可能会以为 <> 也应当属于操作符类的一部分，但事实并非如此，因为在索引搜索中使用 <> 的 WHERE 子句几乎毫无用处。（出于某些目的，规划器会把 <> 视为与 B-树操作符类相关联；但规划器是通过 = 操作符的求反器链接找到该操作符，而不是从 p…B-树操作符类的行为 B-树支持函数章节正文PG1865.1.3. B-树支持函数如表 36.9所示，B-树定义了一个必需和五个可选的支持函数。六个用户定义的方法如下：order 对于 B-树操作符族为其提供比较操作符的每一种数据类型组合，都必须提供一个比较支持函数。该函数在 pg_amproc 中注册，支持函数编号为 1，并且 amproclefttype/amprocrighttype 要等于该比较的左右数据类型（也就是与匹…B-树支持函数 B-树索引章节正文PG1865.1. B-树索引B-树索引 B-树结构章节正文PG1865.1.4.1. B-树结构 PostgreSQL 的 B-树索引是多层树结构，其中树的每一层都可以用作页的双向链表。索引的第一个段文件起始处的固定位置保存着一个元页。其余页面要么是叶页，要么是内部页。叶页位于树的最低层，其余各层都由内部页组成。每个叶页都包含指向表中行的元组。每个内部页都包含指向树中下一层的元组。通常，超过 99% 的页面都是叶页。内部页和叶页都使用第 66…B-树结构 basebackup_to_shell — 示例“shell” pg_basebackup 模块章节正文PG18F.4. basebackup_to_shell — 示例“shell” pg_basebackup 模块 basebackup_to_shell新增了一个名为shell的自定义基础备份目标。这样便可以运行pg_basebackup --target=shell，或者根据该模块的配置运行pg_basebackup --target=shell:DETAIL_STRING，并使服…basebackup_to_shell — 示例“shell” pg_basebackup 模块 basic_archive — 一个 WAL 归档模块示例章节正文PG18F.5. basic_archive — 一个 WAL 归档模块示例 basic_archive是一个归档模块示例。该模块会将已完成的 WAL 段文件复制到指定目录。它本身未必特别有用，但可作为开发自己的归档模块的起点。关于归档模块的更多信息，参见第 49 章。为了使该模块正常工作，必须通过archive_library加载它，并且必须启用archive_mode。basic_archive — 一个 WAL 归档模块示例 BEGIN章节正文PG18BEGIN BEGIN — 开始一个事务块大纲 BEGIN [ WORK | TRANSACTION ] [ transaction_mode [, ...] ] 其中 transaction_mode 是下列之一： ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMIT…BEGIN BKI 命令章节正文PG1868.4. BKI 命令 create tablename tableoid [bootstrap] [shared_relation] [rowtype_oid oid] (name1 = type1 [FORCE NOT NULL | FORCE NULL ] [, name2 = type2 [FORCE NOT NULL | FORCE NULL ], ...]) # …BKI 命令 BKI 文件格式章节正文PG1868.3. BKI 文件格式本节描述 PostgreSQL 后端如何解释 BKI 文件。如果手边有一份 postgres.bki 文件作为示例，这段说明会更容易理解。BKI 输入由一系列命令组成。根据命令语法的不同，每条命令由若干词元组成。词元通常由空白分隔，但如果不会产生歧义，也可以不分隔。没有专门的命令分隔符；语法上不可能属于前一条命令的下一个词元，就会开始一条新命令。（通…BKI 文件格式 BKI 示例章节正文PG1868.6. BKI 示例下列命令序列会创建一个 OID 为 420 的 test_table 表，该表有三列：oid、cola 和 colb，它们的类型分别是 oid、int4 和 text；然后再向该表插入两行数据：create test_table 420 (oid = oid, cola = int4, colb = text) open test_table inser…BKI 示例 bloom — 布隆过滤器索引访问方法章节正文PG18F.6. bloom — 布隆过滤器索引访问方法 bloom提供了一种基于布隆过滤器的索引访问方法。布隆过滤器是一种空间效率很高的数据结构，用于测试某个元素是否属于某个集合。对于索引访问方法，它允许通过签名快速排除不匹配的元组，而签名的大小则在创建索引时确定。签名是被索引属性的一种有损表示，因此容易产生误报；也就是说，某个元素实际上并不在集合中，却可能被报告为在集合中。因此，索…bloom — 布隆过滤器索引访问方法 BRIN章节正文PG1811.2.6. BRIN BRIN 索引（Block Range INdexes 的缩写）存储的是关于表中连续物理块范围内所保存值的摘要信息。因此，它最适用于那些列值与表行物理顺序高度相关的列。与 GiST、SP-GiST 和 GIN 一样，BRIN 也可以支持多种不同的索引策略，而 BRIN 索引可使用哪些具体操作符取决于所采用的索引策略。对于具有线性排序顺序的数据类型，每个…BRIN