本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
修改亚马逊 DocumentDB 集群参数组
本节介绍如何修改自定义亚马逊 DocumentDB 参数组。在亚马逊 DocumentDB 中,您无法修改default
集群参数组,是在您首次在新区域使用新引擎版本创建集群时创建的。如果您的 Amazon DocumentDB 集群使用的是默认集群参数组,并且您想要修改其中的值,则必须先修改其中的值创建新的参数组要么复制现有的参数组,对其进行修改,然后将修改后的参数组应用于您的集群。
完成以下步骤以修改自定义集群参数组。修改操作可能需要一段时间才能传播。请等待修改后的集群参数组可用,然后再将其附加到您的集群。你可以使用Amazon Web Services Management Console或者Amazon CLI describe-db-cluster-parameters
操作以验证您的集群参数组是否已被修改。有关更多信息,请参阅描述集群参数组:
- Using the Amazon Web Services Management Console
-
按照以下步骤修改自定义 Amazon DocumentDB 参数组。你无法修改
default
参数组。如果要修改中的值default
参数组,你可以复制默认集群参数组,对其进行修改,然后将修改后的参数组应用于您的集群。有关将参数组应用于集群的更多信息,请参阅修改 AAmazon DocumentDB men。修改自定义集群参数组
登录Amazon Web Services Management Console,然后打开亚马逊 DocumentDB 控制台,网址为https://console.aws.amazon.com/docdb
。 在控制台左侧的导航窗格中,选择参数组。在参数组列表中,选择要修改的参数组的名称。
提示
如果您在屏幕左侧没有看到导航窗格,请在页面左上角选择菜单图标 (
)。
对于要修改的参数组中的每个参数,执行以下操作:
找到要修改的参数,并通过检查其是否被列为,来验证该参数是否可以修改
true
在下面可修改专栏。如果可以修改,请选择参数并选择编辑从控制台页面的右上角。
在修改
<parameter-name>
对话框中,进行所需的更改。然后,选择 Modify cluster parameter (修改集群参数) 或选择 Cancel (取消) 以放弃更改。
- Using the Amazon CLI
-
你可以修改
ParameterValue
,Description
,或ApplyMethod
使用自定义 Amazon DocumentDB 集群参数组中的任何可修改参数Amazon CLI。您不能直接对默认集群参数组进行修改。要修改自定义集群参数组的参数,请使用
modify-db-cluster-parameter-group
使用以下参数进行操作。-
--db-cluster-parameter-group-name
– 必需。您正在修改的集群参数组的名称。 -
--parameters
– 必需。您正在修改的参数。有关适用于 Amazon DocumentDB 集群中所有实例的参数列表,请参阅亚马逊文档数据库集群参数参考。每个参数条目必须包含以下内容:-
ParameterName
-您正在修改的参数的名称。 -
ParameterValue
— 此参数的新值。 -
ApplyMethod
— 您希望如何应用对此参数的更改。允许的值为immediate
和pending-reboot
。注意
带
static
的ApplyType
参数必须具有pending-reboot
的ApplyMethod
。
-
例 -修改参数的值
在此示例中,您列出了的参数值
sample-parameter-group
并修改tls
参数。然后,等待 5 分钟后,再次列出sample-parameter-group
的参数值以查看更改后的参数值。-
列出参数及其值
sample-parameter-group
。对于 Linux、macOS 或 Unix:
aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name
sample-parameter-group
对于 Windows:
aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name
sample-parameter-group
此操作的输出将类似于下文(JSON 格式)。
{ "Parameters": [ { "Source": "system", "ApplyType": "static", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "tls", "IsModifiable": true, "Description": "Config to enable/disable TLS" }, { "Source": "user", "ApplyType": "dynamic", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "ttl_monitor", "IsModifiable": true, "Description": "Enables TTL Monitoring" } ] }
-
修改
tls
参数,因此其值为disabled
。你无法修改
ApplyMethod
因为ApplyType
是static
。对于 Linux、macOS 或 Unix:
aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name
sample-parameter-group
\ --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot对于 Windows:
aws docdb modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name
sample-parameter-group
^ --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot此操作的输出将类似于下文(JSON 格式)。
{ "DBClusterParameterGroupName": "sample-parameter-group" }
-
至少等待 5 分钟。
-
列出参数值
sample-parameter-group
以验证tls
参数已修改。对于 Linux、macOS 或 Unix:
aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name
sample-parameter-group
对于 Windows:
aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name
sample-parameter-group
此操作的输出将类似于下文(JSON 格式)。
{ "Parameters": [ { "ParameterValue": "false", "ParameterName": "enable_audit_logs", "ApplyType": "dynamic", "DataType": "string", "Description": "Enables auditing on cluster.", "AllowedValues": "true,false", "Source": "system", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, {
"ParameterValue": "disabled"
,"ParameterName": "tls"
, "ApplyType": "static", "DataType": "string", "Description": "Config to enable/disable TLS", "AllowedValues": "disabled,enabled", "Source": "system", "IsModifiable": true, "ApplyMethod": "pending-reboot" } ] }
-