PostgreSQL 文档检索

pg_archivecleanup章节正文PG18pg_archivecleanup pg_archivecleanup — 清理PostgreSQL WAL 归档文件大纲 pg_archivecleanup [option...] archivelocation oldestkeptwalfilepg_archivecleanup pg_attrdef章节正文PG1852.6. pg_attrdef 目录pg_attrdef存储列默认表达式和生成表达式。列的主要信息存储在pg_attribute中。只有显式设置了默认表达式或生成表达式的列，才会在此目录中有条目。表 52.6. pg_attrdef 列 列类型 描述 oid oid 行标识符 adrelid oid（引用 pg_class.oid） 该列所属的表 adnum int2（引用 …pg_attrdef pg_attribute章节正文PG1852.7. pg_attribute 目录pg_attribute存储关于表列的信息。数据库中每个表的每一列，在pg_attribute中都恰好有一行。（其中也包括索引的属性项，实际上，凡是在pg_class中有项的对象，都有对应的属性项。）术语属性等同于列，这里使用它只是出于历史原因。表 52.7. pg_attribute 列 列类型 描述 attrelid oid（引用 …pg_attribute pg_auth_members章节正文PG1852.9. pg_auth_members 目录pg_auth_members展示了角色之间的成员关系。允许任何无环的关系集合。由于用户身份是集簇范围的，pg_auth_members在一个集簇的所有数据库之间共享：在一个集簇中只有一份pg_auth_members拷贝，而不是每个数据库一份。表 52.9. pg_auth_members 列 列类型 描述 oid oid 行标…pg_auth_members pg_authid章节正文PG1852.8. pg_authid 目录pg_authid包含关于数据库授权标识符（角色）的信息。角色涵盖了“用户”和“组”这两个概念。用户本质上只是设置了rolcanlogin标志的角色。任何角色（无论是否设置了rolcanlogin）都可以拥有其他角色作为成员；参见pg_auth_members。由于这个目录包含密码，不得允许对它进行公开读取。pg_roles是建立在pg_au…pg_authid pg_available_extension_versions章节正文PG1853.4. pg_available_extension_versions pg_available_extension_versions视图列出了可供安装的特定扩展版本。另请参阅pg_extension目录，其中显示当前已安装的扩展。表 53.4. pg_available_extension_versions 列 列类型 描述 name name 扩展名 version t…pg_available_extension_versions pg_available_extensions章节正文PG1853.3. pg_available_extensions pg_available_extensions视图列出了可供安装的扩展。另请参阅pg_extension目录，其中显示当前已安装的扩展。表 53.3. pg_available_extensions 列 列类型 描述 name name 扩展名 default_version text 默认版本的名称，如果没有指定则为…pg_available_extensions pg_backend_memory_contexts章节正文PG1853.5. pg_backend_memory_contexts 视图pg_backend_memory_contexts显示附属于当前会话的服务器进程中的全部内存上下文。pg_backend_memory_contexts 为每个内存上下文提供一行。表 53.5. pg_backend_memory_contexts 列 列类型 描述 name text 内存上下文的名称 i…pg_backend_memory_contexts pg_basebackup章节正文PG18pg_basebackup pg_basebackup — 获取PostgreSQL集簇的基础备份大纲 pg_basebackup [option...]pg_basebackup pg_buffercache — 检查 PostgreSQL 缓冲区缓存状态章节正文PG18F.25. pg_buffercache — 检查 PostgreSQL 缓冲区缓存状态 pg_buffercache 模块提供了一种手段，可实时检查共享缓冲区缓存中正在发生的情况。它还提供了一种底层方式，可出于测试目的从中逐出数据。该模块提供 pg_buffercache_pages() 函数（由 pg_buffercache 视图封装）、pg_buffercache_num…pg_buffercache — 检查 PostgreSQL 缓冲区缓存状态 pg_buffercache 视图章节正文PG18F.25.1. pg_buffercache 视图该视图公开的列定义见表 F.14。表 F.14. pg_buffercache 列 列类型 描述 bufferid integer ID，范围为 1..shared_buffers relfilenode oid（引用 pg_class.relfilenode） 关系的文件节点编号 reltablespace oid（引用 pg…pg_buffercache 视图 pg_buffercache_evict() 函数章节正文PG18F.25.5. pg_buffercache_evict() 函数 pg_buffercache_evict() 函数接受一个缓冲区标识符，如 pg_buffercache 视图中的 bufferid 列所示。它返回该缓冲区是否被逐出以及是否被刷出的信息。buffer_evicted 列在成功时为 true；如果缓冲区无效、因被钉住而无法逐出，或者在尝试将其写出后再次变脏，则为…pg_buffercache_evict() 函数 pg_buffercache_evict_all() 函数章节正文PG18F.25.7. pg_buffercache_evict_all() 函数 pg_buffercache_evict_all() 函数与 pg_buffercache_evict() 函数非常相似。不同之处在于，pg_buffercache_evict_all() 不接收参数；它会尝试逐出缓冲池中的所有缓冲区。它返回被逐出的缓冲区数、被刷出的缓冲区数以及无法逐出的缓冲区数。被刷…pg_buffercache_evict_all() 函数 pg_buffercache_evict_relation() 函数章节正文PG18F.25.6. pg_buffercache_evict_relation() 函数 pg_buffercache_evict_relation() 函数与 pg_buffercache_evict() 函数非常相似。不同之处在于，pg_buffercache_evict_relation() 接受的是关系标识符，而不是缓冲区标识符。它会尝试逐出该关系所有分支中的全部缓冲区。它…pg_buffercache_evict_relation() 函数 pg_buffercache_numa 视图章节正文PG18F.25.2. pg_buffercache_numa 视图该视图公开的列定义见表 F.15。表 F.15. pg_buffercache_numa 列 列类型 描述 bufferid integer ID，范围为 1..shared_buffers os_page_num bigint 该缓冲区对应的操作系统内存页号 numa_node int NUMA 节点 ID 由于为每…pg_buffercache_numa 视图 pg_buffercache_summary() 函数章节正文PG18F.25.3. pg_buffercache_summary() 函数该函数公开的列定义见表 F.16。表 F.16. pg_buffercache_summary() 输出列 列类型 描述 buffers_used int4 已使用的共享缓冲区数量 buffers_unused int4 未使用的共享缓冲区数量 buffers_dirty int4 脏共享缓冲区的数量 buf…pg_buffercache_summary() 函数 pg_buffercache_usage_counts() 函数章节正文PG18F.25.4. pg_buffercache_usage_counts() 函数该函数公开的列定义见表 F.17。表 F.17. pg_buffercache_usage_counts() 输出列 列类型 描述 usage_count int4 一种可能的缓冲区使用计数值 buffers int4 具有该使用计数的缓冲区数量 dirty int4 具有该使用计数的脏缓冲区数量 …pg_buffercache_usage_counts() 函数 pg_cast章节正文PG1852.10. pg_cast 目录pg_cast存储数据类型转换路径，包括内置路径和用户定义路径。需要注意的是，pg_cast并不表示系统知道如何执行的所有类型转换，它只包括那些不能从某些通用规则推导出的转换。例如，一个域及其基础类型之间的转换并未显式地在pg_cast中展示。另一个重要的例外是“自动的基于 I/O 的类型转换”，它们通过数据类型自己的 I/O 函数来转换成（或…pg_cast pg_checksums章节正文PG18pg_checksums pg_checksums — 在PostgreSQL数据库集簇中启用、禁用或检查数据校验和大纲 pg_checksums [option...] [[ -D | --pgdata ]datadir]pg_checksums pg_class章节正文PG1852.11. pg_class 目录pg_class描述了表以及其他具有列或在其他方面与表类似的对象。这包括索引（但请参见pg_index）、序列（但请参见pg_sequence）、视图、物化视图、复合类型和TOAST表；请参见relkind。在下面，当我们指的是所有这些类型的对象时，我们称之为“关系（relations）”。并非所有pg_class的列对所有关系类型都有意义。…pg_class pg_collation章节正文PG1852.12. pg_collation 目录pg_collation描述可用的排序规则，其本质上是从 SQL 名字到操作系统区域设置类别的映射。更多信息参见第 23.2 节。表 52.12. pg_collation 列 列类型 描述 oid oid 行标识符 collname name 排序规则名称（在每个名字空间与编码的组合内唯一） collnamespace oid（引用…pg_collation pg_combinebackup章节正文PG18pg_combinebackup pg_combinebackup — 从增量备份及其所依赖的备份重建完整备份大纲 pg_combinebackup [option...] [backup_directory...]pg_combinebackup pg_config章节正文PG18pg_config pg_config — 获取已安装的PostgreSQL版本的信息大纲 pg_config [option...]pg_config pg_config章节正文PG1853.6. pg_config 视图pg_config描述了当前安装版本的PostgreSQL的编译时配置参数。例如，它可供希望与PostgreSQL交互的软件包使用，以便找到所需的头文件和库。它提供与PostgreSQL客户端应用程序pg_config相同的基本信息。默认情况下，pg_config视图只能被超级用户读取。表 53.6. pg_config 列 列类型 描述 n…pg_config pg_constraint章节正文PG1852.13. pg_constraint 目录pg_constraint存储表上的检查约束、非空约束、主键约束、唯一约束、外键约束和排他约束。（列约束不会被特殊对待。每一个列约束都等价于某种表约束。）用户定义的约束触发器（使用CREATE CONSTRAINT TRIGGER创建）也会在这个表中产生一项。域上的检查约束也存储在这里。表 52.13. pg_constraint …pg_constraint pg_controldata章节正文PG18pg_controldata pg_controldata — 显示 PostgreSQL 数据库集簇的控制信息大纲 pg_controldata [option] [[ -D | --pgdata ]datadir]pg_controldata pg_conversion章节正文PG1852.14. pg_conversion 目录pg_conversion描述编码转换函数。更多信息参见CREATE CONVERSION。表 52.14. pg_conversion 列 列类型 描述 oid oid 行标识符 conname name 转换的名字（在一个名字空间内唯一） connamespace oid（引用 pg_namespace.oid） 包含此转换的名…pg_conversion pg_createsubscriber章节正文PG18pg_createsubscriber pg_createsubscriber — 将物理副本转换为新的逻辑副本大纲 pg_createsubscriber [option...] { -d | --database }dbname { -D | --pgdata }datadir { -P | --publisher-server }connstrpg_createsubscriber pg_ctl章节正文PG18pg_ctl pg_ctl — 初始化、启动、停止或控制PostgreSQL服务器大纲 pg_ctl init[db] [-D datadir] [-s] [-o initdb-options] pg_ctl start [-D datadir] [-l filename] [-W] [-t seconds] [-s] [-o options] [-p path] [-c] p…pg_ctl pg_cursors章节正文PG1853.7. pg_cursors pg_cursors视图列出当前可用的游标。游标可以通过多种方式定义：通过SQL中的DECLARE语句 通过前端/后端协议中的Bind消息，如第 54.2.3 节中所述 通过服务器编程接口（SPI），如第 45.1 节中所述 pg_cursors视图显示通过任何这些方式创建的游标。游标仅在定义它们的事务的持续时间内存在，除非它们已经声明为WIT…pg_cursors pg_database章节正文PG1852.15. pg_database 目录pg_database存储有关可用数据库的信息。数据库通过CREATE DATABASE命令创建。关于其中一些参数的含义的详细信息请查阅第 22 章。和大部分系统目录不同，pg_database是在集簇的所有数据库之间共享的：在一个集簇中只有一份pg_database拷贝，而不是每个数据库一份。表 52.15. pg_database …pg_database pg_db_role_setting章节正文PG1852.16. pg_db_role_setting 目录 pg_db_role_setting为每个角色与数据库组合记录运行时配置变量的默认值。和大部分系统目录不同，pg_db_role_setting是在集簇的所有数据库之间共享的：在一个集簇中只有一份pg_db_role_setting拷贝，而不是每个数据库一份。表 52.16. pg_db_role_setting 列 列…pg_db_role_setting pg_default_acl章节正文PG1852.17. pg_default_acl 目录pg_default_acl存储要被分配给新创建对象的初始权限。表 52.17. pg_default_acl 列 列类型 描述 oid oid 行标识符 defaclrole oid（引用 pg_authid.oid） 与此项相关的角色的OID defaclnamespace oid（引用 pg_namespace.oid） 与…pg_default_acl pg_depend章节正文PG1852.18. pg_depend 目录pg_depend记录数据库对象之间的依赖关系。这些信息允许DROP命令查找必须被DROP CASCADE删除的其他对象，或者在DROP RESTRICT情况下阻止删除。另请参阅pg_shdepend，它对涉及数据库集簇共享对象的依赖提供了相似的功能。表 52.18. pg_depend 列 列类型 描述 classid oid（引用 pg…pg_depend pg_description章节正文PG1852.19. pg_description 目录pg_description存储对每一个数据库对象可选的描述（注释）。描述可以通过COMMENT操作，并可使用psql的\d命令查看。在pg_description的初始内容中提供了很多内置系统对象的描述。参见pg_shdescription，它对在一个数据库集簇中共享的对象的描述提供了相似的功能。表 52.19. pg_desc…pg_description pg_dump章节正文PG18pg_dump pg_dump — 将 PostgreSQL 数据库导出为 SQL 脚本或其他格式大纲 pg_dump [connection-option...] [option...] [dbname]pg_dump pg_dump/pg_dumpall/pg_restore章节正文PG18E.6.3.7.1. pg_dump/pg_dumpall/pg_restore 添加pg_dump选项 --statistics（Jeff Davis）§ § 添加 pg_dump 和pg_dumpall选项 --sequence-data 以转储通常会被排除的序列数据（Nathan Bossart）§ § 添加pg_dump、pg_dumpall和pg_restore选项 …pg_dump/pg_dumpall/pg_restore pg_dumpall章节正文PG18pg_dumpall pg_dumpall — 将一个PostgreSQL数据库集簇转储为脚本文件大纲 pg_dumpall [connection-option...] [option...]pg_dumpall pg_enum章节正文PG1852.20. pg_enum pg_enum目录包含每一个枚举类型的项，其中包括了值和标签。一个给定枚举值的内部表示实际上是它在pg_enum中的相关行的OID。表 52.20. pg_enum 列 列类型 描述 oid oid 行标识符 enumtypid oid（引用 pg_type.oid） 包含此枚举值的pg_type项的OID enumsortorder float4…pg_enum pg_event_trigger章节正文PG1852.21. pg_event_trigger 目录pg_event_trigger存储事件触发器。更多信息参见第 38 章。表 52.21. pg_event_trigger 列 列类型 描述 oid oid 行标识符 evtname name 触发器名（必须唯一） evtevent name 标识会触发此触发器的事件 evtowner oid（引用 pg_authid.oi…pg_event_trigger