Halaman ini diterjemahkan oleh Cloud Translation API.

Mengonfigurasi masa pemeliharaan

Halaman ini menjelaskan cara menentukan jendela pemeliharaan untuk instance Cloud Data Fusion.

Periode pemeliharaan didukung untuk instance Cloud Data Fusion di versi 6.8.0 dan yang lebih baru.

Tentang masa pemeliharaan

Masa pemeliharaan di Cloud Data Fusion adalah jangka waktu saat Anda mengizinkannya melakukan operasi pemeliharaan, sehingga mengurangi risiko gangguan layanan selama waktu penggunaan puncak. Menjadwalkan masa pemeliharaan di luar jam sibuk, atau saat aktivitas Anda lebih rendah, akan meminimalkan dampaknya pada instance Cloud Data Fusion dan eksekusi pipeline Anda.

Dengan mengonfigurasi masa pemeliharaan, Anda dapat mengontrol waktu terjadinya operasi pemeliharaan di instance Anda:

Jika masa pemeliharaan ditentukan, operasi pemeliharaan dilakukan oleh Cloud Data Fusion dalam periode yang ditentukan.
Jika masa pemeliharaan tidak ditentukan, pemeliharaan dapat dilakukan kapan saja.

Tentang operasi pemeliharaan

Untuk memastikan keamanan dan kepatuhan sistem, Cloud Data Fusion melakukan operasi pemeliharaan rutin. Operasi ini mencakup penerapan update dan patch keamanan penting untuk mengurangi kerentanan dan melindungi data pengguna. Periode pemeliharaan terjadwal memastikan bahwa update diterapkan secara efisien, menjaga integritas sistem dan meminimalkan gangguan pada eksekusi instance dan pipeline.

Saat mengonfigurasi masa pemeliharaan, Anda harus mengalokasikan setidaknya 12 jam per minggu untuk operasi pemeliharaan. Setiap periode harus antara 4 dan 12 jam.
Selama jam masa pemeliharaan, operasi tertentu mungkin terpengaruh. Sebaiknya lakukan pemeliharaan selama waktu penggunaan non-puncak. Operasi pemeliharaan dapat memengaruhi Cloud Data Fusion dengan cara berikut:
- Antarmuka Cloud Data Fusion Studio mungkin tidak tersedia untuk sementara.
- Eksekusi pipeline mungkin terpengaruh, sehingga menyebabkan kegagalan.
- Layanan Cloud Data Fusion mungkin tidak berfungsi untuk sementara, sehingga menyebabkan panggilan API gagal.
- Instance mungkin tidak berfungsi sepenuhnya hingga satu jam selama jam masa pemeliharaan. Sebaiknya siapkan periode pemeliharaan saat pipeline Anda tidak berjalan atau tidak dijadwalkan untuk berjalan.

Menentukan masa pemeliharaan saat membuat instance

Konsol

Untuk menyetel masa pemeliharaan saat Anda membuat instance, ikuti langkah-langkah berikut:

Buka halaman Instances Cloud Data Fusion, lalu klik Create instance.
Membuat instance
Masukkan Nama instance dan Edisi. Untuk mengetahui informasi selengkapnya tentang setiap kolom, lihat Membuat instance.
Luaskan bagian Advanced options.
Luaskan bagian Pemeliharaan dan ikuti langkah-langkah berikut:
1. Centang kotak Aktifkan jendela pemeliharaan.
2. Di kolom Start time, masukkan waktu dalam format yang didukung.
3. Di daftar TimeZone, pilih zona waktu.
4. Dalam daftar Hari dan Durasi, pilih hari dalam seminggu dan durasi periode. Untuk mengetahui informasi selengkapnya tentang setelan ini, lihat Tentang operasi pemeliharaan.
5. Klik Buat.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE).

REST API

Tetapkan konfigurasi Instance menggunakan API instance.create:

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

Ganti kode berikut:

START_TIME: waktu mulai periode waktu, dalam format RFC 3339.
END_TIME: waktu berakhir jendela waktu, dalam format RFC 3339.
MAINTENANCE_RECURRENCE: RRULE untuk pengulangan masa pemeliharaan. Cloud Data Fusion hanya mendukung format berikut:
- FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA atau BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Ini menentukan pengulangan mingguan jendela pada hari yang dipilih, dimulai pada startTime, dan selama durasi yang ditentukan.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE).

Contoh berikut membuat instance dengan masa pemeliharaan enam jam antara pukul 10.00 hingga 16.00 (UTC) pada hari Sabtu dan Minggu setiap minggu. Untuk mengetahui informasi selengkapnya, lihat dokumentasi API instance.

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

Anda dapat menentukan masa pemeliharaan saat membuat instance menggunakan perintah gcloud beta data-fusion instances create.

Parameter berikut harus ditentukan untuk periode pemeliharaan:

--maintenance-window-start menetapkan waktu mulai jendela.
--maintenance-window-end menetapkan waktu berakhir jendela.
--maintenance-window-recurrence menetapkan RRULE untuk pengulangan masa pemeliharaan.

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

Ganti kode berikut:

INSTANCE_NAME: nama instance.
PROJECT_NAME: nama project.
LOCATION: nama region instance.
START_TIME: waktu mulai periode dalam format input tanggal/waktu. Hanya waktu yang ditentukan yang digunakan, tanggal yang ditentukan akan diabaikan.
END_TIME: waktu berakhir jendela dalam format input tanggal/waktu. Hanya waktu yang ditentukan yang digunakan, tanggal yang ditentukan akan diabaikan. Tanggal dan waktu yang ditentukan harus setelah waktu mulai.
MAINTENANCE_RECURRENCE: RRULE untuk pengulangan masa pemeliharaan. Cloud Data Fusion hanya mendukung format berikut:
- FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA atau BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Setelan ini menentukan pengulangan jendela setiap minggu pada hari yang dipilih, dimulai pada pukul --maintenance-window-start, dan selama durasi yang ditentukan.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE).

Perintah berikut membuat instance dengan masa pemeliharaan enam jam antara pukul 12.00 hingga 18.00 (UTC) pada hari Sabtu dan Minggu setiap minggu.

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'

Memperbarui masa pemeliharaan untuk instance

Konsol

Untuk memperbarui masa pemeliharaan di instance yang ada di konsol Google Cloud , ikuti langkah-langkah berikut:

Buka halaman Instances Cloud Data Fusion.

Buka Instance
Klik nama instance untuk melihat detail instance.
Di halaman Instance details, buka kolom Maintenance window lalu klik Edit.
Kolom periode pemeliharaan dibuka dalam mode edit. Perbarui nilai sesuai kebutuhan:
1. Centang kotak Aktifkan jendela pemeliharaan.
2. Di kolom Start time, masukkan waktu dalam format yang didukung.
3. Di daftar TimeZone, pilih zona waktu.
4. Dalam daftar Hari dan Durasi, pilih hari dalam seminggu dan durasi jendela. Untuk mengetahui informasi selengkapnya tentang setelan ini, lihat Tentang operasi pemeliharaan.
Klik Simpan.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE).

REST API

Untuk instance yang ada, perbarui periode pemeliharaan menggunakan permintaan API instances.patch. Tindakan ini akan menggantikan konfigurasi masa pemeliharaan yang ada, jika ada. Jika tidak, konfigurasi baru akan ditetapkan, seperti yang disebutkan dalam isi permintaan.

Buat permintaan API sebagai berikut:

Dalam parameter updateMask, tentukan mask maintenance_policy.
Dalam isi permintaan, tentukan masa pemeliharaan dalam konfigurasi kebijakan pemeliharaan:

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

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE).

Contoh berikut memperbarui konfigurasi kebijakan pemeliharaan instance dengan masa pemeliharaan empat jam antara pukul 11.00 hingga 15.00 (UTC) pada hari Jumat, Sabtu, dan Minggu setiap minggu.

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

Anda dapat memperbarui periode pemeliharaan instance menggunakan perintah gcloud beta data-fusion instances update.

Parameter berikut harus ditentukan untuk periode pemeliharaan:

--maintenance-window-start menetapkan waktu mulai jendela.
--maintenance-window-end menetapkan waktu berakhir jendela.
--maintenance-window-recurrence menetapkan RRULE untuk pengulangan masa pemeliharaan.

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

Ganti kode berikut:

INSTANCE_NAME: nama instance.
PROJECT_NAME: nama project.
LOCATION: nama region instance.
START_TIME: waktu mulai periode dalam format input tanggal/waktu. Hanya waktu yang ditentukan yang digunakan, tanggal yang ditentukan akan diabaikan.
END_TIME: waktu berakhir jendela dalam format input tanggal/waktu. Hanya waktu yang ditentukan yang digunakan, tanggal yang ditentukan akan diabaikan. Tanggal dan waktu yang ditentukan harus setelah waktu mulai.
MAINTENANCE_RECURRENCE: RRULE untuk pengulangan masa pemeliharaan. Cloud Data Fusion hanya mendukung format berikut:
- FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA atau BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Setelan ini menentukan pengulangan jendela setiap minggu pada hari yang dipilih, dimulai pada pukul --maintenance-window-start, dan selama durasi yang ditentukan.

Perintah berikut mengupdate instance example-instance dengan masa pemeliharaan enam jam antara pukul 12.00 hingga 18.00 (UTC) pada hari Sabtu dan Minggu setiap minggu.

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'

Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE)

Saat Anda mengonfigurasi waktu mulai dan berakhir untuk masa pemeliharaan, komponen tanggal stempel waktu yang diberikan akan diabaikan. Hanya waktu dalam sehari dan durasi antara waktu mulai dan berakhir yang dipertimbangkan. Waktu disimpan dalam UTC, tetapi Anda dapat menggunakan UTC atau offset zona waktu saat menjadwalkan periode pemeliharaan menggunakan REST API atau gcloud CLI.

Saat mengonfigurasi pengulangan, perlu diingat bahwa RRULE mengikuti hari UTC, jadi sesuaikan jika zona waktu Anda berbeda. Misalnya, jika zona waktu Anda adalah PDT (UTC-7) dan Anda ingin masa pemeliharaan dimulai pukul 21.00 hari Rabu di zona waktu Anda (yang sesuai dengan pukul 04.00 UTC hari Kamis), tentukan TH bukan WE dalam opsi BYDAY RRULE.

Menghapus masa pemeliharaan untuk instance

Konsol

Untuk menghapus masa pemeliharaan di instance yang ada di konsol Google Cloud , ikuti langkah-langkah berikut:

Buka halaman Instances Cloud Data Fusion.

Buka Instance
Klik nama instance untuk melihat detail instance.
Di halaman Instance details, buka kolom Maintenance window lalu klik Edit.
Untuk menghapus masa pemeliharaan dari instance, hapus centang pada kotak Aktifkan masa pemeliharaan.
Klik Simpan.

REST API

Untuk menghapus masa pemeliharaan dari instance, teruskan objek kebijakan pemeliharaan kosong di isi permintaan.

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

{
    "maintenancePolicy": {}
}

gcloud

Untuk menghapus masa pemeliharaan dari instance, gunakan perintah gcloud beta data-fusion instances update dengan flag --clear-maintenance-window.

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

Ganti kode berikut:

INSTANCE_NAME: nama instance.
PROJECT_NAME: nama project.
LOCATION: nama region instance.

Langkah berikutnya

Lihat dokumentasi API instance.

Mengonfigurasi masa pemeliharaan Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Tentang masa pemeliharaan

Tentang operasi pemeliharaan

Menentukan masa pemeliharaan saat membuat instance

Konsol

REST API

gcloud

Memperbarui masa pemeliharaan untuk instance

Konsol

REST API

gcloud

Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE)

Menghapus masa pemeliharaan untuk instance

Konsol

REST API

gcloud

Langkah berikutnya

Mengonfigurasi masa pemeliharaan