Configura períodos de mantenimiento

En esta página, se explica cómo definir períodos de mantenimiento para Cloud Data Fusion individuales.

Los períodos de mantenimiento son compatibles con las instancias de Cloud Data Fusion en versiones 6.8.0 y posteriores.

Información acerca de los períodos de mantenimiento

Un período de mantenimiento en Cloud Data Fusion es un período en el que le permiten llevar a cabo operaciones de mantenimiento, lo que reduce el riesgo de servicio y interrupciones en los momentos de mayor uso. Programa períodos de mantenimiento durante las horas de baja actividad o los horarios en los que tu actividad es más baja, minimiza su impacto en de sus instancias de Cloud Data Fusion y las ejecuciones de sus canalizaciones.

La configuración de los períodos de mantenimiento te permite controlar cuándo las operaciones de mantenimiento que ocurra en tu instancia:

  • Si se define el período de mantenimiento, se realizan las operaciones de mantenimiento por Cloud Data Fusion dentro de los períodos definidos.
  • Si no se definió el período de mantenimiento, el mantenimiento se puede realizar en cualquier tiempo.

Información acerca de las operaciones de mantenimiento

Para garantizar la seguridad del sistema y el cumplimiento, Cloud Data Fusion realiza las operaciones de mantenimiento regulares. Estas operaciones incluyen aplicar actualizaciones de software y parches de seguridad para mitigar las vulnerabilidades y proteger los datos del usuario. Los períodos de mantenimiento programados garantizan que las actualizaciones se apliquen de forma eficiente preservar la integridad del sistema y minimizar la interrupción de las instancias y canalizaciones ejecuciones.

  • Cuando configures los períodos de mantenimiento, debes asignar al menos 12 horas por semana para las operaciones de mantenimiento. Cada ventana debe tener un valor entre 4 y 12 horas.

  • Durante las horas del período de mantenimiento, algunas operaciones pueden verse afectadas. Recomendamos realizar períodos de mantenimiento durante los períodos de menor uso. El puede afectar a Cloud Data Fusion de las siguientes maneras:

    • Es posible que la interfaz de Cloud Data Fusion Studio se no disponible.
    • La ejecución de la canalización podría verse afectada, lo que podría causar fallas.
    • Es posible que los servicios de Cloud Data Fusion estén inactivos temporalmente, lo que provoca que la API que las llamadas fallen.
    • Es posible que las instancias no funcionen por completo hasta por una hora durante horas del período de mantenimiento. Te recomendamos que configures el mantenimiento cuando las canalizaciones no están en ejecución o no están programadas cuando se ejecute.

Especifica períodos de mantenimiento mientras creas una instancia

Console

Para configurar el período de mantenimiento cuando creas una instancia, sigue estos pasos:

  1. Ve a la página Instancias de Cloud Data Fusion y haz clic en Crear. .

    Crear una instancia

  2. Ingresa el Nombre de la instancia y la Edición. Para obtener más información para cada campo, consulta Crea una instancia.
  3. Expande la sección Opciones avanzadas.
  4. Expande la sección Mantenimiento y sigue estos pasos:
    1. Selecciona la casilla de verificación Habilitar período de mantenimiento.
    2. En el campo Hora de inicio, ingresa una hora en un formato compatible.
    3. En la lista TimeZone, selecciona una zona horaria.
    4. En las listas Días y Duración, selecciona los días de la semana y la duración del período. Para obtener más información sobre estos parámetros de configuración, consulta Acerca de las operaciones de mantenimiento.
    5. Haz clic en Crear.

Para obtener más información, consulta Configura los plazos y la recurrencia del período de mantenimiento (RRULE).

API de REST

  1. Establece la configuración de Instance con la API de instance.create:
{
  "name": string,
  "description": string,
  …
  …
  "maintenancePolicy": {
    "maintenanceWindow": {
      "recurringTimeWindow": {
        "window": {
            "startTime": "START_TIME",
            "endTime": "END_TIME"
        },
        "recurrence": "MAINTENANCE_RECURRENCE"
      }
    },
  }
}

Reemplaza lo siguiente:

  • START_TIME: hora de inicio del período, en el formato RFC 3339.
  • END_TIME: hora de finalización del período, en el formato RFC 3339.

  • MAINTENANCE_RECURRENCE: Es un RRULE para el la recurrencia del período de mantenimiento. Cloud Data Fusion solo admite los siguientes formatos:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA o BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY Esto especifica los valores semanales la recurrencia de la ventana en los días seleccionados, a partir del startTime y por la duración especificada.

Para obtener más información, consulta Configura los plazos y la recurrencia del período de mantenimiento (RRULE).

En el siguiente ejemplo, se crea una instancia con un período de mantenimiento de seis horas todos los sábados y domingos de 10 a.m. a 4 p.m. (UTC). Para ver más consulta la documentación de la API de instancias.

// 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

Puedes especificar el período de mantenimiento mientras creas una instancia con el comando gcloud beta data-fusion instances create.

Se deben definir los siguientes parámetros para un período de mantenimiento:

  • --maintenance-window-start establece la hora de inicio de la ventana.
  • --maintenance-window-end establece la hora de finalización de la ventana.
  • --maintenance-window-recurrence establece un RRULE para el la recurrencia del período de mantenimiento.
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

Reemplaza lo siguiente:

  • INSTANCE_NAME: El nombre de la instancia.
  • PROJECT_NAME: el nombre del proyecto.
  • LOCATION: Es el nombre de la región de la instancia.
  • START_TIME: Es la hora de inicio de la ventana en la formato de entrada de fecha y hora. Solo se usa la hora especificada del día, se ignora la fecha especificada.
  • END_TIME: Es la hora de finalización de la ventana en formato de entrada de fecha y hora. Solo se usa la hora especificada del día, se ignora la fecha especificada. El la fecha y la hora especificadas debe ser posterior a la hora de inicio.

  • MAINTENANCE_RECURRENCE: Es un RRULE para el la recurrencia del período de mantenimiento. Cloud Data Fusion solo admite los siguientes formatos:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA o BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY Esto especifica los valores semanales la recurrencia de la ventana en los días seleccionados, a partir del la hora --maintenance-window-start y por la duración especificada.

Para obtener más información, consulta Configura los plazos y la recurrencia del período de mantenimiento (RRULE).

El siguiente comando crea una instancia con un período de mantenimiento de seis horas todos los sábados y domingos de 12 p.m. a 6 p.m. (UTC).

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'

Actualiza los períodos de mantenimiento de una instancia

Console

Para actualizar el período de mantenimiento en una instancia existente en el la consola de Google Cloud, sigue estos pasos:

  1. Ve a la página de Instancias de Cloud Data Fusion.

    Ir a Instancias

  2. Haz clic en el nombre de la instancia para ver sus detalles.

  3. En la página Detalles de la instancia, navega a Período de mantenimiento. y haz clic en Editar.

  4. Los campos del período de mantenimiento se abren en el modo de edición. Actualiza los valores según sea necesario:

    1. Selecciona la casilla de verificación Habilitar período de mantenimiento.
    2. En el campo Hora de inicio, ingresa una hora en un formato compatible.
    3. En la lista TimeZone, selecciona una zona horaria.
    4. En las listas Días y Duración, selecciona los días de la semana y la duración. de la ventana. Para obtener más información sobre estos parámetros de configuración, consulta Acerca de las operaciones de mantenimiento.

  5. Haz clic en Guardar.

Para obtener más información, consulta Configura los plazos y la recurrencia del período de mantenimiento (RRULE).

API de REST

Para las instancias existentes, actualiza los períodos de mantenimiento con el comando instances.patch solicitud a la API. Esto anula la configuración del período de mantenimiento, si presente. De lo contrario, se establece una configuración nueva, como se menciona en la solicitud cuerpo.

Crea una solicitud a la API de la siguiente manera:

  1. En el parámetro updateMask, especifica la máscara maintenance_policy.
  2. En el cuerpo de la solicitud, especifica el período de mantenimiento configuración de la política:
{
  "maintenancePolicy": {
    "maintenanceWindow": {
        "recurringTimeWindow": {
          "window": {
              "startTime": "START_TIME",
              "endTime": "END_TIME"
          },
          "recurrence": "MAINTENANCE_RECURRENCE"
        }
    },
  }
}

Para obtener más información, consulta Configura los plazos y la recurrencia del período de mantenimiento (RRULE).

En el siguiente ejemplo, se actualiza la configuración de la política de mantenimiento del con un período de mantenimiento de cuatro horas entre las 11 a.m. y las 3 p.m. (UTC) el todos los viernes, sábados y domingos.

// 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

Puedes actualizar el período de mantenimiento de una instancia con el comando gcloud beta data-fusion instances update.

Se deben definir los siguientes parámetros para un período de mantenimiento:

  • --maintenance-window-start establece la hora de inicio de la ventana.
  • --maintenance-window-end establece la hora de finalización de la ventana.
  • --maintenance-window-recurrence establece un RRULE para el la recurrencia del período de mantenimiento.
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

Reemplaza lo siguiente:

  • INSTANCE_NAME: El nombre de la instancia.
  • PROJECT_NAME: el nombre del proyecto.
  • LOCATION: Es el nombre de la región de la instancia.
  • START_TIME: Es la hora de inicio de la ventana en la formato de entrada de fecha y hora. Solo se usa la hora especificada del día, se ignora la fecha especificada.
  • END_TIME: Es la hora de finalización de la ventana en formato de entrada de fecha y hora. Solo se usa la hora especificada del día, se ignora la fecha especificada. El la fecha y la hora especificadas debe ser posterior a la hora de inicio.

  • MAINTENANCE_RECURRENCE: Es un RRULE para el la recurrencia del período de mantenimiento. Cloud Data Fusion solo admite los siguientes formatos:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA o BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY Esto especifica los valores semanales la recurrencia de la ventana en los días seleccionados, a partir del la hora --maintenance-window-start y por la duración especificada.

El siguiente comando actualiza la instancia example-instance con un valor de período de mantenimiento entre las 12 p.m. y las 6 p.m. (UTC) los sábados y domingos cada semana.

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'

Configurar los plazos y la recurrencia del período de mantenimiento (RRULE)

Cuando configuras horas de inicio y finalización del período de mantenimiento, la fecha componentes de las marcas de tiempo proporcionadas se ignoran. Solo la hora del día y entre las horas de inicio y finalización. Los horarios se almacenan en UTC, pero puedes usar UTC o la compensación de tu zona horaria cuando programes períodos de mantenimiento con la API de REST o con gcloud CLI.

Cuando configures la recurrencia, ten en cuenta que RRULE sigue los días UTC, por lo que ajusta según corresponda si tu zona horaria difiere. Por ejemplo, si tu zona horaria es PDT (UTC-7) y deseas que el período de mantenimiento comience a las 21:00 los miércoles de tu zona horaria (que corresponde a las 4:00 UTC los jueves), especifica TH en lugar de WE en la opción BYDAY de RRULE.

Quita el período de mantenimiento de una instancia

Console

Para quitar el período de mantenimiento de una instancia existente en el la consola de Google Cloud, sigue estos pasos:

  1. Ve a la página de Instancias de Cloud Data Fusion.

    Ir a Instancias

  2. Haz clic en el nombre de la instancia para ver sus detalles.

  3. En la página Detalles de la instancia, navega a Período de mantenimiento. y haz clic en Editar.

  4. Para quitar el período de mantenimiento de la instancia, borra el Casilla de verificación Habilitar período de mantenimiento.

  5. Haz clic en Guardar.

API de REST

Para quitar el período de mantenimiento de una instancia, pasa una tarea de mantenimiento vacía de la política en el cuerpo de la solicitud.

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

{
    "maintenancePolicy": {}
}

gcloud

Para quitar el período de mantenimiento de una instancia, usa gcloud beta data-fusion instances update. con la marca --clear-maintenance-window.

gcloud beta data-fusion instances update INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --clear-maintenance-window

Reemplaza lo siguiente:

  • INSTANCE_NAME: El nombre de la instancia.
  • PROJECT_NAME: el nombre del proyecto.
  • LOCATION: Es el nombre de la región de la instancia.

¿Qué sigue?