pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
这些配置参数提供了一种较为粗糙的方法，用于影响查询优化器所选择的查询计划。 如果优化器为某个特定查询选择的默认计划并不理想，一种临时解决方案是使用这些配置参数， 强制优化器选择另一种计划。 改善优化器所选计划质量的更好办法包括调整规划器代价常数 （见第 19.7.2 节）、手工运行 ANALYZE、增加 default_statistics_target 配置参数的值，以及使用 ALTER TABLE SET STATISTICS 增加为特定列收集的统计信息量。
enable_bitmapscan (boolean) #启用或禁用查询规划器对位图扫描计划类型的使用。默认值为 on。
enable_hashagg (boolean) #启用或禁用查询规划器对哈希聚合计划类型的使用。默认值为 on。
enable_hashjoin (boolean) #启用或禁用查询规划器对哈希连接计划类型的使用。默认值为 on。
enable_indexscan (boolean) #启用或禁用查询规划器对索引扫描计划类型的使用。默认值为 on。
enable_indexonlyscan (boolean) #启用或禁用查询规划器对仅索引扫描计划类型的使用（参见 第 11.11 节）。默认值为 on。
enable_material (boolean) #允许或者禁止查询规划器使用物化。它不可能完全禁用物化，但是关闭这个变量将阻止规划器插入物化节点，除非为了保证正确性。默认值是on。
enable_mergejoin (boolean) #启用或禁用查询规划器对归并连接计划类型的使用。默认值为 on。
enable_nestloop (boolean) #允许或禁止查询规划器使用嵌套循环连接计划。它不可能完全禁止嵌套循环连接，但是关闭这个变量将使得规划器尽可能优先使用其他方法。默认值是on。
enable_seqscan (boolean) #允许或禁止查询规划器使用顺序扫描计划类型。它不可能完全禁止顺序扫描，但是关闭这个变量将使得规划器尽可能优先使用其他方法。默认值是on。
enable_sort (boolean) #允许或禁止查询规划器使用显式排序步骤。它不可能完全禁止显式排序，但是关闭这个变量将使得规划器尽可能优先使用其他方法。默认值是on。
enable_tidscan (boolean) #允许或禁止查询规划器使用TID扫描计划类型。默认值是on。
这一节中描述的代价变量可以按照任意尺度衡量。我们只关心它们的相对值，将它们以相同的因子缩放不会影响规划器的选择。默认情况下，这些代价变量是基于顺序页面获取的代价的，即seq_page_cost被设置为1.0并且其他代价变量都参考它来设置。不过你可以使用你喜欢的不同尺度，例如在一个特定机器上以毫秒为单位的实际执行时间。
没有明确的方法可以确定代价变量的理想值。最好将它们视为某个数据库安装实例所接收的全部查询组合的平均值。因此，仅凭少数几次试验就修改它们是非常冒险的。
seq_page_cost (floating point) #设置规划器对一系列顺序磁盘页面读取中单次读取的代价估计。默认值是 1.0。对于某个表空间内的表和索引，可以通过设置该表空间的同名参数来覆盖此值（见ALTER TABLESPACE）。
random_page_cost (floating point) #设置规划器对一次非顺序磁盘页面读取的代价估计。默认值是 4.0。对于某个表空间内的表和索引，可以通过设置该表空间的同名参数来覆盖此值（见ALTER TABLESPACE）。
减少这个值（相对于seq_page_cost）将导致系统更倾向于索引扫描；提高它将让索引扫描看起来相对更昂贵。你可以一起提高或降低两个值来改变磁盘 I/O 代价相对于 CPU 代价的重要性，后者由下列参数描述。
对机械磁盘存储的随机访问通常远不止比顺序访问贵四倍。不过，仍使用较低的默认值（4.0）， 因为假定对磁盘的大多数随机访问（例如索引读取）都将在缓存中命中。 可以将默认值理解为：假设随机访问比顺序访问慢 40 倍，同时预期 90% 的随机读取能够命中缓存。
如果你认为 90% 的缓存命中率不符合你的工作负载，可以增大 random_page_cost，以更好地反映随机存储读取的真实代价。 对应地，如果你的数据很可能完全缓存在内存中，例如数据库小于服务器总内存，则降低 random_page_cost 可能更合适。 对于随机读取代价相对于顺序读取较低的存储，例如固态硬盘，也可以用较低的 random_page_cost 值来更好地建模，例如1.1。
尽管系统允许将random_page_cost设置得小于seq_page_cost，但这不符合实际物理情况。不过，如果数据库完全缓存在 RAM 中，将它们设置为相等是合理的，因为此时非顺序访问页面不会产生额外代价。同样，对于大部分数据已缓存的数据库，应相对于 CPU 参数降低这两个值，因为读取一个已在 RAM 中的页面的代价远小于通常的页面读取代价。
cpu_tuple_cost (floating point) #设置规划器对一次查询中处理每一行的代价估计。默认值是 0.01。
cpu_index_tuple_cost (floating point) #设置规划器对一次索引扫描中处理每一个索引项的代价估计。默认值是 0.005。
cpu_operator_cost (floating point) #设置规划器对于一次查询中处理每个操作符或函数的代价估计。默认值是 0.0025。
parallel_setup_cost (floating point) #设置规划器对启动并行工作进程的代价估计。默认是 1000。
parallel_tuple_cost (floating point) #设置规划器对于从一个并行工作进程传递一个元组给另一个进程的代价估计。默认是 0.1。
min_parallel_relation_size (integer) #设置为并行扫描所考虑的关系的最小尺寸。 默认值是8兆字节（8MB）。
effective_cache_size (integer) #设置规划器对一个单一查询可用的有效磁盘缓存尺寸的假设。 这个参数会被考虑在使用一个索引的代价估计中，更高的数值会使得索引扫描更可能被使用，更低的数值会使得顺序扫描更可能被使用。 在设置这个参数时，你还应该考虑PostgreSQL的共享缓冲区以及将被用于PostgreSQL数据文件的内核磁盘缓存，尽管有些数据可能在两个地方都存在。 另外，还要考虑预计在不同表上的并发查询数目，因为它们必须共享可用的空间。 这个参数对PostgreSQL分配的共享内存尺寸没有影响，它也不会预留内核磁盘缓存，它只用于估计的目的。系统也不会假设在查询之间数据会保留在磁盘缓存中。 默认值是 4吉字节（4GB）。
遗传查询优化器（GEQO）是一种使用启发式搜索进行查询规划的算法。它可以缩短复杂查询（连接很多关系的查询）的规划时间，代价是生成的计划有时不如常规穷举搜索算法找到的计划。更多信息见第 58 章。
geqo (boolean) #允许或禁止遗传查询优化。默认是启用。在生产环境中通常最好不要关闭它。geqo_threshold变量提供了对 GEQO 更细粒度的控制。
geqo_threshold (integer) #只有当涉及的FROM项数量至少有这么多个的时候，才使用遗传查询优化（注意一个FULL OUTER JOIN只被计为一个FROM项）。默认值是 12。对于更简单的查询，通常会使用普通的穷举搜索规划器，但是对于有很多表的查询穷举搜索会花很长时间，通常比执行一个次优的计划带来的惩罚值还要长。因此，在查询尺寸上的一个阈值是管理 GEQO 使用的一种方便的方法。
geqo_effort (integer) #控制 GEQO 中规划时间和查询计划质量之间的权衡。此变量必须是 1 到 10 之间的整数。默认值是 5。较大的值会增加查询规划所用的时间，但也会提高选择高效查询计划的可能性。
geqo_effort实际并不直接做任何事情；它只是被用来计算其他影响 GEQO 行为的变量（如下所述）的默认值。如果你愿意，你可以手工设置其他参数。
geqo_pool_size (integer) #控制 GEQO 使用的池尺寸，它就是遗传种群中的个体数目。它必须至少为 2，且有用的值通常在 100 到 1000 之间。如果它被设置为零（默认设置）则会基于geqo_effort和查询中表的数量选择一个合适的值。
geqo_generations (integer) #控制 GEQO 使用的代数，即算法的迭代次数。它必须至少为 1，通常有用的值与池大小处于相同范围。如果设置为零（默认设置），则根据geqo_pool_size选择合适的值。
geqo_selection_bias (floating point) #控制 GEQO 使用的选择偏好。选择偏好是种群中的选择压力。值可以是 1.5 到 2.0 之间，后者是默认值。
geqo_seed (floating point) #控制 GEQO 使用的随机数生成器的初始值，随机数生成器用于在连接顺序搜索空间中选择随机路径。该值可以从 0 （默认值）到 1。变化该值会改变被探索的连接路径集合，并且可能使找到的最优路径变得更好或更差。
default_statistics_target (integer) #为没有通过ALTER TABLE SET STATISTICS设置列相关目标的表列设置默认统计目标。更大的值增加了需要做ANALYZE的时间，但是可能会改善规划器的估计质量。默认值是 100。有关PostgreSQL查询规划器使用的统计信息的更多内容， 请参考第 14.2 节。
constraint_exclusion (enum) #控制查询规划器对表约束的使用，以优化查询。 constraint_exclusion的允许值是on（对所有表检查约束）、off（从不检查约束）和partition（只对继承的子表和UNION ALL子查询检查约束）。 partition是默认设置。它通常与继承和分区表一起使用来提高性能。
当此参数允许对某个表使用约束排除时，规划器会比较查询条件与该表的CHECK约束，并且忽略那些条件违反约束的表扫描。例如：
CREATE TABLE parent(key integer, ...); CREATE TABLE child1000(check (key between 1000 and 1999)) INHERITS(parent); CREATE TABLE child2000(check (key between 2000 and 2999)) INHERITS(parent); ... SELECT * FROM parent WHERE key = 2400;
在启用约束排除时，这个SELECT将完全不会扫描child1000，从而提高性能。
目前，约束排除仅在通常用于实现表分区的情况下默认启用。 为所有表启用它会增加额外的规划开销，这在简单查询上相当明显，而且通常不会为简单查询带来好处。 如果没有分区表，你可能希望完全关闭它。
更多关于使用约束排除实现分区的信息请参阅第 5.10.4 节。
cursor_tuple_fraction (floating point) #设置规划器对将被检索的一个游标的行的比例的估计。默认值是 0.1。更小的值使得规划器偏向为游标使用“快速开始”计划，它将很快地检索前几行但是可能需要很长时间来获取所有行。更大的值强调总的估计时间。最大设置为 1.0，游标将和普通查询完全一样地被规划，只考虑总估计时间并且不考虑前几行会被多快地返回。
from_collapse_limit (integer) #如果生成的FROM列表不超过这么多项，规划器将把子查询融合到上层查询。较小的值可以减少规划时间，但是可能 会生成较差的查询计划。默认值是 8。详见第 14.3 节。
将这个值设置为geqo_threshold或更大，可能触发使用 GEQO 规划器，从而产生非最优计划。见第 19.7.3 节。
join_collapse_limit (integer) #如果得出的列表中不超过这么多项，那么规划器将把显式JOIN（除了FULL JOIN）结构重写到 FROM项列表中。较小的值可减少规划时间，但是可能会生成差些的查询计划。
默认情况下，这个变量被设置成和from_collapse_limit相同， 这样适合大多数使用。把它设置为 1 可避免任何显式JOIN的重排序。因此查询中指定的显式连接顺序就是关系被连接的实际顺序。因为查询规划器并不是总能 选取最优的连接顺序，高级用户可以选择暂时把这个变量设置为 1，然后显式地指定他们想要的连接顺序。更多信息请见第 14.3 节。
将这个值设置为geqo_threshold或更大，可能触发使用 GEQO 规划器，从而产生非最优计划。见第 19.7.3 节。
force_parallel_mode (enum) #允许为测试目的使用并行查询，即使预期不会带来性能收益。 force_parallel_mode允许的值包括 off（仅在预期能提高性能时使用并行模式）、 on（对所有被认为可以安全并行的查询强制使用并行查询），以及 regress（类似于on，但还有下文说明的额外行为变化）。
更具体地说，将此值设置为on会在任何看起来可以安全并行的查询计划顶部添加一个Gather节点， 让查询在并行工作进程中运行。即使没有可用的并行工作进程或无法使用并行工作进程， 在并行查询上下文中不允许的操作（例如启动子事务）也会被禁止，除非规划器认为这会使查询失败。 如果设置此选项后出现失败或意外结果，查询使用的某些函数可能需要被标记为PARALLEL UNSAFE （也可能是PARALLEL RESTRICTED）。
将此值设置为regress具有设置为on的所有效果，另外还有一些旨在方便自动回归测试的效果。 通常，来自并行工作进程的消息会包含一行说明这一点的上下文信息，但regress设置会抑制此行，使输出与非并行执行时相同。 此外，此设置添加到计划中的Gather节点会在EXPLAIN输出中隐藏， 使输出与此设置为off时的输出一致。
译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。