Cette page explique comment définir des intervalles de maintenance pour les instances Cloud Data Fusion.
Les intervalles de maintenance sont compatibles avec les instances Cloud Data Fusion dans les versions 6.8.0 et ultérieures.
À propos des intervalles de maintenance
Un intervalle de maintenance dans Cloud Data Fusion est une période pendant laquelle vous autorisez l'exécution d'opérations de maintenance, ce qui réduit le risque d'interruption de service pendant les périodes de forte utilisation. La planification d'intervalles de maintenance pendant les heures creuses ou les périodes de faible activité minimise leur impact sur vos instances Cloud Data Fusion et vos exécutions de pipelines.
Le fait de configurer l'intervalle de maintenance vous permet de contrôler quand les opérations de maintenance doivent se produire sur votre instance :
- Si l'intervalle de maintenance est défini, les opérations de maintenance sont effectuées par Cloud Data Fusion pendant les périodes définies.
- Si l'intervalle de maintenance n'est pas défini, la maintenance peut être effectuée à tout moment.
À propos des opérations de maintenance
Pour garantir la sécurité et la conformité du système, Cloud Data Fusion effectue des opérations de maintenance régulières. Ces opérations incluent l'application de mises à jour critiques et de correctifs de sécurité pour atténuer les failles et protéger les données utilisateur. Les intervalles de maintenance planifiés garantissent que les mises à jour sont appliquées efficacement, ce qui préserve l'intégrité du système et minimise les interruptions pour les instances et les exécutions de pipelines.
- Lorsque vous configurez les intervalles de maintenance, vous devez allouer au moins 12 heures par semaine aux opérations de maintenance. Chaque intervalle doit durer entre 4 et 12 heures.
Pendant les heures d'intervalle de maintenance, certaines opérations peuvent être affectées. Nous vous recommandons de prévoir des intervalles de maintenance pendant les périodes de faible utilisation. L'opération de maintenance peut affecter Cloud Data Fusion de la manière suivante :
- L'interface Cloud Data Fusion Studio peut être temporairement indisponible.
- L'exécution du pipeline peut être affectée, ce qui entraîne un échec.
- Les services Cloud Data Fusion peuvent être temporairement indisponibles, ce qui entraîne l'échec des appels d'API.
- Les instances peuvent ne pas être entièrement fonctionnelles pendant une heure au maximum pendant les heures d'intervalle de maintenance. Nous vous recommandons de configurer des intervalles de maintenance lorsque vos pipelines ne sont pas en cours d'exécution ou ne sont pas programmés pour s'exécuter.
Spécifier des intervalles de maintenance lors de la création d'une instance
Console
Pour définir l'intervalle de maintenance lorsque vous créez une instance, procédez comme suit :
- Accédez à la page Instances de Cloud Data Fusion, puis cliquez sur Créer une instance.
- Saisissez un Nom d'instance et une Édition. Pour en savoir plus sur chaque champ, consultez Créer une instance.
- Développez la section Options avancées.
- Développez la section Maintenance et procédez comme suit :
- Cochez la case Activer l'intervalle de maintenance.
- Dans le champ Heure de début, saisissez une heure dans un format compatible.
- Dans la liste TimeZone, sélectionnez un fuseau horaire.
- Dans les listes Jours et Durée, sélectionnez les jours de la semaine et la durée de l'intervalle. Pour en savoir plus sur ces paramètres, consultez À propos des opérations de maintenance.
- Cliquez sur Créer.
Pour en savoir plus, consultez Configurer les heures et la récurrence de l'intervalle de maintenance (RRULE).
API REST
- Définissez la configuration
Instanceà l'aide de l'APIinstance.create:
{
"name": string,
"description": string,
…
…
"maintenancePolicy": {
"maintenanceWindow": {
"recurringTimeWindow": {
"window": {
"startTime": "START_TIME",
"endTime": "END_TIME"
},
"recurrence": "MAINTENANCE_RECURRENCE"
}
},
}
}
Remplacez les éléments suivants :
START_TIME: heure de début de l'intervalle, au format RFC 3339.END_TIME: heure de fin de l'intervalle, au format RFC 3339.MAINTENANCE_RECURRENCE: RRULE pour la récurrence de l'intervalle de maintenance. Cloud Data Fusion n'est compatible qu'avec les formats suivants :FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SAouBYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Cela spécifie la récurrence hebdomadaire de l'intervalle les jours sélectionnés, à partir destartTimeet pour la durée spécifiée.
Pour en savoir plus, consultez Configurer les heures et la récurrence de l'intervalle de maintenance (RRULE).
L'exemple suivant crée une instance avec un intervalle de maintenance de six heures entre 10h et 16h (UTC) tous les samedis et dimanches. Pour en savoir plus, consultez la documentation de l'API Instances.
// 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
Vous pouvez spécifier l'intervalle de maintenance lors de la création d'une instance à l'aide de la commande gcloud beta data-fusion instances create.
Les paramètres suivants doivent être définis pour un intervalle de maintenance :
--maintenance-window-startdéfinit l'heure de début de l'intervalle.--maintenance-window-enddéfinit l'heure de fin de l'intervalle.--maintenance-window-recurrencedéfinit un RRULE pour la récurrence de l'intervalle de maintenance.
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
Remplacez les éléments suivants :
INSTANCE_NAME: nom de l'instance.PROJECT_NAME: nom du projet.LOCATION: nom de la région de l'instance.START_TIME: heure de début de l'intervalle au format "date/heure". Seule l'heure spécifiée est utilisée, la date est ignorée.END_TIME: heure de fin de l'intervalle au format "date/heure". Seule l'heure spécifiée est utilisée, la date est ignorée. La date et l'heure spécifiées doivent être postérieures à la date et à l'heure de début.MAINTENANCE_RECURRENCE: RRULE pour la récurrence de l'intervalle de maintenance. Cloud Data Fusion n'est compatible qu'avec les formats suivants :FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SAouBYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Cela spécifie la récurrence hebdomadaire de l'intervalle les jours sélectionnés, à partir de l'heure--maintenance-window-startet pour la durée spécifiée.
Pour en savoir plus, consultez Configurer les heures et la récurrence de l'intervalle de maintenance (RRULE).
La commande suivante crée une instance avec un intervalle de maintenance de six heures entre 12h et 18h (UTC) tous les samedis et dimanches.
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'
Mettre à jour les intervalles de maintenance d'une instance
Console
Pour mettre à jour l'intervalle de maintenance dans une instance existante dans la Google Cloud console, procédez comme suit :
Accédez à la page Instances de Cloud Data Fusion.
Cliquez sur le nom de l'instance pour afficher ses détails.
Sur la page Détails de l'instance , accédez au champ Intervalle de maintenance , puis cliquez sur Modifier.
Les champs d'intervalle de maintenance s'ouvrent en mode Édition. Modifiez les valeurs si nécessaire :
- Cochez la case Activer l'intervalle de maintenance.
- Dans le champ Heure de début, saisissez une heure dans un format compatible.
- Dans la liste TimeZone, sélectionnez un fuseau horaire.
- Dans les listes Jours et Durée, sélectionnez les jours de la semaine et la durée de l'intervalle. Pour en savoir plus sur ces paramètres, consultez À propos des opérations de maintenance.
Cliquez sur Enregistrer.
Pour en savoir plus, consultez Configurer les heures et la récurrence de l'intervalle de maintenance (RRULE).
API REST
Pour les instances existantes, mettez à jour les intervalles de maintenance à l'aide de la
instances.patch
requête d'API. Cela remplace la configuration d'intervalle de maintenance existante, le cas échéant. Sinon, une nouvelle configuration est définie, comme indiqué dans le corps de la requête.
Créez une requête d'API comme suit :
- Dans le paramètre
updateMask, spécifiez le masquemaintenance_policy. - Dans le corps de la requête, spécifiez l'intervalle de maintenance dans la configuration de la règle de maintenance :
{
"maintenancePolicy": {
"maintenanceWindow": {
"recurringTimeWindow": {
"window": {
"startTime": "START_TIME",
"endTime": "END_TIME"
},
"recurrence": "MAINTENANCE_RECURRENCE"
}
},
}
}
Pour en savoir plus, consultez Configurer les heures et la récurrence de l'intervalle de maintenance (RRULE).
L'exemple suivant met à jour la configuration de la règle de maintenance de l'instance avec un intervalle de maintenance de quatre heures entre 11h et 15h (UTC) tous les vendredis, samedis et dimanches.
// 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
Vous pouvez mettre à jour l'intervalle de maintenance d'une instance à l'aide de la gcloud beta data-fusion instances update commande.
Les paramètres suivants doivent être définis pour un intervalle de maintenance :
--maintenance-window-startdéfinit l'heure de début de l'intervalle.--maintenance-window-enddéfinit l'heure de fin de l'intervalle.--maintenance-window-recurrencedéfinit un RRULE pour la récurrence de l'intervalle de maintenance.
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
Remplacez les éléments suivants :
INSTANCE_NAME: nom de l'instance.PROJECT_NAME: nom du projet.LOCATION: nom de la région de l'instance.START_TIME: heure de début de l'intervalle au format "date/heure". Seule l'heure spécifiée est utilisée, la date est ignorée.END_TIME: heure de fin de l'intervalle au format "date/heure". Seule l'heure spécifiée est utilisée, la date est ignorée. La date et l'heure spécifiées doivent être postérieures à la date et à l'heure de début.MAINTENANCE_RECURRENCE: RRULE pour la récurrence de l'intervalle de maintenance. Cloud Data Fusion n'est compatible qu'avec les formats suivants :FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SAouBYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Cela spécifie la récurrence hebdomadaire de l'intervalle les jours sélectionnés, à partir de l'heure--maintenance-window-startet pour la durée spécifiée.
La commande suivante met à jour l'instance example-instance avec un intervalle de maintenance de six heures entre 12h et 18h (UTC) tous les samedis et dimanches.
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'
Configurer les heures et la récurrence de l'intervalle de maintenance (RRULE)
Lorsque vous configurez les heures de début et de fin de l'intervalle de maintenance, les composants de date des codes temporels fournis sont ignorés. Seules l'heure de la journée et la durée entre l'heure de début et l'heure de fin sont prises en compte. Les heures sont stockées au format UTC, mais vous pouvez utiliser le format UTC ou votre décalage de fuseau horaire lorsque vous planifiez des intervalles de maintenance à l'aide de l'API REST ou de gcloud CLI.
Lorsque vous configurez la récurrence, n'oubliez pas que RRULE suit les jours UTC. Ajustez-la donc en conséquence si votre fuseau horaire est différent. Par exemple, si votre fuseau horaire est PDT (UTC-7) et que vous souhaitez qu'un intervalle de maintenance commence à 21h le mercredi dans votre fuseau horaire (ce qui correspond à 4h UTC le jeudi), spécifiez TH au lieu de WE dans l'option BYDAY du RRULE.
Supprimer l'intervalle de maintenance d'une instance
Console
Pour supprimer l'intervalle de maintenance dans une instance existante dans la Google Cloud console, procédez comme suit :
Accédez à la page Instances de Cloud Data Fusion.
Cliquez sur le nom de l'instance pour afficher ses détails.
Sur la page Détails de l'instance , accédez au champ Intervalle de maintenance , puis cliquez sur Modifier.
Pour supprimer l'intervalle de maintenance de l'instance, décochez la case Activer l'intervalle de maintenance.
Cliquez sur Enregistrer.
API REST
Pour supprimer l'intervalle de maintenance d'une instance, transmettez un objet de règle de maintenance vide dans le corps de la requête.
// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy
{
"maintenancePolicy": {}
}
gcloud
Pour supprimer l'intervalle de maintenance d'une instance, utilisez gcloud beta data-fusion instances update
commande avec l'--clear-maintenance-window option.
gcloud beta data-fusion instances update INSTANCE_NAME \
--project=PROJECT_NAME \
--location=LOCATION \
--clear-maintenance-window
Remplacez les éléments suivants :
INSTANCE_NAME: nom de l'instance.PROJECT_NAME: nom du projet.LOCATION: nom de la région de l'instance.
Étape suivante
- Consultez la documentation de l'API Instances.