DROP TABLE dan ALTER TABLE di SQLite: Penjelasan Perubahan Skema

Skema Bisa Berubah, dan SQLite Mengizinkannya (Sebagian Besar)

Begitu sebuah tabel ada, cepat atau lambat kamu akan ingin mengganti namanya, menambah kolom, menghapus kolom, atau menyusun ulang seluruhnya. SQLite mendukung kasus-kasus umum secara langsung dengan DROP TABLE dan ALTER TABLE, dan memberimu solusi yang terdokumentasi untuk sisanya.

Kekurangannya: ALTER TABLE di SQLite jauh lebih terbatas dibanding Postgres atau MySQL. Mengetahui apa yang bisa dan tidak bisa dilakukannya, serta pola membangun ulang untuk yang tidak bisa, adalah sebagian besar keterampilan di sini.

DROP TABLE Menghapus Tabel dan Semua yang Melekat Padanya

DROP TABLE menghapus tabel, baris-barisnya, index-nya, dan trigger apa pun yang didefinisikan padanya. Tidak ada undo:

CREATE TABLE scratch (
    id INTEGER PRIMARY KEY,
    note TEXT
);

INSERT INTO scratch (note) VALUES ('temporary'), ('also temporary');

DROP TABLE scratch;

SELECT name FROM sqlite_master WHERE type = 'table';

Tabelnya sudah hilang. Menjalankan query ke tabel itu sekarang akan memunculkan no such table: scratch.

Kalau kamu tidak yakin tabelnya ada, yang sering terjadi di skrip setup, pakai IF EXISTS agar pernyataannya diam-diam tidak melakukan apa-apa saat tabelnya tidak ada:

CREATE TABLE scratch (id INTEGER PRIMARY KEY);

DROP TABLE IF EXISTS scratch;
DROP TABLE IF EXISTS scratch;
SELECT 'both drops succeeded' AS result;

Tanpa IF EXISTS, penghapusan kedua akan error. Dengan itu, keduanya berjalan lancar.

Foreign Key Bisa Menghalangi DROP

Kalau penegakan foreign key aktif (PRAGMA foreign_keys = ON;) dan ada tabel lain yang merujuk tabel yang akan kamu hapus, penghapusannya gagal:

sqlite> PRAGMA foreign_keys = ON;
sqlite> DROP TABLE users;
Runtime error: FOREIGN KEY constraint failed

Kamu punya beberapa pilihan: hapus tabel yang merujuk lebih dulu, hapus baris yang merujuk, atau definisikan foreign key dengan ON DELETE CASCADE saat membuatnya. SQLite tidak akan diam-diam merusak integritas referensial untukmu.

ALTER TABLE: Empat Hal yang Bisa Dilakukannya

ALTER TABLE di SQLite mendukung tepat empat operasi:

CREATE TABLE posts (
    id INTEGER PRIMARY KEY,
    title TEXT NOT NULL,
    body TEXT
);

-- 1. Rename the table
ALTER TABLE posts RENAME TO articles;

-- 2. Rename a column
ALTER TABLE articles RENAME COLUMN body TO content;

-- 3. Add a column
ALTER TABLE articles ADD COLUMN published_at TEXT;

-- 4. Drop a column (SQLite 3.35+)
ALTER TABLE articles DROP COLUMN published_at;

SELECT sql FROM sqlite_master WHERE name = 'articles';

Masing-masing berjalan sebagai satu pernyataan. Dua yang pertama pada dasarnya gratis, karena hanya memperbarui skema. ADD COLUMN juga cepat: SQLite tidak menulis ulang tabel, ia hanya mencatat definisi kolom yang baru. DROP COLUMN lebih berat, karena SQLite harus menulis ulang setiap baris untuk benar-benar menghapus data kolom itu.

ADD COLUMN dengan Nilai Default

Kolom baru pada tabel yang sudah ada dimulai dengan nilai NULL di setiap baris, kecuali kamu memberinya nilai default:

CREATE TABLE users (
    id INTEGER PRIMARY KEY,
    email TEXT NOT NULL
);

INSERT INTO users (email) VALUES ('ada@example.com'), ('boris@example.com');

ALTER TABLE users ADD COLUMN status TEXT NOT NULL DEFAULT 'active';

SELECT * FROM users;

Kedua baris yang sudah ada terisi 'active'. Nilai default-nya harus berupa konstanta: SQLite tidak mengizinkanmu memakai CURRENT_TIMESTAMP atau ekspresi non-konstan lain sebagai default di ADD COLUMN, karena ia butuh nilai yang bisa diterapkan ke setiap baris yang ada tanpa dievaluasi per baris.

Kalau kamu butuh NOT NULL tanpa nilai default, kamu harus menambahkan kolomnya sebagai nullable, mengisinya dengan UPDATE, lalu membangun ulang tabel untuk menambahkan constraint-nya. Itu membawa kita ke batasannya.

Apa yang Tidak Bisa Dilakukan ALTER TABLE

Hal-hal yang bisa di Postgres atau MySQL tapi tidak di SQLite:

• Mengubah tipe kolom (ALTER COLUMN ... TYPE ...).
• Mengubah nilai default kolom di tempat.
• Menambah atau menghapus NOT NULL, CHECK, UNIQUE, atau PRIMARY KEY pada kolom yang sudah ada.
• Menambahkan foreign key ke kolom yang sudah ada.
• Mengubah urutan kolom.

Mencoba salah satunya akan memberimu syntax error. SQLite sama sekali tidak punya klausa ALTER COLUMN. Jawaban resminya sama untuk semuanya: bangun ulang tabelnya.

Pola Membangun Ulang Tabel

Kalau ALTER TABLE tidak bisa melakukan yang kamu butuhkan, buat tabel baru dengan skema yang kamu inginkan, salin datanya, hapus tabel lama, lalu ganti nama tabel baru ke nama lama. Bungkus dalam transaksi agar semuanya berhasil atau tidak sama sekali:

CREATE TABLE users (
    id INTEGER PRIMARY KEY,
    email TEXT,
    age TEXT
);

INSERT INTO users (email, age) VALUES ('ada@example.com', '36'), ('boris@example.com', '41');

BEGIN;

CREATE TABLE users_new (
    id INTEGER PRIMARY KEY,
    email TEXT NOT NULL,
    age INTEGER CHECK (age > 0)
);

INSERT INTO users_new (id, email, age)
SELECT id, email, CAST(age AS INTEGER) FROM users;

DROP TABLE users;
ALTER TABLE users_new RENAME TO users;

COMMIT;

SELECT * FROM users;

Sekarang users.age adalah integer dengan check constraint, dan email bersifat NOT NULL. Datanya ikut terbawa.

Beberapa hal yang perlu diingat saat kamu melakukannya sungguhan:

• Matikan foreign key selama prosesnya. Kalau ada tabel lain yang merujuk tabelmu, jalankan PRAGMA foreign_keys = OFF; sebelum transaksi dan PRAGMA foreign_keys = ON; sesudahnya. Kalau tidak, DROP TABLE akan gagal. Pragma ini tidak bisa diubah di dalam transaksi, jadi atur di luarnya.
• Buat ulang index dan trigger. Menghapus tabel lama juga menghapus index dan trigger-nya. Tambahkan kembali pada tabel baru setelah penggantian nama.
• Periksa view. View yang merujuk tabel itu masih menunjuk ke nama lama di SQL yang tersimpan. Bangun ulang view yang bergantung pada kolom yang berubah.

Pola membangun ulang memang panjang, tapi bisa diandalkan. Inilah yang dilakukan tool migrasi seperti Alembic dan Rails di balik layar saat menargetkan SQLite.

Menghapus Beberapa Tabel

Tidak ada satu pernyataan untuk menghapus beberapa tabel sekaligus: kamu menjalankan DROP TABLE untuk masing-masing. Taruh di dalam transaksi kalau kamu ingin semuanya dikelompokkan:

CREATE TABLE a (id INTEGER);
CREATE TABLE b (id INTEGER);
CREATE TABLE c (id INTEGER);

BEGIN;
DROP TABLE a;
DROP TABLE b;
DROP TABLE c;
COMMIT;

SELECT name FROM sqlite_master WHERE type = 'table';

Membungkusnya dalam transaksi berarti ketiga penghapusan berhasil semua atau tidak ada yang berhasil. Ini berguna saat membongkar tabel-tabel terkait yang mungkin gagal di tengah jalan karena foreign key.

Yang Perlu Kamu Ingat

• DROP TABLE menghapus tabel beserta index dan trigger-nya. Pakai IF EXISTS untuk skrip yang aman dijalankan berulang.
• ALTER TABLE hanya melakukan empat hal: ganti nama tabel, ganti nama kolom, tambah kolom, hapus kolom.
• Untuk hal lainnya, seperti perubahan tipe, constraint baru, atau foreign key pada kolom yang sudah ada, bangun ulang tabel di dalam transaksi.
• Perhatikan foreign key, index, trigger, dan view saat membangun ulang. Semuanya tidak otomatis ikut bersama data.

Berikutnya: Memasukkan Data

Kamu sudah menghabiskan satu bab untuk tabel dan constraint yang membentuknya. Saatnya mengisinya: bab berikutnya dimulai dengan INSERT, termasuk bentuk banyak baris, nilai default, dan cara SQLite menangani insert yang bentrok dengan constraint-mu.