pg_stash_advice 扩展允许你将 计划建议 字符串存储在动态共享内存中，以便自动应用。 建议存储 是从 查询标识符到计划建议字符串的映射。 每当某个会话需要为其查询 ID 出现在相应建议存储中的查询生成计划时，系统就会自动应用该计划建议字符串来指导规划。 请注意，建议存储保存在动态分配的共享内存中。 这意味着，在决定要存储多少计划建议时，需要注意内存消耗。 另外，建议存储及其内容可以自动持久化到磁盘，并在之后从磁盘重新加载；见下面的 pg_stash_advice.persist。

要使用此模块，你需要至少在一个数据库中执行 CREATE EXTENSION pg_stash_advice，这样才能获得用于管理建议存储的 SQL 函数。 你还需要在所有希望该模块自动应用建议的会话中加载 pg_stash_advice 模块。 通常，最好的做法是将 pg_stash_advice 添加到 shared_preload_libraries，然后重启服务器。

在满足上述条件后，你可以使用下面介绍的 pg_create_advice_stash 函数创建建议存储， 并使用 pg_set_stashed_advice 函数为给定存储中的某个查询 ID 设置计划建议。 然后，你只需要将 pg_stash_advice.stash_name 配置为指向所选建议存储的名称即可。 对于某些用例，与其在系统范围内设置它，不如使用 ALTER DATABASE ... SET 或 ALTER ROLE ... SET 来配置只适用于某个数据库或某个角色的值，这会更有帮助。 同样，有时也可以通过在特定会话中使用 SET 来设置存储名称。

由于 pg_stash_advice 是基于查询标识符工作的，你需要为每个希望控制其计划的查询确定查询标识符。 你还需要确定希望为每个查询存储的建议字符串。 一种做法是使用 EXPLAIN：VERBOSE 选项会显示查询 ID，PLAN_ADVICE 选项会显示计划建议。 查询标识符也可以通过 pg_stat_statements 或 Section 27.2.3 等工具获取，但这些工具不会提供计划建议字符串。 请注意，必须启用 compute_query_id，才能计算查询标识符； 如果将其设置为 auto，加载 pg_stash_advice 时会自动启用它。

一般来说，规划器能够随着底层数据分布的变化而改变查询计划，这是一项特性，而不是缺陷。 此外，即使计划建议最终没有导致查询计划发生变化，应用它也可能带来明显的性能开销。 因此，最好只在需要时、并且仅在必要范围内使用这一特性。 计划建议字符串可以精简到只包含需要控制的计划方面，并且只用于那些被认为存在显著规划器出错风险的查询。

请注意，pg_stash_advice 目前缺乏完善的安全模型。 只有超级用户，或者超级用户已对相关函数授予 EXECUTE 权限的用户，才可以创建建议存储或修改其内容； 但任何用户都可以为其会话设置 pg_stash_advice.stash_name，这可能会暴露该名称对应的建议存储内容。 用户应当假定，存储在建议字符串中的信息可能会对非特权用户可见。