penyaluran_app/assets/sql

Fungsi SQL untuk Supabase

File-file SQL di direktori ini berisi fungsi-fungsi yang perlu dijalankan pada database Supabase untuk mendukung fitur-fitur aplikasi.

Cara Menginstal Fungsi SQL

1. Login ke dashboard Supabase untuk project Anda
2. Buka bagian "SQL Editor"
3. Klik "New Query"
4. Copy dan paste isi file SQL yang ingin diinstal (misalnya batch_update_jadwal_status.sql)
5. Jalankan query dengan mengklik tombol "Run"

Daftar Fungsi SQL

batch_update_jadwal_status

Fungsi ini digunakan untuk mengupdate status banyak jadwal sekaligus, yang lebih efisien daripada melakukan update satu per satu.

Sintaks Penggunaan:

SELECT batch_update_jadwal_status(
  ARRAY[
    '{"id": "jadwal-id-1", "status": "AKTIF"}',
    '{"id": "jadwal-id-2", "status": "BATALTERLAKSANA"}'
  ]::jsonb[],
  '2023-01-01T00:00:00Z'
);

Parameter:

• jadwal_updates: Array dari objek JSON dengan properti id dan status
• updated_timestamp (opsional): Waktu update dalam format ISO 8601

Status yang Valid: Berikut adalah nilai-nilai yang valid untuk kolom status (enum StatusPenyaluranBantuan):

• DIJADWALKAN - Jadwal telah dibuat tapi belum aktif
• AKTIF - Jadwal sedang berlangsung
• TERLAKSANA - Jadwal telah berhasil dilaksanakan
• BATALTERLAKSANA - Jadwal tidak terlaksana atau dibatalkan

Contoh Response:

{
  "success": true,
  "updated_count": 2,
  "success_ids": ["jadwal-id-1", "jadwal-id-2"],
  "timestamp": "2023-01-01T00:00:00Z",
  "errors": {
    "count": 0,
    "ids": [],
    "messages": []
  }
}

Cara Menguji Fungsi

Setelah fungsi diinstal, Anda dapat mengujinya dengan menjalankan query berikut pada SQL Editor:

-- Pastikan status yang digunakan sesuai dengan enum StatusPenyaluranBantuan
SELECT batch_update_jadwal_status(
  ARRAY[
    '{"id": "534cb328-1fd9-4945-8642-c99b8e1acb2d", "status": "DIJADWALKAN"}'
  ]::jsonb[]
);

Ganti 534cb328-1fd9-4945-8642-c99b8e1acb2d dengan ID jadwal yang valid dari tabel penyaluran_bantuan Anda.

Membuat Enum di Database (Jika Belum Ada)

Jika enum StatusPenyaluranBantuan belum ada di database, Anda dapat membuatnya dengan query berikut:

CREATE TYPE "StatusPenyaluranBantuan" AS ENUM (
  'DIJADWALKAN',
  'AKTIF',
  'TERLAKSANA',
  'BATALTERLAKSANA'
);

Troubleshooting

Jika muncul error:

• Periksa apakah ID jadwal valid dan ada di tabel penyaluran_bantuan
• Pastikan format UUID benar (harus berupa UUID valid, bukan string biasa)
• Periksa apakah nilai status valid dan sesuai dengan tipe enum StatusPenyaluranBantuan
• Pastikan tabel penyaluran_bantuan memiliki kolom status dengan tipe data enum StatusPenyaluranBantuan dan kolom updated_at

Error umum:

1. column "status" is of type "StatusPenyaluranBantuan" but expression is of type text - Ini terjadi karena kolom status memiliki tipe enum, bukan teks biasa. Fungsi sudah menyertakan cast ke enum.
2. operator does not exist: uuid = text - Ini terjadi jika ID tidak dikonversi ke UUID. Fungsi sudah menyertakan cast ke UUID.

Menambahkan Nilai Baru ke Enum

Jika perlu menambahkan nilai enum baru di masa depan, gunakan SQL berikut:

ALTER TYPE "StatusPenyaluranBantuan" ADD VALUE 'NILAI_BARU';