要获得与亚马逊 Timestream 类似的功能 LiveAnalytics，可以考虑适用于 InfluxDB 的亚马逊 Timestream。适用于 InfluxDB 的 Amazon Timestream 提供简化的数据摄取和个位数毫秒级的查询响应时间，以实现实时分析。点击[此处](https://docs.amazonaws.cn/timestream/latest/developerguide/timestream-for-influxdb.html)了解更多信息。

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

# InfluxDB 3 Timestream 的维护窗口
<a name="influxdb3-maintenance-windows"></a>

适用于 InfluxDB 的 Amazon Timestream 会定期维护您的资源。维护通常涉及对底层硬件、操作系统或数据库引擎的更新。这些更新是强制性的。如果在指定的时间段内未进行维护，则可以在随后的窗口中进行维护。

## 维护窗口的工作原理
<a name="maintenance-how-it-works"></a>

InfluxDB 资源的每个 Timestream 都有一个每周维护窗口，在此期间进行维护。
+ 如果您指定首选维护时段，则会在您选择的时间段内执行维护。
+ 如果您未指定首选维护时段，系统会自动为您的资源分配维护时段。

您可以在创建资源时设置首选维护时段，也可以在以后使用更新对其进行更改 APIs。

**重要**  
如果所需的维护操作已推迟超过 25 天，则该服务可能会在您的首选时段之外进行维护，以确保您的资源的安全性和可靠性。

## 管理类型
<a name="maintenance-management-types"></a>

可以通过两种方式管理维护窗口：


| **Type** | **描述** | **行为** | 
| --- | --- | --- | 
| SERVICE\_MANAGED | Amazon 管理维护（默认） | Amazon 确定最佳维护时段 | 
| CUSTOMER\_MANAGED | 客户管理维护 | 您必须指定 preferredMaintenanceWindow | 

## 首选维护时段
<a name="maintenance-preferred-window"></a>

首选维护时段定义了每周可以进行维护的时段。

**Format**: `ddd:HH:MM-ddd:HH:MM`
+ `ddd`— 一周中的某一天 (`Sun`,`Mon`,`Tue`,`Wed`,`Thu`,`Fri`,,`Sat`)。不区分大小写。
+ `HH:MM`— 24 小时格式的时间。

**示例：**


| **窗口** | **描述** | **Duration** | 
| --- | --- | --- | 
| Sun:02:00-Sun:04:00 | 星期日凌晨 2:00 至凌晨 4:00 | 2 小时 | 
| Sat:22:00-Sun:02:00 | 星期六晚上 10:00 至星期日凌晨 2:00 | 4 小时 | 
| Wed:03:30-Wed:05:30 | 星期三上午 3:30 至凌晨 5:30 | 2 小时 | 

**约束**：


| **约束** | **值** | 
| --- | --- | 
| 最小窗口持续时间 | 2 小时 | 
| 最大窗口持续时间 | 24 小时 | 
| 午夜时分的窗户 | 支持（例如，Sat:22:00-Sun:02:00） | 

维护将在指定时段的前 30 分钟内开始。确切的开始时间由系统决定，对于相同的资源，每周都是一致的。

## Timezone
<a name="maintenance-timezone"></a>

您可以使用`timezone`字段为维护时段指定时区。设置后，窗口时间将按指定的时区进行解释。

在所有维护计划请求中，该`timezone`字段均为必填字段。

**格式：**IANA 时区标识符。支持 [IANA 时区数据库中的大多数时区](https://www.iana.org/time-zones)，包括常用标识符`America/New_York`，例如、、`Europe/London``Asia/Tokyo``Asia/Kolkata`、和。`Pacific/Auckland`

**注意**  
不支持时区缩写`EST`，例如`PST`、`GMT+5`和。请改用完整的 IANA 标识符。

**夏令时：**系统自动处理夏令时过渡。如果您的窗口落在已跳过的夏令时时间内（春季向前），则该周将跳过维护。为避免与 DST 相关的问题，请在凌晨 1:00 至凌晨 3:00 范围之外安排维护，或者使用。`UTC`

**支持的时区：**


| **时区** | **描述** | 
| --- | --- | 
| UTC | 协调世界时（默认） | 
| America/New\_York | 美国东部航空 | 
| America/Chicago | 美国中部 | 
| America/Denver | 美国山脉 | 
| America/Los\_Angeles | 美国太平洋地区 | 
| America/Sao\_Paulo | 巴西 | 
| Europe/London | UK | 
| Europe/Paris | 中欧 | 
| Europe/Berlin | 德国 | 
| Asia/Tokyo | 日本 | 
| Asia/Shanghai | 中国 | 
| Asia/Singapore | 新加坡 | 
| Asia/Mumbai | 印度 | 
| Asia/Dubai | 阿联酋 | 
| Australia/Sydney | 澳大利亚东部 | 
| Pacific/Auckland | 新西兰 | 

## 在维护期间
<a name="maintenance-during"></a>

执行维护时，资源状态更改为`MAINTENANCE`。在此期间，资源可能暂时不可用。完成后，状态将恢复为`AVAILABLE`。

## API 响应字段
<a name="maintenance-response-fields"></a>


| **字段** | **描述** | 
| --- | --- | 
| preferredMaintenanceWindow | 配置的维护时段。如果不是客户指定的，则显示系统分配的窗口。 | 
| timezone | 配置的时区。 | 
| nextMaintenanceTime | 下次计划维护时间，以世界标准时间 (ISO 8601) 为单位。 | 
| lastMaintenanceTime | 上次完成的维护时间，以世界标准时间 (ISO 8601) 为单位。如果从未执行过，则为空。 | 

**注意**  
`nextMaintenanceTime`和`lastMaintenanceTime`始终以 UTC 格式返回，无论您配置了哪个时区。

## CLI 示例
<a name="maintenance-cli-examples"></a>

### 创建资源时设置维护时段
<a name="maintenance-cli-create"></a>

服务托管（默认-未指定维护计划）：

```
aws timestream-influxdb create-db-cluster \
  --name "my-influxdb3-cluster" \
  --db-instance-type db.influx.2xlarge \
  --vpc-subnet-ids subnet-12345abc subnet-67890def \
  --vpc-security-group-ids sg-12345abc \
  --region us-west-2
```

客户使用 UTC（默认时区）进行管理：

```
aws timestream-influxdb create-db-cluster \
  --name "my-influxdb3-cluster" \
  --db-instance-type db.influx.2xlarge \
  --vpc-subnet-ids subnet-12345abc subnet-67890def \
  --vpc-security-group-ids sg-12345abc \
  --maintenance-schedule '{
    "preferredMaintenanceWindow": "Sun:02:00-Sun:04:00"
  }' \
  --region us-west-2
```

客户在特定时区进行管理：

```
aws timestream-influxdb create-db-cluster \
  --name "my-influxdb3-cluster" \
  --db-instance-type db.influx.2xlarge \
  --vpc-subnet-ids subnet-12345abc subnet-67890def \
  --vpc-security-group-ids sg-12345abc \
  --maintenance-schedule '{
    "timezone": "America/New_York",
    "preferredMaintenanceWindow": "Sun:02:00-Sun:04:00"
  }' \
  --region us-west-2
```

客户通过隔夜窗口进行管理：

```
aws timestream-influxdb create-db-cluster \
  --name "my-influxdb3-cluster" \
  --db-instance-type db.influx.2xlarge \
  --vpc-subnet-ids subnet-12345abc subnet-67890def \
  --vpc-security-group-ids sg-12345abc \
  --maintenance-schedule '{
    "timezone": "Europe/London",
    "preferredMaintenanceWindow": "Sat:22:00-Sun:02:00"
  }' \
  --region us-west-2
```

### 更新维护时段
<a name="maintenance-cli-update"></a>

在现有资源上设置自定义维护时段：

```
aws timestream-influxdb update-db-cluster \
  --identifier "my-influxdb3-cluster" \
  --maintenance-schedule '{
    "timezone": "Asia/Tokyo",
    "preferredMaintenanceWindow": "Wed:03:00-Wed:06:00"
  }' \
  --region us-west-2
```

恢复到服务托管：

```
aws timestream-influxdb update-db-cluster \
  --identifier "my-influxdb3-cluster" \
  --maintenance-schedule '{
    "timezone": "UTC",
    "preferredMaintenanceWindow": ""
  }' \
  --region us-west-2
```

## 注意事项
<a name="maintenance-considerations"></a>
+ 维护时段定义了何时*可以*进行维护，而不是*何*时进行维护。根据需要进行维护，通常每周不超过一次。
+ Amazon 要求每月至少执行一次维护以进行安全性和可靠性修补。
+ 对于使用集群终端节点的多节点集群，流量会在维护期间自动重新分配到可用节点。
+ 将维护时段安排在流量最低的时段，以最大限度地减少对工作负载的影响。
+ 如果您使用时区进行夏令时过渡，请避免将维护安排在凌晨 1:00 至凌晨 3:00 之间，以防止春季前进期间跳过窗口。