current_setting ( setting_name text [, missing_ok boolean ] ) → text

返回设置的setting_name的当前值。 如果没有这样的设置，current_setting将抛出一个错误，除非missing_ok被提供并且为true(在此情况下返回NULL)。 这个函数对应于SQL命令SHOW。

current_setting('datestyle') → ISO, MDY

set_config ( setting_name text, new_value text, is_local boolean ) → text

将参数setting_name设置为new_value，并返回该值。 如果is_local为true，新值将仅在当前事务期间应用。 如果您希望新值应用于当前会话的其余部分，请使用false代替。这个函数对应于SQL命令SET。

set_config('log_statement_stats', 'off', false) → off

pg_cancel_backend ( pid integer ) → boolean

取消具有指定进程ID的后端进程的会话的当前查询。如果调用角色是被取消的后端进程所属角色的成员， 或者调用角色具有pg_signal_backend的权限，则也允许执行此操作，但只有超级用户可以取消超级用户后端进程。

pg_log_backend_memory_contexts ( pid integer ) → boolean

请求记录具有指定进程ID的后端的内存上下文。此函数可以将请求发送到后端和辅助进程，但不包括记录器。这些内存上下文将以 LOG消息级别记录。它们将根据设置的日志配置出现在服务器日志中 (有关更多信息，请参见Section 19.8)， 但无论如何都不会发送给客户端 (client_min_messages)。

pg_reload_conf () → boolean

使PostgreSQL服务器的所有进程重新加载其配置文件。 （这是通过向postmaster进程发送SIGHUP信号来启动的， postmaster进程又向其每个子进程发送SIGHUP。） 您可以使用pg_file_settings、 pg_hba_file_rules和 pg_ident_file_mappings视图来检查可能存在的错误， 然后再重新加载配置文件。

pg_rotate_logfile () → boolean

通知日志文件管理器立即切换到一个新的输出文件。 这仅在内置日志收集器运行时有效，因为否则没有日志文件管理器子进程。

pg_terminate_backend ( pid integer, timeout bigint DEFAULT 0 ) → boolean

终止具有指定进程ID的后端进程的会话。如果调用角色是正在终止的后端的角色的成员，或者调用角色具有pg_signal_backend的权限，则也允许执行此操作，但只有超级用户才能终止超级用户后端。

如果未指定或超时timeout为零，则此函数无论进程是否实际终止，都将返回true，仅表示信号发送成功。如果指定了timeout（以毫秒为单位）且大于零，则函数将等待直到进程实际终止或直到给定时间已过。如果进程被终止，函数将返回true。在超时时，会发出警告并返回false。

pg_create_restore_point ( name text ) → pg_lsn

在预写式日志中创建一个命名标记记录，稍后可以将其用作恢复目标，并返回相应的预写日志位置。 然后可以将给定的名称与 recovery_target_name一起使用，以指定进行恢复的点。 要避免创建多个名称相同的恢复点，因为恢复将在第一个名称与恢复目标匹配的恢复点停止。

默认情况下，该函数仅限超级用户使用，但可以授权给其他用户执行该函数。

pg_current_wal_flush_lsn () → pg_lsn

返回当前预写式日志刷新位置(参见下面的说明)。

pg_current_wal_insert_lsn () → pg_lsn

返回当前预式日志插入位置(参见下面的说明)。

pg_current_wal_lsn () → pg_lsn

返回当前预写式日志写位置(参见下面的说明)。

pg_backup_start ( label text [, fast boolean ] ) → pg_lsn

准备服务器开始在线备份。唯一必需的参数是备份的任意用户定义标签。 （通常这将是备份转储文件存储的名称。） 如果将可选的第二个参数指定为true， 它将尽快执行pg_backup_start。这将强制快速检查点， 这将导致I/O操作的激增，从而减慢任何同时执行的查询。

默认情况下，此函数仅限于超级用户，但可以授予其他用户执行权限以运行该函数。

pg_backup_stop ( [wait_for_archive boolean ] ) → record ( lsn pg_lsn, labelfile text, spcmapfile text )

完成在线备份。函数的结果中返回备份标签文件和表空间映射文件的期望内容，并必须写入备份区域的文件中。 这些文件不得写入实时数据目录（这样做将导致PostgreSQL在崩溃时无法重新启动）。

有一个类型为boolean的可选参数。 如果为false，则在备份完成后立即返回，而无需等待WAL进行归档。 此行为仅适用于独立监视WAL归档的备份软件。否则，可能会缺少使备份一致所需的WAL，使备份无效。 默认情况下或当此参数为true时，pg_backup_stop将在启用归档时等待WAL进行归档。 （在备库上，这意味着仅当archive_mode = always时才会等待。 如果主库上的写入活动较低，则可能有必要在主库上运行pg_switch_wal以触发立即段切换。）

在主库上执行时，此函数还会在预写式日志归档区域中创建一个备份历史文件。 历史文件包括给定给pg_backup_start的标签、备份的起始和结束预写式日志位置，以及备份的起始和结束时间。 在记录结束位置后，当前的预写式日志插入点会自动前进到下一个预写式日志文件，以便立即归档结束的预写式日志文件以完成备份。

函数的结果是一个记录。 lsn列保存备份的结束预写式日志位置（可以忽略）。 第二列返回备份标签文件的内容，第三列返回表空间映射文件的内容。 这些必须作为备份的一部分存储，并作为恢复过程的一部分。

默认情况下，此函数仅限于超级用户，但可以授予其他用户EXECUTE权限来运行该函数。

pg_switch_wal () → pg_lsn

强制服务器切换到一个新的预写式日志文件，这允许对当前文件进行归档(假设你正在使用连续归档)。 其结果是在刚刚完成的预写式日志文件中结束预写式日志位置加1。 如果自从上次预写式日志切换以来没有提前写日志活动，pg_switch_wal将不做任何操作，并返回当前正在使用的提前写日志文件的起始位置。

默认情况下该函数仅限超级用户使用，但可以授权其他用户执行该函数。

pg_walfile_name ( lsn pg_lsn ) → text

将预写式日志位置转换为保持该位置的WAL文件的名称。

pg_walfile_name_offset ( lsn pg_lsn ) → record ( file_name text, file_offset integer )

将预写式日志位置转换为WAL文件名和该文件中的字节偏移量。

pg_wal_lsn_diff ( lsn1 pg_lsn, lsn2 pg_lsn ) → numeric

计算两个预写式日志位置之间的字节(lsn1 - lsn2)差异。 这可以与pg_stat_replication或Table 9.99中所示的一些函数一起使用，以获得复制延迟。

pg_is_in_recovery () → boolean

如果恢复仍在进行则返回真。

pg_last_wal_receive_lsn () → pg_lsn

返回已接收并通过流复制同步到磁盘的最后一个预写式日志位置。 当流复制正在进行时这将单调地增加。如果恢复已经完成，那么在恢复期间，接收到的最后一条WAL记录的位置将保持静态，并同步到磁盘。 如果流复制已禁用，或者尚未启动，函数将返回NULL。

pg_last_wal_replay_lsn () → pg_lsn

返回恢复期间重新播放的最后一个预写式日志位置。如果恢复仍在进行中这将会单调地增加。 如果恢复已经完成，那么恢复期间应用的最后WAL记录的位置将保持静态。当服务器正常启动且没有恢复时，函数返回NULL。

pg_last_xact_replay_timestamp () → timestamp with time zone

返回恢复期间重放的最后一个事务的时间戳。这是在主库上为该事务生成提交或中止 WAL记录的时间。 如果在恢复期间没有重放任何事务，该函数将返回NULL。否则，如果恢复仍在进行中，这将单调地增加。 如果恢复已经完成，那么在恢复期间应用最后一个事务时，这将会保持静态。 当服务器正常启动且没有恢复时，函数返回NULL。

pg_get_wal_resource_managers () → setof record ( rm_id integer, rm_name text, rm_builtin boolean )

返回系统中当前加载的 WAL 资源管理器。列rm_builtin指示它是内置资源管理器还是由扩展加载的自定义资源管理器。

pg_is_wal_replay_paused () → boolean

如果请求了恢复暂停了则返回真。

pg_get_wal_replay_pause_state () → text

返回恢复暂停状态。 如果没有请求pause，返回值是not paused，如果请求暂停但恢复还没有暂停，返回值是pause requested，如果恢复实际已经暂停，返回值是paused。

pg_promote ( wait boolean DEFAULT true, wait_seconds integer DEFAULT 60 ) → boolean

将备库提升为主库状态。 当wait设置为true(默认值)时，函数将等待直到升级完成或wait_seconds秒数已过，如果升级成功则返回true，否则返回false。 如果wait设置为false，则该函数在向postmaster发送SIGUSR1信号以触发升级后立即返回true。

默认情况下这个函数仅限超级用户使用，但可以授权给其他用户执行该函数。

pg_wal_replay_pause () → void

请求暂停恢复。 请求不意味着恢复马上停止。 如果你想要保证恢复实际上是暂停的，你需要检查pg_get_wal_replay_pause_state()返回的恢复暂停状态。 注意，pg_is_wal_replay_paused()返回是否作出请求。 在恢复暂停时，不会应用进一步的数据库更改。 如果热备是激活的，所有新查询将看到相同的一致的数据库快照，并且在恢复继续之前不会生成进一步的查询冲突。

默认情况下该函数仅限超级用户使用，但可以授权其他用户执行该函数。

pg_wal_replay_resume () → void

如果暂停了，则重新启动恢复。

默认情况下该函数仅限超级用户使用，但可以授权其他用户执行该函数。

pg_export_snapshot () → text

保存事务的当前快照并返回text字符串以标识该快照。 必须将此字符串传递(在数据库之外)给希望导入快照的客户端。快照仅在导出它的事务结束之前才可用于导入。

如果需要的话，一个事务可以导出多个快照。 请注意，这样做仅在READ COMMITTED事务中有用，因为在REPEATABLE READ和更高的隔离级别中，事务在它们的生命周期中使用相同的快照。 一旦事务导出了快照，它就不能用 PREPARE TRANSACTION进行准备。

pg_create_physical_replication_slot ( slot_name name [, immediately_reserve boolean, temporary boolean ] ) → record ( slot_name name, lsn pg_lsn )

创建一个新的名为slot_name的物理复制槽。 槽名称不能是pg_conflict_detection，因为它保留给冲突检测槽。 第二个参数是可选的，当它为true时，立即为这个物理槽指定要被保留的LSN。 否则该LSN会被保留在来自一个流复制客户端的第一个连接上。 来自一个物理槽的流改变只可能出现在使用流复制协议时 — 见Section 54.4。 当可选的第三参数temporary被设置为真时，指定那个槽不会被持久地存储在磁盘上并且仅对当前会话的使用有意义。 临时槽也会在发生任何错误时被释放。这个函数对应于复制协议命令CREATE_REPLICATION_SLOT ... PHYSICAL。

pg_drop_replication_slot ( slot_name name ) → void

丢弃名为slot_name的物理或逻辑复制槽。 和复制协议命令DROP_REPLICATION_SLOT相同。对于逻辑槽， 在连接到在其中创建该槽的同一个数据库时，必须调用这个函数。

pg_create_logical_replication_slot ( slot_name name, plugin name [, temporary boolean, twophase boolean, failover boolean ] ) → record ( slot_name name, lsn pg_lsn )

创建一个名为slot_name的新逻辑（解码）复制插槽，使用输出插件plugin。槽名称不能是pg_conflict_detection，因为它保留给冲突检测槽。 可选的第三个参数temporary，当设置为true时，指定插槽不应永久存储到磁盘，仅供当前会话使用。临时插槽也会在任何错误发生时释放。可选的第四个参数twophase，当设置为true时，指定为此插槽启用已准备事务的解码。可选的第五个参数failover，当设置为true时，指定启用此插槽同步到备库，以便在故障切换后可以恢复逻辑复制。调用此函数的效果与复制协议命令CREATE_REPLICATION_SLOT ... LOGICAL相同。

pg_copy_physical_replication_slot ( src_slot_name name, dst_slot_name name [, temporary boolean ] ) → record ( slot_name name, lsn pg_lsn )

将一个名为src_slot_name的现有物理复制槽复制到一个名为dst_slot_name的物理复制槽。 新槽名称不能是pg_conflict_detection，因为它保留给冲突检测。 被复制的物理槽开始从与源槽相同的LSN开始保留WAL。temporary是可选的。 如果省略了temporary，则使用与源槽相同的值。

pg_copy_logical_replication_slot ( src_slot_name name, dst_slot_name name [, temporary boolean [, plugin name ]] ) → record ( slot_name name, lsn pg_lsn )

复制一个名为src_slot_name的现有逻辑复制槽到一个名为dst_slot_name的逻辑复制槽，选择性的改变输出插件和持久性。 新槽名称不能是pg_conflict_detection，因为它保留给冲突检测。 被复制的逻辑槽从与源逻辑槽相同的LSN开始。temporary和plugin都是可选的。 如果它们被省略了，使用与源逻辑槽相同的值。

pg_logical_slot_get_changes ( slot_name name, upto_lsn pg_lsn, upto_nchanges integer, VARIADIC options text[] ) → setof record ( lsn pg_lsn, xid xid, data text )

返回槽slot_name中的改变，从最后一次使用更改的点开始。 如果upto_lsn和upto_nchanges为 NULL，逻辑解码将一直继续到 WAL 的末尾。 如果upto_lsn为非 NULL，解码将只包括那些在指定 LSN 之前提交的事务。 如果upto_nchanges为非 NULL，解码将在其产生的行数超过指定值后停止。 不过要注意，被返回的实际行数可能更大，因为对这个限制的检查只会在增加了解码每个新的提交事务产生的行之后进行。

pg_logical_slot_peek_changes ( slot_name name, upto_lsn pg_lsn, upto_nchanges integer, VARIADIC options text[] ) → setof record ( lsn pg_lsn, xid xid, data text )

行为就像pg_logical_slot_get_changes()函数， 不过改变不会被消费， 即在未来的调用中还会返回这些改变。

pg_logical_slot_get_binary_changes ( slot_name name, upto_lsn pg_lsn, upto_nchanges integer, VARIADIC options text[] ) → setof record ( lsn pg_lsn, xid xid, data bytea )

行为就像pg_logical_slot_get_changes()函数， 不过改变会以bytea返回。

pg_logical_slot_peek_binary_changes ( slot_name name, upto_lsn pg_lsn, upto_nchanges integer, VARIADIC options text[] ) → setof record ( lsn pg_lsn, xid xid, data bytea )

行为就像pg_logical_slot_peek_changes()函数，不过改变会以bytea返回。

pg_replication_slot_advance ( slot_name name, upto_lsn pg_lsn ) → record ( slot_name name, end_lsn pg_lsn )

将复制槽的当前确认的位置提前到名为slot_name的复制槽的当前确认位置。 该槽不会向后移动，也不会移动到当前插入位置之外。返回该槽的名称和它被推进到的真实位置。 如果有任何进展，则在下一个检查点中写出更新后的槽位置信息。所以如果发生崩溃，该槽位可能会返回到之前的位置。如果指定的槽是逻辑故障切换槽，则在synchronized_standby_slots中指定的所有物理槽都确认已接收 WAL 之前，该函数不会返回。

pg_replication_origin_create ( node_name text ) → oid

用给定的外部名称创建一个复制源，并且返回分配给它的内部 ID。 该名称长度不得超过 512 字节。

pg_replication_origin_drop ( node_name text ) → void

删除一个以前创建的复制源，包括任何相关的重放进度。

pg_replication_origin_oid ( node_name text ) → oid

通过名称查找复制源并返回其内部ID。如果未找到这样的复制源，则返回 NULL。

pg_replication_origin_session_setup ( node_name text [, pid integer DEFAULT 0] ) → void

将当前会话标记为从给定的原点回放，从而允许跟踪回放进度。 只能在当前没有选择原点时使用。使用pg_replication_origin_session_reset 来撤销。 如果多个进程可以安全地使用同一个复制源（例如，并行应用进程），则可选的pid 参数可用于指定第一个进程的进程 ID。第一个进程必须提供pid等于 0，而共享同一复制源的其他进程应提供第一个进程的进程 ID。

pg_replication_origin_session_reset () → void

取消pg_replication_origin_session_setup()的效果。

pg_replication_origin_session_is_setup () → boolean

如果在当前会话中选择了复制源则返回真。

pg_replication_origin_session_progress ( flush boolean ) → pg_lsn

返回当前会话中选择的复制源的重放位置。参数flush决定对应的本地事务是否被确保已经刷入磁盘。

pg_replication_origin_xact_setup ( origin_lsn pg_lsn, origin_timestamp timestamp with time zone ) → void

将当前事务标记为重放在给定LSN和时间戳上提交的事务。 只能在使用pg_replication_origin_session_setup选择复制源时调用。

pg_replication_origin_xact_reset () → void

取消pg_replication_origin_xact_setup()的效果。

pg_replication_origin_advance ( node_name text, lsn pg_lsn ) → void

将给定节点的复制进度设置为给定的位置。这主要用于设置初始位置，或在配置更改或类似的变更后设置新位置。 请注意这个函数的不当使用可能会导致不一致的复制数据。

pg_replication_origin_progress ( node_name text, flush boolean ) → pg_lsn

返回给定复制元的重放位置。参数flush决定对应的本地事务是否被确保已经刷入磁盘。

pg_logical_emit_message ( transactional boolean, prefix text, content text ) → pg_lsn

pg_logical_emit_message ( transactional boolean, prefix text, content bytea ) → pg_lsn

发出逻辑解码消息。这可以用于通过WAL将通用消息传递给逻辑解码插件。 transactional参数指定消息是否应该是当前事务的一部分， 还是应该立即写入并在逻辑解码器读取记录时立即解码。 prefix参数是一个文本前缀，逻辑解码插件可以使用它轻松识别对它们有趣的消息。 content参数是消息的内容，可以以文本或二进制形式给出。

pg_sync_replication_slots () → void

将逻辑故障切换复制槽从主库同步到备库。此函数只能在备库上执行。 临时同步的槽（如果有）不能用于逻辑解码，必须在提升后删除。 此函数会循环重试，直到在函数调用开始时存在于主库上的所有故障切换槽都同步完成。 详见Section 47.2.3。 请注意，如果sync_replication_slots已启用且slotsync工作进程已在运行以执行槽同步，则无法执行此函数。

pg_column_size ( "any" ) → integer

显示用于存储任何单个数据值的字节数。如果直接应用于表的列值，则反映所做的任何压缩。

pg_column_compression ( "any" ) → text

显示用于压缩单个变长值的压缩算法。 如果值没有被压缩，则返回NULL。

pg_database_size ( name ) → bigint

pg_database_size ( oid ) → bigint

计算具有指定名称或OID的数据库使用的总磁盘空间。要使用此函数，您必须对指定数据库具有CONNECT权限 （默认情况下授予），或者具有pg_read_all_stats角色的权限。

pg_indexes_size ( regclass ) → bigint

计算附加到指定表的索引所使用的总磁盘空间。

pg_relation_size ( relation regclass [, fork text ] ) → bigint

计算指定关系的一个“fork”所使用的磁盘空间。 (注意在大多数情况下，使用更高级的函数 pg_total_relation_size或pg_table_size更方便，它们将所有分叉(forks)的大小相加。) 使用一个参数，这将返回关系的主数据分叉的大小。第二个参数可以用来指定要检查哪个分叉:

pg_size_bytes ( text ) → bigint

将人可阅读的格式的大小(由pg_size_pretty返回)转换为字节。

pg_size_pretty ( bigint ) → text

pg_size_pretty ( numeric ) → text

将字节大小转换为更易于人类阅读的格式，带有大小单位（字节，kB，MB，GB，TB或PB）。请注意，单位是2的幂，而不是10的幂，因此1kB是1024字节， 1MB是1024² = 1048576字节，依此类推。

pg_table_size ( regclass ) → bigint

计算指定表所使用的磁盘空间，不包括索引(但包括它的TOAST表，如果有的话，空闲空间映射，以及可见性映射)。

pg_tablespace_size ( name ) → bigint

pg_tablespace_size ( oid ) → bigint

计算具有指定名称或OID的表空间中使用的总磁盘空间。 要使用此函数，您必须对指定的表空间具有CREATE权限， 或者具有pg_read_all_stats角色的权限， 除非它是当前数据库的默认表空间。

pg_total_relation_size ( regclass ) → bigint

计算指定表所使用的总磁盘空间，包括所有索引和TOAST数据。 结果等价pg_table_size + pg_indexes_size。

pg_relation_filenode ( relation regclass ) → oid

返回当前分配给指定关系的“filenode”数字。文件节点是用于该关系的文件名称的基本组件(更多信息请参阅Section 66.1 )。 对于大多数关系，其结果与pg_class.relfilenode相同，但对于某些系统目录，relfilenode为0，并且必须使用这个函数来获得正确的值。 如果传递的是一个没有存储的关系，例如一个视图，那么函数将返回NULL。

pg_relation_filepath ( relation regclass ) → text

返回关系的完整文件路径名称（相对于数据库集簇的数据目录，即关系的PGDATA）。

pg_filenode_relation ( tablespace oid, filenode oid ) → regclass

返回一个给定表空间OID和存储它的文件节点的关系的OID。这本质上是pg_relation_filepath的反向映射。 对于数据库默认表空间中的关系，表空间可以指定为0。如果当前数据库中没有与给定值相关联的关系，则返回 NULL。

pg_collation_actual_version ( oid ) → text

返回当前安装在操作系统中的该排序规则对象的实际版本。 如果这个版本与pg_collation.collversion中的值不同，则依赖于该排序规则的对象可能需要被重建。 还可以参考ALTER COLLATION。

pg_database_collation_actual_version ( oid ) → text

返回数据库当前在操作系统中安装的排序规则的实际版本。如果这与pg_database.datcollversion中的值不同，则依赖于排序规则的对象可能需要重新构建。 参见ALTER DATABASE。

pg_import_system_collations ( schema regnamespace ) → integer

基于在操作系统中找到的所有区域环境(locales)，加入排序规则到系统目录pg_collation中。 这是 initdb 会用到的，更多细节请参考Section 23.2.2。 如果后来在操作系统上安装了额外的区域环境，可以再次运行这个函数加入新区域环境的排序规则。 匹配pg_collation中现有条目的区域环境将被跳过（但是这个函数不会移除以在操作系统中不再存在的区域环境为基础的排序规则对象）。 schema参数通常是pg_catalog，但这并非强制要求，排序规则也可以安装到其他模式中。 该函数返回其创建的新排序规则对象的数量。 此函数仅限超级用户使用。

pg_restore_relation_stats ( VARIADIC kwargs "any" ) → boolean

更新表级统计信息。通常这些统计信息由自动收集或作为VACUUM或ANALYZE的一部分更新，因此不必调用此函数。但它在恢复后很有用，可以在尚未运行ANALYZE时帮助优化器选择更好的计划。

被跟踪的统计信息可能因版本而异，所以参数以argname和argvalue对的形式传递：

SELECT pg_restore_relation_stats(
    'arg1name', 'arg1value'::arg1type,
    'arg2name', 'arg2value'::arg2type,
    'arg3name', 'arg3value'::arg3type);

例如，要设置表mytable的relpages和reltuples值：

SELECT pg_restore_relation_stats(
    'schemaname', 'myschema',
    'relname',    'mytable',
    'relpages',   173::integer,
    'reltuples',  10000::real);

参数schemaname和relname是必需的，用于指定表。其他参数是与pg_class中某些列对应的统计信息的名称和值。当前支持的关系统计信息包括：integer类型的relpages、real类型的reltuples、integer类型的relallvisible以及integer类型的relallfrozen。

此外，此函数还接受integer类型的参数名version，指定统计信息来源的服务器版本。这有助于从旧版本的PostgreSQL移植统计信息。

次要错误会以WARNING报告并被忽略，其余统计信息仍将被恢复。如果所有指定的统计信息都成功恢复，则返回true，否则返回false。

调用者必须对该表拥有MAINTAIN权限或者是数据库的所有者。

pg_clear_relation_stats ( schemaname text, relname text ) → void

清除给定关系的表级统计信息，就像该表是新创建的一样。

调用者必须对该表拥有MAINTAIN权限或者是数据库的所有者。

pg_restore_attribute_stats ( VARIADIC kwargs "any" ) → boolean

创建或更新列级统计信息。通常这些统计信息由自动收集或作为VACUUM或ANALYZE的一部分更新，因此不必调用此函数。但它在恢复后很有用，可以在尚未运行ANALYZE时帮助优化器选择更好的计划。

被跟踪的统计信息可能因版本而异，所以参数以argname和argvalue对的形式传递：

SELECT pg_restore_attribute_stats(
    'arg1name', 'arg1value'::arg1type,
    'arg2name', 'arg2value'::arg2type,
    'arg3name', 'arg3value'::arg3type);

例如，要设置表mytable的属性col1的avg_width和null_frac值：

SELECT pg_restore_attribute_stats(
    'schemaname', 'myschema',
    'relname',    'mytable',
    'attname',    'col1',
    'inherited',  false,
    'avg_width',  125::integer,
    'null_frac',  0.5::real);

必需的参数包括：text类型的schemaname和relname，用于指定表；text类型的attname或smallint类型的attnum，用于指定列；以及inherited，指定统计信息是否包含来自子表的值。其他参数是与pg_stats中的列对应的统计信息的名称和值。

此外，此函数还接受integer类型的参数名version，指定统计信息来源的服务器版本。这有助于从旧版本的PostgreSQL移植统计信息。

次要错误会以WARNING报告并被忽略，其余统计信息仍将被恢复。如果所有指定的统计信息都成功恢复，则返回true，否则返回false。

调用者必须对该表拥有MAINTAIN权限或者是数据库的所有者。

pg_clear_attribute_stats ( schemaname text, relname text, attname text, inherited boolean ) → void

清除给定关系和属性的列级统计信息，就像该表是新创建的一样。

调用者必须对该表拥有MAINTAIN权限或者是数据库的所有者。

pg_restore_extended_stats ( VARIADIC kwargs "any" ) → boolean

创建或更新统计对象的统计信息。通常这些统计会自动收集，或者作为VACUUM或ANALYZE的一部分更新，因此通常不必调用此函数。 不过，如果恢复后ANALYZE还没有运行，它可帮助优化器选择更好的计划。

被跟踪的统计信息可能会随版本变化，因此参数以argname和argvalue成对传入，格式如下：

 SELECT pg_restore_extended_stats(
    'arg1name', 'arg1value'::arg1type,
    'arg2name', 'arg2value'::arg2type,
    'arg3name', 'arg3value'::arg3type);

例如，要为统计对象myschema.mystatsobj设置一些值：

 SELECT pg_restore_extended_stats(
    'schemaname',            'tab_schema',
    'relname',               'tab_name',
    'statistics_schemaname', 'stats_schema',
    'statistics_name',       'stats_name',
    'inherited',             false,
    'n_distinct',            '[{"attributes" : [2,3], "ndistinct" : 4}]'::pg_ndistinct);
    'dependencies',          '{"2 => 1": 1.000000, "2 => -1": 1.000000, "2 => -2": 1.000000}'::pg_dependencies,
    'exprs',                 '[
                               {
                                   "avg_width": "4",
                                   "null_frac": "0.5",
                                   "n_distinct": "-0.75",
                                   "correlation": "-0.6",
                                   "histogram_bounds": "{-1,0}",
                                   "most_common_vals": "{1}",
                                   "most_common_elems": null,
                                   "most_common_freqs": "{0.5}",
                                   "elem_count_histogram": null,
                                   "most_common_elem_freqs": null
                               },
                               {
                                   "avg_width": "4",
                                   "null_frac": "0.25",
                                   "n_distinct": "-0.5",
                                   "correlation": "1",
                                   "histogram_bounds": null,
                                   "most_common_vals": "{2}",
                                   "most_common_elems": null,
                                   "most_common_freqs": "{0.5}",
                                   "elem_count_histogram": null,
                                   "most_common_elem_freqs": null
                               }
                              ]'::jsonb);

必需的参数包括：schemaname，值类型为name，用于指定统计信息关联的表的模式； relname，值类型为name，用于指定统计信息关联的表； statistics_schemaname，值类型为name，用于指定统计对象的模式； statistics_name，值类型为name，用于指定统计对象名称； 以及inherited，用于指定统计信息是否包含子表中的值。

其他参数是与pg_stats_ext中的列相对应的统计信息名称和值。 这个函数当前支持n_distinct、dependencies、most_common_vals、 most_common_freqs和most_common_base_freqs。要为扩展统计对象中的任何表达式接受统计信息， 可以使用类型为jsonb的参数exprs。它应该是一个一维数组，其表达式数量与扩展统计对象的定义相匹配， 由pg_stats_ext_exprs中每个统计列对应的 JSON 元素组成。

此外，此函数还接受类型为integer的参数名version，用于指定统计信息来源的服务器版本。 这有望帮助从较旧版本的PostgreSQL迁移统计信息。

次要错误会以WARNING报告并忽略，而剩余统计信息仍会被恢复。 如果所有指定统计信息都成功恢复，则返回true，否则返回false。

调用者必须对该表拥有MAINTAIN权限，或者是数据库的所有者。

pg_clear_extended_stats ( schemaname name, relname name, statistics_schemaname name, statistics_name name, inherited boolean ) → void

清空扩展统计对象的数据，就像该对象是新建的一样。必需的参数包括schemaname和relname， 用于指定要清空其统计信息的关系的模式和表名，以及statistics_schemaname和statistics_name， 用于指定要清空的扩展统计对象的模式和扩展统计名称。

调用者必须对该表拥有MAINTAIN权限，或者是数据库的所有者。

pg_partition_tree ( regclass ) → setof record ( relid regclass, parentrelid regclass, isleaf boolean, level integer )

列出给定分区表或分区索引的分区树中的表或索引，每行对应一个分区。 提供的信息包括分区的OID、其直接父的OID、一个布尔值以告知分区是否是叶子，以及一个整数用来告诉分区在层次结构中的级别。 对于输入表或索引，级别值为0，其直接子分区的为1，它们的分区为2，以此类推。 如果关系不存在，或者不是分区或分区表，则不返回行。

pg_partition_ancestors ( regclass ) → setof regclass

列出给定分区的祖先关系，包括关系本身。如果关系不存在，或者不是分区或分区表，则不返回行。

pg_partition_root ( regclass ) → regclass

返回给定关系所属的分区树的最顶级父节点。如果关系不存在，或者不是分区或分区表，则返回NULL。

brin_summarize_new_values ( index regclass ) → integer

扫描指定的BRIN索引以查找基表中当前没有被索引归纳的页面范围; 对于任何这样的范围，它都通过扫描这些表页来创建一个新的摘要索引元组。 返回插入到索引中的新页面范围摘要的数量。

brin_summarize_range ( index regclass, blockNumber bigint ) → integer

对覆盖给定块的页面范围执行摘要（如果尚未摘要）。 这类似于brin_summarize_new_values，只是它只处理覆盖给定表块数的页范围。

brin_desummarize_range ( index regclass, blockNumber bigint ) → void

删除归纳了覆盖给定表块的页面范围的BRIN索引元组，如果有的话。

gin_clean_pending_list ( index regclass ) → bigint

清理指定GIN索引的“pending”列表，通过移除里面的条目，以大批的方式，到主要的GIN数据结构。 返回从挂起列表中删除的页数。如果参数是使用禁用fastupdate选项构建的GIN索引，则不会发生清理，结果为零，因为索引没有挂起的列表。 关于挂起列表和fastupdate选项的详细信息，请参见Section 65.4.4.1 和 Section 65.4.5。

pg_ls_dir ( dirname text [, missing_ok boolean, include_dot_dirs boolean ] ) → setof text

返回指定目录中所有文件(和目录以及其他指定文件)的名称。 include_dot_dirs参数标示在结果集中是否包括“.” 和 “..”；默认为不包括它们。 要包括它们在missing_ok为 true时能够有用，以从不存在的目录中辨别一个空目录。

这个函数默认限制为超级用户，但是其他用户可以被授予EXECUTE以运行此函数。

pg_ls_logdir () → setof record ( name text, size bigint, modification timestamp with time zone )

返回服务器日志目录中每个普通文件的名称、大小和最后修改时间（mtime）。以点开头的文件名、目录和其他特殊文件将被排除。

默认情况下，此函数仅限于超级用户和具有pg_monitor角色权限的角色，但其他用户可以被授予EXECUTE权限来运行该函数。

pg_ls_waldir () → setof record ( name text, size bigint, modification timestamp with time zone )

返回服务器的预写式日志（WAL）目录中每个普通文件的名称、大小和最后修改时间（mtime）。 以点开头的文件名、目录和其他特殊文件将被排除。

默认情况下，此函数仅限于超级用户和具有pg_monitor角色权限的角色， 但其他用户可以被授予EXECUTE权限来运行该函数。

pg_ls_logicalmapdir () → setof record ( name text, size bigint, modification timestamp with time zone )

返回服务器的pg_logical/mappings目录中每个普通文件的名称、大小和最后修改时间（mtime）。 以点开头的文件名、目录和其他特殊文件将被排除。

默认情况下，此函数仅限于超级用户和pg_monitor角色的成员，但其他用户可以被授予EXECUTE权限来运行该函数。

pg_ls_logicalsnapdir () → setof record ( name text, size bigint, modification timestamp with time zone )

返回服务器的pg_logical/snapshots目录中每个普通文件的名称、大小和最后修改时间（mtime）。 以点开头的文件名、目录和其他特殊文件将被排除。

默认情况下，此函数仅限于超级用户和pg_monitor角色的成员，但其他用户可以被授予EXECUTE权限来运行该函数。

pg_ls_replslotdir ( slot_name text ) → setof record ( name text, size bigint, modification timestamp with time zone )

返回服务器的pg_replslot/slot_name目录中每个普通文件的名称、大小和最后修改时间（mtime）， 其中slot_name是作为函数输入提供的复制槽的名称。以点开头的文件名、目录和其他特殊文件将被排除。

默认情况下，此函数仅限于超级用户和pg_monitor角色的成员，但其他用户可以被授予EXECUTE权限来运行该函数。

pg_ls_archive_statusdir () → setof record ( name text, size bigint, modification timestamp with time zone )

返回服务器的WAL归档状态目录(pg_wal/archive_status)中的每个普通文件的名称、大小、和最后修改时间(mtime)。 文件名以一个点(dot)开始，目录和其他指定的文件不包括。

这个函数默认限制在超级用户和pg_monitor角色的成员，但是其他用户可以被授予EXECUTE以运行此函数。

pg_ls_tmpdir ( [ tablespace oid ] ) → setof record ( name text, size bigint, modification timestamp with time zone )

返回针对指定tablespace的临时文件目录中的每个普通文件的名称、大小、和最后修改时间(mtime)。 如果tablespace没有提供，pg_default 表空间为被检验的。 文件名以一个点(dot)开始，目录和其他指定的文件不包括。

这个函数默认限制在超级用户和pg_monitor角色的成员，但是其他用户可以被授予EXECUTE以运行此函数。

pg_read_file ( filename text [, offset bigint, length bigint [, missing_ok boolean ]] ) → text

返回一个文本文件的全部或部分，开始于给定的字节offset，在最大的length字节返回（如果文件的结尾先达到了则减少）。 如果offset为负，他于文件的结尾有关。如果offset和length 被省略，整个文件被返回。 从文件中读的字节在服务器的编码中解释为字符串；如果它们在哪些编码中不是有效的则抛出错误。

这个函数默认限制在超级用户，但是其他用户可以被授予EXECUTE以运行此函数。

pg_read_binary_file ( filename text [, offset bigint, length bigint [, missing_ok boolean ]] ) → bytea

返回文件的全部或部分。这个函数与pg_read_file 是完全相同的，除了它可以读任意的二进制数据，返回结果为bytea而不是text； 因此，没有编码检查会被执行。

这个函数默认限制在超级用户，但是其他用户可以被授予EXECUTE以运行此函数。

与 convert_from函数组合，这个函数能被用于以指定的编码读文本文件并转换到数据库的编码：

SELECT convert_from(pg_read_binary_file('file_in_utf8.txt'), 'UTF8');

pg_stat_file ( filename text [, missing_ok boolean ] ) → record ( size bigint, access timestamp with time zone, modification timestamp with time zone, change timestamp with time zone, creation timestamp with time zone, isdir boolean )

返回一个记录，包含文件的大小、最后访问时间戳、最后修改时间戳，最后文件状态变更时间戳(仅在UNIX平台)、文件建立时间戳(仅Windows)，和一个标志旗如果它是一个目录。

这个函数默认限制在超级用户，但是其他用户可以被授予EXECUTE以运行此函数。

pg_advisory_lock ( key bigint ) → void

pg_advisory_lock ( key1 integer, key2 integer ) → void

获取一个排他的会话级咨询锁，如有必要则等待。

pg_advisory_lock_shared ( key bigint ) → void

pg_advisory_lock_shared ( key1 integer, key2 integer ) → void

获取一个共享的会话级咨询锁，如有必要则等待。

pg_advisory_unlock ( key bigint ) → boolean

pg_advisory_unlock ( key1 integer, key2 integer ) → boolean

释放以前获取的排他会话级咨询锁。如果锁成功释放则返回true。 如果锁没有被持有，则返回false，此外，服务器将报告一个SQL警告。

pg_advisory_unlock_all () → void

释放当前会话所持有的所有会话级咨询锁。(即使客户端异常断开连接，这个函数也会在会话结束时被隐式调用。)

pg_advisory_unlock_shared ( key bigint ) → boolean

pg_advisory_unlock_shared ( key1 integer, key2 integer ) → boolean

释放以前获取的共享会话级咨询锁。如果锁成功释放则返回true。 如果锁没有被持有，则返回false，此外，服务器将报告一个SQL警告。

pg_advisory_xact_lock ( key bigint ) → void

pg_advisory_xact_lock ( key1 integer, key2 integer ) → void

获取一个排他的事务级咨询锁，如有必要则等待。

pg_advisory_xact_lock_shared ( key bigint ) → void

pg_advisory_xact_lock_shared ( key1 integer, key2 integer ) → void

获取一个共享的事务级咨询锁，如有必要则等待。

pg_try_advisory_lock ( key bigint ) → boolean

pg_try_advisory_lock ( key1 integer, key2 integer ) → boolean

获取一个排他的会话级咨询锁，如果适用。 这将立即获得锁并返回true，或者如果不能立即获取锁则立即返回 false而无需等待。

pg_try_advisory_lock_shared ( key bigint ) → boolean

pg_try_advisory_lock_shared ( key1 integer, key2 integer ) → boolean

获取一个共享的会话级咨询锁，如果适用。 这将立即获得锁并返回true，或者如果不能立即获取锁则立即返回 false而无需等待。

pg_try_advisory_xact_lock ( key bigint ) → boolean

pg_try_advisory_xact_lock ( key1 integer, key2 integer ) → boolean

获取一个排他的事务级咨询锁，如果适用。 这将立即获得锁并返回true，或者如果不能立即获取锁则立即返回 false而无需等待。

pg_try_advisory_xact_lock_shared ( key bigint ) → boolean

pg_try_advisory_xact_lock_shared ( key1 integer, key2 integer ) → boolean

获取一个共享的事务级咨询锁，如果适用。 这将立即获得锁并返回true，或者如果不能立即获取锁则立即返回 false而无需等待。

pg_enable_data_checksums ( [cost_delay int, cost_limit int] ) → void

启动为集簇启用数据校验和的过程。这会把数据校验和状态设置为inprogress-on， 并启动一个后台工作进程来处理所有数据库中的所有页并为其启用数据校验和。当所有页都处理完后，集簇会自动把数据校验和状态设置为on。 该操作会写入 WAL，并复制到所有备库。

如果指定了cost_delay和cost_limit，则会以与 基于代价的清理延迟相同的原则对该过程进行限速。

pg_disable_data_checksums () → void

为集簇禁用数据校验和的计算与验证。这会在数据校验和被禁用期间把状态设置为inprogress-off。 当所有活动后端都停止验证数据校验和后，数据校验和状态将被设置为off。