此页面由 Cloud Translation API 翻译。

配置维护窗口

本页介绍了如何为 Cloud Data Fusion 实例定义维护窗口。

6.8.0 及更高版本的 Cloud Data Fusion 实例支持维护时间窗口。

维护期简介

Cloud Data Fusion 中的维护期是指您允许 Cloud Data Fusion 执行维护操作的时间段，可降低在高峰使用时段服务中断的风险。将维护期安排在非高峰时段或活动较少的时段，可最大限度地减少维护期对 Cloud Data Fusion 实例和流水线执行的影响。

配置维护期可让您控制何时在实例中进行维护操作：

如果定义了维护期，Cloud Data Fusion 会在定义的时间段内执行维护操作。
如果未定义维护窗口，则系统可能会随时执行维护。

维护操作简介

为确保系统安全和合规，Cloud Data Fusion 会定期进行维护操作。这些操作包括应用重要更新和安全补丁，以减少漏洞并保护用户数据。通过安排维护时间窗口，可确保高效应用更新，从而保持系统完整性，并最大限度地减少对实例和流水线执行的影响。

配置维护期时，您必须为维护操作分配每周至少 12 小时的时间。每个时间段必须介于 4 到 12 小时之间。
在维护时间段内，某些操作可能会受到影响。我们建议在非高峰使用时段设置维护窗口。维护操作可能会以下方式影响 Cloud Data Fusion：
- Cloud Data Fusion Studio 界面可能暂时无法使用。
- 流水线执行可能会受到影响，导致失败。
- Cloud Data Fusion 服务可能会暂时停机，导致 API 调用失败。
- 在维护时间段内，实例最多可能无法完全正常运行 1 小时。我们建议您在流水线未运行或未安排运行时设置维护时间窗口。

在创建实例时指定维护窗口

控制台

如需在创建实例时设置维护窗口，请按以下步骤操作：

前往 Cloud Data Fusion 实例页面，然后点击创建实例。
创建实例
输入实例名称和版本。如需详细了解各个字段，请参阅创建实例。
展开高级选项部分。
展开维护部分，然后按照以下步骤操作：
1. 选中启用维护期复选框。
2. 在开始时间字段中，输入时间（采用受支持的格式）。
3. 在时区列表中，选择一个时区。
4. 在天数和时长列表中，选择一周中的哪几天和时长。如需详细了解这些设置，请参阅维护操作简介。
5. 点击创建。

如需了解详情，请参阅配置维护期时间和重复设置 (RRULE)。

REST API

使用 instance.create API 设置 Instance 配置：

{
  "name": string,
  "description": string,
  …
  …
  "maintenancePolicy": {
    "maintenanceWindow": {
      "recurringTimeWindow": {
        "window": {
            "startTime": "START_TIME",
            "endTime": "END_TIME"
        },
        "recurrence": "MAINTENANCE_RECURRENCE"
      }
    },
  }
}

替换以下内容：

START_TIME：时间范围的开始时间，采用 RFC 3339 格式。
END_TIME：时间范围结束时间，采用 RFC 3339 格式。
MAINTENANCE_RECURRENCE：维护窗口重复的 RRULE。Cloud Data Fusion 仅支持以下格式：
- FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA 或 BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY。这会指定窗口在一周中的选定几天重复，从 startTime 开始，时长为指定时长。

如需了解详情，请参阅配置维护期时间和重复设置 (RRULE)。

以下示例会创建一个实例，其维护窗口为每周六和周日上午 10 点到下午 4 点 (UTC) 之间的 6 小时。如需了解详情，请参阅 instances API 文档。

// POST https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances?instanceID=example-instance

{
  "maintenancePolicy": {
      "maintenanceWindow": {
          "recurringTimeWindow": {
              "window": {
                  "startTime": "2024-01-01T10:00:00Z",
                  "endTime": "2024-01-01T16:00:00Z",
              },
              "recurrence": "FREQ=WEEKLY;BYDAY=SA,SU"
          }
      },
  }
}

gcloud

您可以在使用 gcloud beta data-fusion instances create 命令创建实例时指定维护窗口。

必须为维护窗口定义以下参数：

--maintenance-window-start 用于设置窗口的开始时间。
--maintenance-window-end 用于设置窗口的结束时间。
--maintenance-window-recurrence 为维护窗口的重复设置 RRULE。

gcloud beta data-fusion instances create INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --maintenance-window-start=START_TIME \
    --maintenance-window-end=END_TIME \
    --maintenance-window-recurrence=MAINTENANCE_RECURRENCE

替换以下内容：

INSTANCE_NAME：实例的名称。
PROJECT_NAME：项目的名称。
LOCATION：实例所在区域的名称。
START_TIME：采用日期/时间输入格式的窗口开始时间。只有一天中所指定的时间，指定的日期会被忽略。
END_TIME：采用日期/时间输入格式的时间窗口结束时间。只有一天中所指定的时间，指定的日期会被忽略。指定的日期和时间必须晚于开始时间。
MAINTENANCE_RECURRENCE：维护窗口重复的 RRULE。Cloud Data Fusion 仅支持以下格式：
- FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA 或 BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY。这会指定窗口在一周中的选定几天重复，从 --maintenance-window-start 时间开始，持续指定时长。

如需了解详情，请参阅配置维护期时间和重复设置 (RRULE)。

以下命令会创建一个实例，其维护期为每周六和周日的中午 12 点到下午 6 点 (UTC) 之间的 6 小时。

gcloud beta data-fusion instances create example-instance \
    --project='example-project' \
    --location='us-east1' \
    --maintenance-window-start='2024-01-01T12:00:00Z' \
    --maintenance-window-end='2024-01-01T18:00:00Z' \
    --maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'

更新实例的维护窗口

控制台

如需在 Google Cloud 控制台中更新现有实例的维护时间窗口，请按以下步骤操作：

转到 Cloud Data Fusion 实例页面。

转到实例
点击实例名称以查看实例详情。
在实例详情页面上，前往维护窗口字段，然后点击修改。
维护时间范围字段会在编辑模式下打开。根据需要更新值：
1. 选中启用维护期复选框。
2. 在开始时间字段中，输入时间（采用受支持的格式）。
3. 在时区列表中，选择一个时区。
4. 在天数和时长列表中，选择一周中的几天和时段时长。如需详细了解这些设置，请参阅维护操作简介。
点击保存。

如需了解详情，请参阅配置维护期时间和重复设置 (RRULE)。

REST API

对于现有实例，请使用 instances.patch API 请求更新维护时间范围。这会替换现有的维护期配置（如果有）。否则，系统会设置新配置，如请求正文中所述。

构建 API 请求如下：

在参数 updateMask 中，指定 maintenance_policy 掩码。
在请求正文中，在维护政策配置中指定维护期：

{
  "maintenancePolicy": {
    "maintenanceWindow": {
        "recurringTimeWindow": {
          "window": {
              "startTime": "START_TIME",
              "endTime": "END_TIME"
          },
          "recurrence": "MAINTENANCE_RECURRENCE"
        }
    },
  }
}

如需了解详情，请参阅配置维护期时间和重复设置 (RRULE)。

以下示例会更新实例的维护政策配置，将维护窗口设置为每周五、六、日上午 11 点到下午 3 点 (UTC) 之间的四小时。

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
"maintenancePolicy": {
  "maintenanceWindow": {
    "recurringTimeWindow": {
      "window": {
          "startTime": "2024-01-01T11:00:00Z",
          "endTime": "2024-01-01T15:00:00Z",
        },
      "recurrence": "FREQ=WEEKLY;BYDAY=FR,SA,SU"
    }
  },
}
}

gcloud

您可以使用 gcloud beta data-fusion instances update 命令更新实例的维护时间窗口。

必须为维护窗口定义以下参数：

--maintenance-window-start 用于设置窗口的开始时间。
--maintenance-window-end 用于设置窗口的结束时间。
--maintenance-window-recurrence 为维护窗口的重复设置 RRULE。

gcloud beta data-fusion instances update INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --maintenance-window-start=START_TIME \
    --maintenance-window-end=END_TIME \
    --maintenance-window-recurrence=MAINTENANCE_RECURRENCE

替换以下内容：

INSTANCE_NAME：实例的名称。
PROJECT_NAME：项目的名称。
LOCATION：实例所在区域的名称。
START_TIME：采用日期/时间输入格式的窗口开始时间。只有一天中所指定的时间，指定的日期会被忽略。
END_TIME：采用日期/时间输入格式的时间窗口结束时间。只有一天中所指定的时间，指定的日期会被忽略。指定的日期和时间必须晚于开始时间。
MAINTENANCE_RECURRENCE：维护窗口重复的 RRULE。Cloud Data Fusion 仅支持以下格式：
- FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA 或 BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY。这会指定窗口在一周中的选定几天重复，从 --maintenance-window-start 时间开始，持续指定时长。

以下命令会更新实例 example-instance，使其在每周六和周日的中午 12 点到下午 6 点 (UTC) 之间有 6 小时的维护窗口。

gcloud beta data-fusion instances update example-instance \
    --project='example-project' \
    --location='us-east1' \
    --maintenance-window-start='2024-01-01T12:00:00Z' \
    --maintenance-window-end='2024-01-01T18:00:00Z' \
    --maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'