Esta página se ha traducido con Cloud Translation API.

Configurar ventanas de mantenimiento

En esta página se explica cómo definir ventanas de mantenimiento para instancias de Cloud Data Fusion.

Las ventanas de mantenimiento se admiten en instancias de Cloud Data Fusion con la versión 6.8.0 y posteriores.

Acerca de las ventanas de mantenimiento

Una ventana de mantenimiento en Cloud Data Fusion es un periodo durante el cual permites que se realicen operaciones de mantenimiento, lo que reduce el riesgo de que se produzcan interrupciones del servicio durante las horas de mayor uso. Si programas las ventanas de mantenimiento durante las horas de menor actividad, se minimizará el impacto en tus instancias de Cloud Data Fusion y en las ejecuciones de tus flujos de procesamiento.

Configurar ventanas de mantenimiento te permite controlar cuándo se realizan las operaciones de mantenimiento en tu instancia:

Si se define una ventana de mantenimiento, Cloud Data Fusion realizará las operaciones de mantenimiento dentro de los periodos definidos.
Si no se define ninguna ventana de mantenimiento, se puede llevar a cabo en cualquier momento.

Acerca de las operaciones de mantenimiento

Para garantizar la seguridad y el cumplimiento del sistema, Cloud Data Fusion lleva a cabo operaciones de mantenimiento periódicas. Estas operaciones incluyen la aplicación de actualizaciones críticas y parches de seguridad para mitigar las vulnerabilidades y proteger los datos de los usuarios. Las ventanas de mantenimiento programadas aseguran que las actualizaciones se apliquen de forma eficiente, se conserve la integridad del sistema y se minimicen las interrupciones en las instancias y las ejecuciones de la canalización.

Cuando configures las ventanas de mantenimiento, debes asignar al menos 12 horas a la semana a las operaciones de mantenimiento. Cada ventana debe durar entre 4 y 12 horas.
Durante las horas de la ventana de mantenimiento, es posible que algunas operaciones se vean afectadas. Te recomendamos que programes las ventanas de mantenimiento durante las horas de menor uso. La operación de mantenimiento puede afectar a Cloud Data Fusion de las siguientes formas:
- La interfaz de Cloud Data Fusion Studio puede no estar disponible temporalmente.
- La ejecución de la canalización puede verse afectada y provocar un error.
- Es posible que los servicios de Cloud Data Fusion no funcionen temporalmente, lo que provocará que las llamadas a la API fallen.
- Es posible que las instancias no funcionen correctamente durante un máximo de una hora durante el periodo de mantenimiento. Te recomendamos que configures ventanas de mantenimiento cuando tus flujos de datos no se estén ejecutando o no estén programados para ejecutarse.

Especificar ventanas de mantenimiento al crear una instancia

Consola

Para definir la ventana de mantenimiento al crear una instancia, sigue estos pasos:

Ve a la página Instancias de Cloud Data Fusion y haz clic en Crear instancia.
Crear una instancia
Escriba un nombre de instancia y una edición. Para obtener más información sobre cada campo, consulta Crear una instancia.
Expande la sección Opciones avanzadas.
Despliegue la sección Mantenimiento y siga estos pasos:
1. Marca la casilla Habilitar ventana de mantenimiento.
2. En el campo Hora de inicio, introduce una hora en un formato admitido.
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 ajustes, consulta Acerca de las operaciones de mantenimiento.
5. Haz clic en Crear.

Para obtener más información, consulta Configurar las horas y la periodicidad (RRULE) de la ventana de mantenimiento.

API REST

Define la configuración de Instance con la API instance.create:

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

Haz los cambios siguientes:

START_TIME: hora de inicio del periodo, en formato RFC 3339.
END_TIME: hora de finalización del periodo, en formato RFC 3339.
MAINTENANCE_RECURRENCE: una RRULE para la periodicidad de la ventana 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. Especifica la periodicidad semanal de la ventana en los días seleccionados, a partir de las startTime y durante la duración especificada.

Para obtener más información, consulta Configurar las horas y la periodicidad (RRULE) de la ventana de mantenimiento.

En el siguiente ejemplo se crea una instancia con una ventana de mantenimiento de seis horas, de 10:00 a 16:00 (UTC), los sábados y los domingos de cada semana. Para obtener más información, 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 la ventana de mantenimiento al crear una instancia con el comando gcloud beta data-fusion instances create.

Deben definirse los siguientes parámetros para una ventana de mantenimiento:

--maintenance-window-start define la hora de inicio de la ventana.
--maintenance-window-end define la hora de finalización de la ventana.
--maintenance-window-recurrence define una RRULE para la periodicidad de la ventana 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

Haz los cambios siguientes:

INSTANCE_NAME: el nombre de la instancia.
PROJECT_NAME: el nombre del proyecto.
LOCATION: el nombre de la región de la instancia.
START_TIME: hora de inicio de la ventana en el formato de entrada de fecha y hora. Solo se usa la hora del día especificada, la fecha se ignora.
END_TIME: hora de finalización de la ventana en el formato de entrada de fecha y hora. Solo se usa la hora del día especificada, la fecha se ignora. La fecha y la hora especificadas deben ser posteriores a la hora de inicio.
MAINTENANCE_RECURRENCE: una RRULE para la periodicidad de la ventana 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. Especifica la periodicidad semanal de la ventana en los días seleccionados, a partir de la hora --maintenance-window-start y durante la duración especificada.

Para obtener más información, consulta Configurar las horas y la periodicidad (RRULE) de la ventana de mantenimiento.

El siguiente comando crea una instancia con una ventana de mantenimiento de seis horas, de 12:00 a 18:00 (UTC) los sábados y los domingos de cada semana.

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'

Actualizar las ventanas de mantenimiento de una instancia

Consola

Para actualizar la ventana de mantenimiento de una instancia en la consolaGoogle Cloud , sigue estos pasos:

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

Ir a Instancias
Haz clic en el nombre de la instancia para ver sus detalles.
En la página Detalles de la instancia, vaya al campo Ventana de mantenimiento y haga clic en Editar.
Los campos de la ventana de mantenimiento se abren en el modo de edición. Actualice los valores según sea necesario:
1. Marca la casilla Habilitar ventana de mantenimiento.
2. En el campo Hora de inicio, introduce una hora en un formato admitido.
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 ajustes, consulta Acerca de las operaciones de mantenimiento.
Haz clic en Guardar.

Para obtener más información, consulta Configurar las horas y la periodicidad (RRULE) de la ventana de mantenimiento.

API REST

En el caso de las instancias actuales, actualiza las ventanas de mantenimiento mediante la solicitud de la API instances.patch. Esta opción anula la configuración de la ventana de mantenimiento, si está presente. De lo contrario, se establece una nueva configuración, tal como se menciona en el cuerpo de la solicitud.

Crea una solicitud de API de la siguiente manera:

En el parámetro updateMask, especifique la máscara maintenance_policy.
En el cuerpo de la solicitud, especifica la ventana de mantenimiento en la configuración de maintenance_policy:

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

Para obtener más información, consulta Configurar las horas y la periodicidad (RRULE) de la ventana de mantenimiento.

En el siguiente ejemplo se actualiza la configuración de la política de mantenimiento de la instancia con una ventana de mantenimiento de cuatro horas, de 11:00 a 15:00 (UTC), los viernes, sábados y domingos de cada semana.

// 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 la ventana de mantenimiento de una instancia con el comando gcloud beta data-fusion instances update.

Deben definirse los siguientes parámetros para una ventana de mantenimiento:

--maintenance-window-start define la hora de inicio de la ventana.
--maintenance-window-end define la hora de finalización de la ventana.
--maintenance-window-recurrence define una RRULE para la periodicidad de la ventana 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

Haz los cambios siguientes:

INSTANCE_NAME: el nombre de la instancia.
PROJECT_NAME: el nombre del proyecto.
LOCATION: el nombre de la región de la instancia.
START_TIME: hora de inicio de la ventana en el formato de entrada de fecha y hora. Solo se usa la hora del día especificada, la fecha se ignora.
END_TIME: hora de finalización de la ventana en el formato de entrada de fecha y hora. Solo se usa la hora del día especificada, la fecha se ignora. La fecha y la hora especificadas deben ser posteriores a la hora de inicio.
MAINTENANCE_RECURRENCE: una RRULE para la periodicidad de la ventana 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. Especifica la periodicidad semanal de la ventana en los días seleccionados, a partir de la hora --maintenance-window-start y durante la duración especificada.

El siguiente comando actualiza la instancia example-instance con una ventana de mantenimiento de seis horas entre las 12:00 y las 18:00 (UTC) de los sábados y domingos de 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 las horas y la periodicidad (RRULE) de la ventana de mantenimiento

Cuando configuras las horas de inicio y finalización de la ventana de mantenimiento, se ignoran los componentes de fecha de las marcas de tiempo proporcionadas. Solo se tienen en cuenta la hora del día y la duración entre la hora de inicio y la de finalización. Las horas se almacenan en UTC, pero puedes usar UTC o el desfase de tu zona horaria al programar ventanas de mantenimiento con la API REST o la CLI de gcloud.

Cuando configures la recurrencia, ten en cuenta que RRULE sigue los días UTC, así que haz los ajustes necesarios si tu zona horaria es diferente. Por ejemplo, si tu zona horaria es PDT (UTC-7) y quieres que una ventana de mantenimiento empiece a las 21:00 los miércoles en 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.

que utilices la zona horaria UTC al especificar la ventana de mantenimiento a través de la API REST o de la CLI de gcloud.

Eliminar la ventana de mantenimiento de una instancia

Consola

Para quitar la ventana de mantenimiento de una instancia en la consolaGoogle Cloud , sigue estos pasos:

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

Ir a Instancias
Haz clic en el nombre de la instancia para ver sus detalles.
En la página Detalles de la instancia, vaya al campo Ventana de mantenimiento y haga clic en Editar.
Para quitar la ventana de mantenimiento de la instancia, desmarca la casilla Habilitar ventana de mantenimiento.
Haz clic en Guardar.

API REST

Para quitar la ventana de mantenimiento de una instancia, envía un objeto de política de mantenimiento vacío 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 la ventana de mantenimiento de una instancia, usa el comando 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

Haz los cambios siguientes:

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

Siguientes pasos

Consulta la documentación de la API Instances.

Configurar ventanas de mantenimiento Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Acerca de las ventanas de mantenimiento

Acerca de las operaciones de mantenimiento

Especificar ventanas de mantenimiento al crear una instancia

Consola

API REST

gcloud

Actualizar las ventanas de mantenimiento de una instancia

Consola

API REST

gcloud

Configurar las horas y la periodicidad (RRULE) de la ventana de mantenimiento

Eliminar la ventana de mantenimiento de una instancia

Consola

API REST

gcloud

Siguientes pasos

Configurar ventanas de mantenimiento