ApsaraDB RDS:Gunakan ekstensi pg_cron

Waktu yang ditentukan dalam jadwal tugas terjadwal mengikuti UTC secara default. Konversikan waktu tersebut berdasarkan parameter TIMEZONE database sesuai kebutuhan. Jika tugas terjadwal tidak dapat dipicu, jalankan perintah berikut untuk mengonfigurasi tugas yang dieksekusi setiap menit guna memverifikasi apakah ekstensi berfungsi dengan baik.

SELECT cron.schedule('* * * * *', 'SELECT 1;');

Tugas terjadwal yang dikonfigurasi disimpan di database default bernama postgres. Anda dapat mengkueri tugas-tugas terjadwal ini dari database lain.

Ekstensi pg_cron versi asli didukung untuk instans RDS yang menjalankan PostgreSQL 10, PostgreSQL 11, atau PostgreSQL 12 serta menggunakan versi mesin minor sebelum 20201130. Namun, kami menyarankan agar Anda memperbarui versi mesin minor instans RDS ke versi terbaru untuk menggunakan versi pg_cron yang telah ditingkatkan. Untuk informasi selengkapnya, lihat Perbarui versi mesin minor. Jika Anda telah menggunakan pg_cron sebelum pembaruan versi mesin minor, buat ulang pg_cron untuk memanfaatkan fitur-fitur barunya. Perhatikan bahwa tugas terjadwal yang telah Anda konfigurasi menggunakan pg_cron akan hilang setelah ekstensi dibuat ulang.

Buat ekstensi

• Gunakan fitur manajemen ekstensi untuk menginstal ekstensi

  1. Masuk ke Konsol ApsaraDB RDS dan buka halaman Instances. Di bilah navigasi atas, pilih wilayah tempat instans RDS Anda berada. Lalu, temukan instans RDS tersebut dan klik ID instans.

  2. Di panel navigasi kiri, klik Plug-ins.

  3. Pada halaman yang muncul, klik tab Extension Management, lalu klik tab Uninstalled Extensions. Kemudian, cari ekstensi pg_cron, pilih database tempat Anda ingin menginstal ekstensi tersebut, lalu klik Install di kolom Actions.

  4. Pada kotak dialog yang muncul, pilih Akun istimewa lalu klik OK untuk menginstal ekstensi pada database yang diperlukan.

     Saat proses instalasi ekstensi berlangsung, status instans RDS berubah menjadi Maintaining Instance. Jika status instans RDS berubah menjadi Running, berarti ekstensi telah berhasil diinstal.

• Eksekusi pernyataan SQL yang diperlukan untuk menginstal ekstensi

  1. Ubah parameter yang diperlukan untuk menambahkan pg_cron ke Running Value dari parameter shared_preload_libraries di Konsol ApsaraDB RDS. Misalnya, Anda dapat mengubah Running Value parameter ini menjadi 'pg_stat_statements,auto_explain,pg_cron'. Untuk informasi selengkapnya, lihat Atur parameter instans.

  2. Gunakan akun istimewa untuk menghubungkan ke database yang diperlukan dan eksekusi pernyataan berikut:

     CREATE EXTENSION pg_cron;

     Catatan

     Anda dapat mengeksekusi pernyataan SELECT * FROM pg_extension untuk melihat ekstensi yang telah diinstal.

Konfigurasi tugas terjadwal

SELECT cron.schedule('<Nama Tugas Terjadwal>','<Schedule>', '<Action>');

Contoh:

-- Hapus data kedaluwarsa setiap Sabtu pukul 03.30 pagi (GMT). 
SELECT cron.schedule('30 3 * * 6', $$DELETE FROM events WHERE event_time < now() - interval '1 week'$$);

----------

-- Bersihkan disk setiap hari pukul 10.00 pagi (GMT).
SELECT cron.schedule('0 10 * * *', 'VACUUM');

Konfigurasi tugas terjadwal di database tertentu

SELECT cron.schedule_in_database('<Nama Tugas Terjadwal>', '<Schedule>', '<Action>', '<Database Tertentu>');

Jika instans RDS untuk PostgreSQL Anda menjalankan versi mesin minor sebelum 20230530, gunakan perintah berikut untuk menjalankan tugas terjadwal. Jika Anda tidak menentukan database, tugas akan dijalankan di database yang ditentukan oleh parameter cron.database_name. Secara default, database tersebut adalah postgres.

SELECT cron.schedule('<Schedule>', '<Action>', '<Database Tertentu>')

Contoh:

SELECT cron.schedule_in_database('weekly-vacuum', '0 4 * * 0', 'VACUUM', 'some_other_database');

Lihat tugas terjadwal yang telah dikonfigurasi

SELECT * FROM cron.job;