本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Amazon DocumentDB 集群参数参考
<a name="cluster_parameter_groups-list_of_parameters"></a>

当您更改动态参数并保存集群参数组时，更改将立即应用，而不管*立即应用*的设置如何。当您更改静态参数并保存集群参数组时，参数更改将在您手动重启实例后生效。您可以使用 Amazon DocumentDB 控制台或通过明确调用 `reboot-db-instance` 来重启实例。

下表显示了适用于 Amazon DocumentDB 集群中所有实例的参数。


**Amazon DocumentDB 集群级参数**  

| 参数 | 默认 值 | 有效值 | 可修改 | 应用类型 | 数据类型 | 说明 | 
| --- | --- | --- | --- | --- | --- | --- | 
| audit\_logs | disabled | 已启用、已禁用、ddl、dml\_read、dml\_write、全部、无 | 是 | 动态 | 字符串 | 定义是否启用亚马逊 CloudWatch 审核日志。+  **enabled**— CloudWatch 审计日志已启用。 <br />+  **disabled**— CloudWatch 审核日志已禁用。 <br />+  **ddl**：对 DDL 事件的审核已启用。 <br />+  **dml\_read**：对 DML 读取事件的审计已启用。 <br />+  **dml\_write**：对 DML 写入事件的审核已启用。 <br />+  **all**：对所有数据库事件的审核已启用。 <br />+  **none**：审核已禁用。  | 
| change\_stream\_log\_retention\_duration | 10800 | 3600-604800 | 是 | 动态 | 整数 | 定义变更流日志保留和可以使用的以秒计的时间长度。 | 
| default\_collection\_compression | disabled | 启用、禁用（亚马逊 DocumentDB 5.0）/zstd、lz4、无（亚马逊） DocumentDB8.0 | 是 | 动态 | 字符串 | 定义集群中新集合的默认压缩设置 + **enabled**— 亚马逊 DocumentDB 5.0 中默认启用 Lz4 压缩。亚马逊 DocumentDB 8.0 中默认启用 zstd 压缩。<br />+ **disabled, none**— 默认情况下压缩处于禁用状态（在 Amazon DocumentDB 5.0 中禁用，在 Amazon DocumentDB 8.0 中未禁用）。 | 
| profiler | disabled | 启用，禁用 | 是 | 动态 | 字符串 | 为慢速操作启用分析。+  **enabled**— 耗时超过客户定义的阈值（例如 100 毫秒）的操作将记录到 CloudWatch 亚马逊日志中。 <br />+  **disabled**— 慢速操作未记录到 CloudWatch 日志中。  | 
| profiler\_sampling\_rate | 1.0 | 0.0-1.0 | 是 | 动态 | 浮点型 | 定义已记录操作的采样率。 | 
| profiler\_threshold\_ms | 100 | 50-2147483646 | 是 | 动态 | 整数 | 为 profiler 定义阈值。+  所有大于的操作`profiler_threshold_ms`都会记录到 CloudWatch 日志中。  | 
| planner\_version | 3.0 | 1.0、2.0、3.0 | 是 | 动态 | 浮点型 | 定义用于查询的查询计划器版本。+  **1.0**— 支持亚马逊 DocumentDB 5.0。 <br />+  **2.0**— 改进了查找和更新运算符。在亚马逊 DocumentDB 5.0 中支持。 <br />+  **3.0**— 改进了查找、更新和聚合运算符。亚马逊 DocumentDB 8.0 中的默认查询计划器。  | 
| tls | 已启用 | enabled、disabled、fips-140-3、tls1.2\+、tls1.3\+ | 是 | 静态 | 字符串 | 定义是否需要传输层安全性 (TLS) 连接。+  **enabled**：需要 TLS 连接才能进行连接。对于 Amazon DocumentDB 5.0 及更早版本，它启用 TLS 1.0 到 1.3，但使用 TLS 1.2 或更高版本。从次要版本5.0.1、Amazon DocumentDB 8.0及更高版本开始，亚马逊DocumentDB 5.0及更高版本仅支持TLS 1.2及更高版本。 <br />+  **disabled**：TLS 连接不能用于连接。 <br />+  **fips-140-3**：要求具有联邦信息处理标准 (FIPS) 属性的 TLS 连接才连接。根据 FIPS 出版物 140-3，集群仅接受安全的连接。仅从以下区域的 Amazon DocumentDB 5.0（引擎版本 3.0.3727）集群开始才支持此功能：ca-central-1、us-west-2、us-east-1、us-east-2、us-gov-east-1、us-gov-west-1。 <br />+  **tls1.2\+**：需要使用 TLS 版本 1.2 及更高版本的 TLS 连接才能进行连接。从 Amazon DocumentDB 4.0（引擎版本 2.0.10980）和 Amazon DocumentDB 5.0（引擎版本 3.0.11051）开始才支持此功能。 <br />+  **tls1.3\+**：需要使用 TLS 版本 1.3 及更高版本的 TLS 连接才能进行连接。从 Amazon DocumentDB 4.0（引擎版本 2.0.10980）和 Amazon DocumentDB 5.0（引擎版本 3.0.11051）开始才支持此功能。  | 
| ttl\_monitor | 已启用 | 启用，禁用 | 是 | 动态 | 字符串 | 定义是否为集群启用有效时间 (TTL) 监控。+  **enabled**：启用 TTL 监控。 <br />+  **disabled**：禁用 TTL 监控。  |