使用更新集群 AWS 管理控制台使用更新集群 AWS CLI 扩展集群（企业版）更新集群时的注意事项

在 Timestream for InfluxDB 3 中更新集群

创建集群后，可在 Amazon Timestream 中修改某些配置参数，以适应不断变化的工作负载需求。请注意，某些修改可能导致更新过程中存现短暂的停机时间。

使用更新集群 AWS 管理控制台

登录 AWS 管理控制台并打开适用于 InfluxDB 的 Amazon Timestream 控制台。
在导航窗格中，选择 InfluxDB 数据库。
选择要修改的集群。
选择修改。
更新可用设置：
- 实例类：扩展或缩减计算资源（适用于集群中的所有节点，需重新启动集群）。
- 参数组：关联不同的参数组以更改引擎配置或集群形状（需要重新启动集群）。
- 日志传输配置：启用或修改 CloudWatch 日志导出。
- 版本：从核心升级到企业版（单向）。有关更多信息，请参阅从核心版升级到企业版。
选择继续，查看更改。
选择何时应用更改：
- 立即应用：更改会立即生效（可能导致短暂的停机时间）。
选择修改集群。

使用更新集群 AWS CLI

更新实例类型：


aws timestream-influxdb update-db-cluster \
  --region us-east-1 \
  --identifier "my-influxdb3-cluster" \
  --db-instance-type db.influxIOIncluded.2xlarge \
  --apply-immediately

更新参数组（包括集群扩展）：

要修改集群配置（包括扩展节点数量），请使用所需的配置创建一个新的参数组并将其应用于您的集群：


# Step 1: Create a new parameter group with desired node configuration
aws timestream-influxdb create-db-parameter-group \
  --name "scaled-enterprise-pg" \
  --parameters '{
    "InfluxDBv3Enterprise": {
      "ingestQueryInstances": 4,
      "queryOnlyInstances": 10,
      "dedicatedCompactor": true,
      "dataFusionNumThreads": 8,
      "bufferMemLimitMb": 32768
    }
  }'

# Step 2: Apply the new parameter group to your cluster using the parameter group identifier
aws timestream-influxdb update-db-cluster \
  --region us-east-1 \
  --identifier "my-influxdb3-cluster" \
  --db-parameter-group-identifier "<parameter-group-identifier>" \
  --apply-immediately

扩展集群（企业版）

对于企业版集群，您可以通过应用具有所需节点配置的新参数组来扩展集群规模。有关详细指导，请参阅扩展集群。

向@@ 上扩展：通过增加 ingestQueryInstances （最多 4 个）或 queryOnlyInstances （最多 13 个）来添加节点
缩小：通过减少这些值来移除节点
更改节点模式：调整节点与只读 writer/reader 节点的比例

重要：拥有 3 个或更多节点的集群需要专用的压实机（decidatedCompactor：true）。扩展时，节点会自动分布在多个可用区中，以实现高可用性。

更新集群时的注意事项

可修改的参数

创建集群后可修改以下参数：

参数	描述	Impact
实例类	向上或向下扩展 compute/memory 资源	需滚动重启节点
参数组	更改数据库引擎配置或集群形状（节点数和模式）	需重启集群
日志传输	配置 CloudWatch 日志导出	立即应用
版本	从核心升级到企业版（单向）。请参阅从核心版升级到企业版。	需重启集群

不可修改的参数

集群创建后无法修改以下参数：

VPC 和子网：网络位置已固定。
安全组：网络访问控制不可更改。
公开可用性：互联网访问权限设置为永久有效。
数据库集群标识符：集群名称不可更改。

停机时间影响：

实例类更改：滚动重启（多节点集群的停机时间最短）。
参数组更改（包括集群扩展）：需要重启集群。对于使用集群终端节点的多节点集群，流量将在更新过程中自动重新分配到可用节点。
日志配置更改：无停机时间。

最佳实践：

创建集群之前，请仔细规划网络配置，因为该配置无法更改。
请先在非生产环境中测试更改。
在更新期间和更新之后监控指标，以验证性能。
使用集群终端节点来确保滚动更新和扩展操作期间的透明故障转移。
更新操作期间@@ 避免使用特定于节点的端点，因为可能会重新启动或替换单个节点。
扩展时，请考虑您的工作负载模式，以确定节点与只读 writer/reader 节点的最佳比例。

验证：

系统会在应用所有更改前进行验证。
无效配置将被拒绝，并显示描述性错误消息。
某些参数组合可能不兼容（例如，具有 3 个以上节点的集群需要专用的压实机）。

回滚：

保留之前的参数组配置，以便轻松回滚。
在进行更改前记录当前设置。
对于关键更改，请在更新前创建集群快照。
要回滚扩展操作，请使用您之前的节点配置创建一个参数组并将其应用于集群。

监控更新进度

通过以下方式跟踪更新状态：

控制台：更新期间，集群状态显示为“正在修改”。
CLI：查询集群状态：
```
aws timestream-influxdb get-db-cluster \
  --identifier "my-influxdb3-cluster"
```
集群可能的状态包括：
- CREATING
- UPDATING
- DELETING
- AVAILABLE
- FAILED
- DELETED
- UPDATING_INSTANCE_TYPE
- PARTIALLY_AVAILABLE（仅适用于某些节点仍在创建或更新中的多节点集群）
CloudWatch 指标：在更新期间监控性能指标。

限制

集群更新的当前限制：

创建后无法修改 VPC、子网、安全组或公开可用性。
支持从核心升级到企业版（单向），但不能从企业版降级到核心版。请参阅从核心版升级到企业版。
无法重命名集群（数据库集群标识符不可改变）。
所有节点都必须使用相同的实例类（压实机除外）。
参数组不可改变（必须创建新的参数组才能进行更改）。
集群扩展操作（添加/移除节点）需要创建和应用新的参数组。

通过了解这些更新功能和限制，您可以有效管理和扩展 InfluxDB 3 集群，以满足不断变化的工作负载需求，同时适当规划必须在创建集群时配置的设置。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

创建集群

将 Core 升级到企业版