Nesta página, explicamos como definir janelas de manutenção para o Cloud Data Fusion instâncias.
As janelas de manutenção têm suporte para instâncias do Cloud Data Fusion em 6.8.0 e posteriores.
Sobre as janelas de manutenção
Uma janela de manutenção no Cloud Data Fusion é um período em que você que permitem a realização de operações de manutenção, reduzindo o risco e interrupções durante os horários de pico de uso. Como programar janelas de manutenção durante fora dos horários de pico, ou momentos em que sua atividade é menor, minimiza o impacto sobre as instâncias do Cloud Data Fusion e as execuções de pipeline.
Configurar janelas de manutenção permite controlar quando as operações de manutenção ocorrer na sua instância:
- Se a janela de manutenção for definida, as operações de manutenção serão executadas pelo Cloud Data Fusion nos períodos definidos.
- Se a janela de manutenção não estiver definida, a manutenção poderá ser realizada a qualquer tempo de resposta.
Sobre as operações de manutenção
Para garantir a segurança e a conformidade do sistema, o Cloud Data Fusion realiza durante as operações de manutenção regular. Essas operações incluem a aplicação atualizações e patches de segurança para mitigar vulnerabilidades e proteger os dados dos usuários. As janelas de manutenção programadas garantem a aplicação eficiente das atualizações, preservar a integridade do sistema e minimizar as interrupções em instâncias e pipelines execuções.
- Ao configurar as janelas de manutenção, é preciso alocar pelo menos 12 horas por semana para operações de manutenção. Cada janela deve ter entre 4 e 12 horas.
Durante as horas da janela de manutenção, algumas operações podem ser afetadas. Recomendamos que você tenha janelas de manutenção fora dos horários de pico de uso. A operação de manutenção pode afetar o Cloud Data Fusion das seguintes maneiras:
- A interface do Studio do Cloud Data Fusion pode ficar temporariamente indisponível.
- A execução do pipeline pode ser afetada, causando falhas.
- Os serviços do Cloud Data Fusion podem estar temporariamente indisponíveis, causando que as chamadas falhem.
- As instâncias podem não funcionar totalmente por até uma hora durante e as janelas de manutenção. Recomendamos que você faça a manutenção janelas quando os pipelines não estão em execução ou não estão programados para correr.
Especificar janelas de manutenção ao criar uma instância
Console
Para definir a janela de manutenção ao criar uma instância, siga estas etapas:
- Acesse a página Instâncias do Cloud Data Fusion e clique em Criar instância.
- Preencha o campo Nome da instância e a Edição. Para mais informações sobre cada campo, consulte Criar uma instância.
- Expanda a seção Opções avançadas.
- Expanda a seção Manutenção e siga estas etapas:
- Marque a caixa de seleção Ativar janela de manutenção.
- No campo Horário de início, insira um horário em um formato compatível.
- Na lista TimeZone, selecione um fuso horário.
- Nas listas Dias e Duração, selecione os dias da semana e duração do período. Para mais informações sobre essas configurações, consulte Sobre as operações de manutenção.
- Clique em Criar.
Para mais informações, consulte Configurar recorrências e horários da janela de manutenção (RRULE)
API REST
- Defina a configuração
Instance
usando a APIinstance.create
:
{
"name": string,
"description": string,
…
…
"maintenancePolicy": {
"maintenanceWindow": {
"recurringTimeWindow": {
"window": {
"startTime": "START_TIME",
"endTime": "END_TIME"
},
"recurrence": "MAINTENANCE_RECURRENCE"
}
},
}
}
Substitua:
START_TIME
: horário de início da janela de tempo. no formato RFC 3339.END_TIME
: horário de término da janela de horário, em formato RFC 3339.MAINTENANCE_RECURRENCE
: um RRULE para o recorrência da janela de manutenção. O Cloud Data Fusion só aceita os seguintes formatos:FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA
ouBYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY
. Isso especifica a frequência recorrência da janela nos dias selecionados, começando nostartTime
e pela duração especificada.
Para mais informações, consulte Configurar recorrências e horários da janela de manutenção (RRULE)
O exemplo a seguir cria uma instância com uma janela de manutenção de seis horas entre 10h e 16h (UTC), aos sábados e domingos, toda semana. Para mais mais informações, consulte a documentação da API de instâncias.
// 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
É possível especificar a janela de manutenção ao criar uma instância usando o comando gcloud beta data-fusion instances create
.
Os parâmetros a seguir precisam ser definidos para uma janela de manutenção:
--maintenance-window-start
define o horário de início da janela.--maintenance-window-end
define o horário de término da janela.--maintenance-window-recurrence
define um RRULE para o recorrência da janela de manutenção.
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
Substitua:
INSTANCE_NAME
: o nome da instância.PROJECT_NAME
: o nome do projeto.LOCATION
: o nome da região da instância.START_TIME
: o horário de início da janela no formato de entrada de data/hora. Somente a hora especificada do dia é usada, a data especificada é ignorada.END_TIME
: o horário de término da janela no formato de entrada de data/hora. Somente a hora especificada do dia é usada, a data especificada é ignorada. A a data e a hora especificadas devem ser posteriores à hora de início.MAINTENANCE_RECURRENCE
: um RRULE para o recorrência da janela de manutenção. O Cloud Data Fusion só aceita os seguintes formatos:FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA
ouBYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY
. Isso especifica a frequência recorrência da janela nos dias selecionados, começando no--maintenance-window-start
vez e pela duração especificada.
Para mais informações, consulte Configurar recorrências e horários da janela de manutenção (RRULE)
O comando a seguir cria uma instância com uma janela de manutenção de seis horas entre 12h e 18h (UTC), todos os sábados e domingos, toda 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'
Atualizar as janelas de manutenção de uma instância
Console
Para atualizar a janela de manutenção em uma instância existente no Console do Google Cloud, siga estas etapas:
Acesse a página Instâncias do Cloud Data Fusion.
Clique no nome da instância para ver os detalhes dela.
Na página Detalhes da instância, navegue até a Janela de manutenção. campo e clique em Editar.
Os campos da janela de manutenção são abertos no modo de edição. Atualize os valores conforme necessário:
- Marque a caixa de seleção Ativar janela de manutenção.
- No campo Horário de início, insira um horário em um formato compatível.
- Na lista TimeZone, selecione um fuso horário.
- Nas listas Dias e Duração, selecione os dias da semana e a duração. de janela. Para mais informações sobre essas configurações, consulte Sobre as operações de manutenção.
Clique em Salvar.
Para mais informações, consulte Configurar recorrências e horários da janela de manutenção (RRULE)
API REST
Para as instâncias existentes, atualize as janelas de manutenção com o
instances.patch
solicitação de API. Isso substitui a configuração da janela de manutenção atual, se
presente. Caso contrário, uma nova configuração será definida, conforme mencionado na solicitação.
corpo
Crie uma solicitação de API da seguinte maneira:
- No parâmetro
updateMask
, especifique a máscaramaintenance_policy
. - No corpo da solicitação, especifique a janela de manutenção configuração da política:
{
"maintenancePolicy": {
"maintenanceWindow": {
"recurringTimeWindow": {
"window": {
"startTime": "START_TIME",
"endTime": "END_TIME"
},
"recurrence": "MAINTENANCE_RECURRENCE"
}
},
}
}
Para mais informações, consulte Configurar recorrências e horários da janela de manutenção (RRULE)
O exemplo a seguir atualiza a configuração da política de manutenção do com uma janela de manutenção de quatro horas entre 11h e 15h (UTC) toda semana, na sexta, no sábado e no domingo.
// 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
É possível atualizar a janela de manutenção de uma instância usando o comando gcloud beta data-fusion instances update
.
Os parâmetros a seguir precisam ser definidos para uma janela de manutenção:
--maintenance-window-start
define o horário de início da janela.--maintenance-window-end
define o horário de término da janela.--maintenance-window-recurrence
define um RRULE para o recorrência da janela de manutenção.
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
Substitua:
INSTANCE_NAME
: o nome da instância.PROJECT_NAME
: o nome do projeto.LOCATION
: o nome da região da instância.START_TIME
: o horário de início da janela no formato de entrada de data/hora. Somente a hora especificada do dia é usada, a data especificada é ignorada.END_TIME
: o horário de término da janela no formato de entrada de data/hora. Somente a hora especificada do dia é usada, a data especificada é ignorada. A a data e a hora especificadas devem ser posteriores à hora de início.MAINTENANCE_RECURRENCE
: um RRULE para o recorrência da janela de manutenção. O Cloud Data Fusion só aceita os seguintes formatos:FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA
ouBYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY
. Isso especifica a frequência recorrência da janela nos dias selecionados, começando no--maintenance-window-start
vez e pela duração especificada.
O comando a seguir atualiza a instância example-instance
com um comando
período de manutenção das 12h às 18h (UTC) aos sábados e domingos.
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 os horários da janela de manutenção e a recorrência (RRULE)
Quando você configura os horários de início e término da janela de manutenção, componentes dos carimbos de data/hora fornecidos são ignorados. Apenas a hora do dia e entre os horários de início e término são consideradas. Os horários são armazenados em UTC, mas use o UTC ou o deslocamento de fuso horário ao programar janelas de manutenção usando a API REST ou a CLI gcloud.
Ao configurar a recorrência, tenha em mente que o RRULE segue os dias UTC, portanto,
faça os ajustes necessários caso seu fuso horário seja diferente. Por exemplo, se seu fuso horário for
PDT (UTC-7) e você quiser que uma janela de manutenção comece às 21h nas quartas-feiras de
seu fuso horário (que corresponde a 4h UTC às quintas-feiras), especifique TH
em vez de WE
na opção BYDAY
do RRULE.
Remover a janela de manutenção de uma instância
Console
Para remover a janela de manutenção de uma instância existente no Console do Google Cloud, siga estas etapas:
Acesse a página Instâncias do Cloud Data Fusion.
Clique no nome da instância para ver os detalhes dela.
Na página Detalhes da instância, navegue até a Janela de manutenção. campo e clique em Editar.
Para remover a janela de manutenção da instância, limpe a Caixa de seleção Ativar janela de manutenção.
Clique em Salvar.
API REST
Para remover a janela de manutenção de uma instância, passe uma solicitação de objeto de política no corpo da solicitação.
// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy
{
"maintenancePolicy": {}
}
gcloud
Para remover a janela de manutenção de uma instância, use gcloud beta data-fusion instances update
.
com a sinalização --clear-maintenance-window
.
gcloud beta data-fusion instances update INSTANCE_NAME \
--project=PROJECT_NAME \
--location=LOCATION \
--clear-maintenance-window
Substitua:
INSTANCE_NAME
: o nome da instância.PROJECT_NAME
: o nome do projeto.LOCATION
: o nome da região da instância.
A seguir
- Consulte a documentação da API de instâncias.