本页面介绍了 AlloyDB for PostgreSQL 用于启用和管理 AlloyDB 所独有的各种服务功能的数据库标志。如需查看 AlloyDB 支持的所有数据库标志的列表，请参阅支持的数据库标志。
标有实例重启的标志表示每当您对某个实例设置、移除或修改此标志时，AlloyDB 都会重启该实例。除非您再次修改，否则标志值会在实例中一直保留。
alloydb.audit_log_line_prefix
| 类型 | string |
| 默认 | "%m [%p]: [%l-1] db=%d,user=%u |
| 实例重启 | 是 |
控制作为每个审核日志行前缀的信息。如果留空，则表示不使用前缀。
alloydb.enable_pgaudit
| 类型 | boolean |
| 默认 | off |
| 实例重启 | 是 |
控制是否可在 AlloyDB 实例中使用 pgaudit 扩展程序。将该参数设置为 on 并重启实例。然后使用 CREATE
EXTENSION 命令将 pgaudit 扩展程序添加到实例中的各个数据库。
pgaudit 扩展程序使用 PostgreSQL 提供的标准日志记录功能来提供详细的会话和对象审核日志记录。
alloydb.enable_auto_explain
| 类型 | boolean |
| 默认 | off |
| 实例重启 | 是 |
控制是否可在 AlloyDB 实例中使用 auto_explain 扩展程序。将该参数设置为 on 并重启实例。
auto_explain 扩展程序可启用慢速语句执行计划的自动日志记录功能，以便进行问题排查等。它提供了一种自动执行 EXPLAIN 命令功能的方法。
alloydb.enable_pg_bigm
| 类型 | boolean |
| 默认 | off |
| 实例重启 | 是 |
控制是否可在 AlloyDB 实例中使用 pg_bigm 扩展程序。将该参数设置为 on 并重启实例。然后使用 CREATE
EXTENSION 命令将 pg_bigm 扩展程序添加到实例中的各个数据库。
pg_bigm 扩展程序使用 2-gram（二元语法）索引在 PostgreSQL 中提供全文搜索功能，以加快全文搜索速度。
alloydb.enable_pg_cron
| 类型 | boolean |
| 默认 | off |
| 实例重启 | 是 |
控制是否可在 AlloyDB 实例中使用 pg_cron 扩展程序。将该参数设置为 on 并重启实例。然后使用 CREATE
EXTENSION 命令将 pg_cron 扩展程序添加到实例中的各个数据库。
pg_cron 扩展程序为 PostgreSQL 提供一个基于 Cron 的作业调度器，该调度器以扩展程序的形式在数据库内运行。它使用与常规 cron 相同的语法，可让您直接从数据库调度 PostgreSQL 命令。
alloydb.enable_pg_hint_plan
| 类型 | boolean |
| 默认 | off |
| 实例重启 | 是 |
控制是否可在 AlloyDB 实例中使用 pg_hint_plan 扩展程序。将该参数设置为 on 并重启实例。然后，使用 CREATE EXTENSION 命令将 pg_hint_plan 扩展程序添加到实例中的各个数据库。
pg_hint_plan 扩展程序让您可以使用提示来改进 PostgreSQL 执行计划，提示是 SQL 注释中的说明。
alloydb.enable_pg_wait_sampling
| 类型 | boolean |
| 默认 | off |
| 实例重启 | 是 |
让 AlloyDB 可以收集等待事件的采样统计信息。将该参数设置为 on 并重启实例。然后，使用 CREATE EXTENSION 命令将 pg_wait_sampling 扩展程序添加到实例中的各个数据库。
pg_wait_sampling 扩展程序会聚合并汇总等待事件数据。您可以查询这些视图，以深入了解不同等待事件的等待时间、频率和相对重要性。
alloydb.enable_pglogical
| 类型 | boolean |
| 默认 | off |
| 实例重启 | 是 |
控制是否可在 AlloyDB 实例中使用 pglogical 扩展程序。将该参数设置为 on 并重启实例。然后，使用 CREATE EXTENSION 命令将 pglogical 扩展程序添加到实例中的各个数据库。
pglogical 扩展程序会使用基于发布和订阅的模型为 PostgreSQL 提供逻辑流式复制。
alloydb.iam_authentication
| 类型 | boolean |
| 默认 | off |
| 实例重启 | 是 |
允许将 Identity and Access Management (IAM) 身份验证与 AlloyDB 实例搭配使用。
alloydb.logical_decoding
| 类型 | boolean |
| 默认 | off |
| 实例重启 | 是 |
可在 AlloyDB 实例中启用 PostgreSQL 逻辑解码基础设施。
逻辑解码会提供向外部使用方流式传输数据修改所需的基础设施。
alloydb.log_throttling_window
| 类型 | integer |
| 默认 | 0 |
| 实例重启 | 否 |
控制 AlloyDB 是否记录在指定时段内收到的重复日志消息。
如果设置的值大于 0，则 AlloyDB 会在每次记录日志消息时启动一个时长为该值对应秒数的计时器。如果 AlloyDB 在计时器到期前收到相同的日志消息，则不会记录该消息。计时器到期后，AlloyDB 会将所有跳过的消息数量附加到它所记录的下一个相同日志消息。
如果设置为 0，AlloyDB 会记录所有重复的日志消息。
alloydb.promote_cancel_to_terminate
| 类型 | boolean |
| 默认 | off |
| 实例重启 | 否 |
如果设置为 true，则在 AlloyDB 遇到由于锁定超时、语句超时和恢复（重放）冲突等问题所导致的任何查询取消请求时，这类请求都会提升为强制后端终止请求。
通过提升取消请求，AlloyDB 可帮助防止卡住的后端阻碍日志重放和其他后端。
alloydb.pg_shadow_select_role
| 类型 | string |
| 默认 | 一个空白字符串 |
| 实例重启 | 否 |
用于授予查询 pg_shadow 视图权限的 PostgreSQL 角色的名称。
alloydb_password
| 类型 | string |
| 默认 | 一个空白字符串 |
| 实例重启 | 否 |
提供用于为 AlloyDB Omni 设置和管理密码政策的函数。如果应用的数据库用户使用基于密码的内置方法向 AlloyDB Omni 进行身份验证，则您可以通过强制使用安全系数高的密码来提高身份验证的安全性。
如需了解详情，请参阅使用密码政策管理内置身份验证。
alloydb_scann
| 类型 | string |
| 默认 | 一个空白字符串 |
| 实例重启 | 否 |
提供使 AlloyDB Omni 能够以高性能和高效率处理向量搜索工作负载的函数。
如需了解详情，请参阅创建索引和查询向量。
alloydb_ai_nl
| 类型 | string |
| 默认 | 一个空白字符串 |
| 实例重启 | 否 |
提供让您可以使用自然语言安全地查询 AlloyDB 的函数。该扩展程序与 parameterized_views 扩展程序配合使用，后者会为您的数据强制实施安全防护层。
如需了解详情，请参阅使用自然语言生成 SQL 查询。
parameterized_views
| 类型 | string |
| 默认 | 一个空白字符串 |
| 实例重启 | 否 |
提供可在将自然语言查询转换为 SQL 查询时添加安全防护层的函数。此扩展程序与 alloydb_ai_nl 扩展程序配合使用。
如需了解详情，请参阅使用自然语言生成 SQL 查询。
alloydb_ai_nl.enabled
| 类型 | boolean |
| 默认 | off |
| 实例重启 | 是 |
控制是否启用 AlloyDB AI 自然语言功能。
scann.enable_preview_features
| 类型 | boolean |
| 默认 | off |
| 实例重启 | 是 |
允许使用预览版中提供的以下功能：
* 自动索引维护：逐步管理索引，以便在数据集不断增长时，AlloyDB Omni 会拆分大型离群值分区并尝试提供更好的 QPS 和搜索结果。 * 延迟创建索引：延迟为空行或行数不足的表创建索引。 * 四级树索引支持包含超过 10 亿个向量行的表。scann.enable_index_maintenance
| 类型 | boolean |
| 默认 | on |
| 实例重启 | 是 |
控制是否启用自动矢量索引维护功能。
scann.max_background_workers
| 类型 | integer |
| 默认 | 1 |
| 实例重启 | 是 |
控制用于自动向量索引维护的后台工作器的数量。如需了解详情，请参阅提高自动维护吞吐量。
scann.maintenance_background_naptime_s
| 类型 | integer |
| 默认 | 1 |
| 实例重启 | 是 |
控制后台工作器运行之间用于自动维护向量索引的最短延迟时间。默认值为 1 分钟。
scann.max_allowed_num_levels
| 类型 | integer |
| 默认 | 2 |
| 最小值 | 1 |
| 最大值 | 3 |
| 实例重启 | 否 |
用于确定创建 ScaNN 索引时可为 max_num_levels 设置的最高值。
parameterized_views.enabled
| 类型 | boolean |
| 默认 | off |
| 实例重启 | 是 |
控制是否启用参数化视图功能。
parameterized_views.enabled 标志设置不会自动复制，必须在每个实例上手动复制。您必须先在每个副本实例上启用 parameterized_views.enabled 标志，然后才能在副本上查询参数化视图。如需了解详情，请参阅使用 AlloyDB Omni 参数化安全视图管理应用数据安全。
parameterized_views.json_results_max_rows
| 类型 | integer |
| 默认 | 1,000,000 |
| 实例重启 | 否 |
设置 execute_parameterized_query() 函数返回的 JSON 结果的行数上限。
parameterized_views.json_results_max_size
| 类型 | integer |
| 默认 | 1,048,576 |
| 实例重启 | 否 |
设置 execute_parameterized_query() 函数返回的 JSON 结果的大小上限（以 KB 为单位）。
parameterized_views.max_parallel_workers_per_gather
| 类型 | integer |
| 默认 | -1 |
| 实例重启 | 否 |
设置使用参数化视图 API 运行查询时每个执行器节点的最大并行进程数。-1 表示无限制。此限制仅在比 max_parallel_workers_per_gather 更严格时适用。
parameterized_views.statement_timeout
| 类型 | integer |
| 默认 | 0 |
| 实例重启 | 否 |
设置使用参数化视图 API 运行的语句的最长允许时长（以毫秒为单位）。0 表示无限制。此限制仅在比 statement_timeout 更严格时适用。
parameterized_views.temp_file_limit
| 类型 | integer |
| 默认 | -1 |
| 实例重启 | 否 |
限制每个进程在使用参数化视图 API 运行时所用所有临时文件的总大小（以 kB 为单位）。-1 表示无限制。此限制仅在比 temp_file_limit 更严格时适用。
parameterized_views.work_mem
| 类型 | integer |
| 默认 | 0 |
| 实例重启 | 否 |
设置使用参数化视图 API 运行时用于查询工作区的最大内存量（以 kB 为单位）。0 表示无限制。此限制仅在比 work_mem 更严格时适用。
vector_assist.enabled
| 类型 | boolean |
| 默认 | on |
| 实例重启 | 否 |
控制是否启用矢量辅助功能。