Enum là một kiểu dữ liệu có các giá trị lấy từ một danh sách cố định do bạn khai báo: CREATE TYPE name AS ENUM ('a', 'b', 'c'). Một cột thuộc kiểu đó chỉ chấp nhận những nhãn này và sắp xếp chúng theo thứ tự khai báo, không theo bảng chữ cái.
Các hàng được trả về theo thứ tự new, paid, shipped, delivered. Chèn một nhãn không có trong danh sách, như 'lost', sẽ báo lỗi invalid input value for enum order_status: "lost".
So sánh và lọc theo vị trí
Vì các giá trị có thứ tự, <, > và BETWEEN so sánh vị trí trong danh sách. "Đã thanh toán hoặc bất kỳ trạng thái nào sau đó" trở thành một điều kiện duy nhất:
Đơn hàng 1, 3 và 4 khớp. min(status) và max(status) cũng theo thứ tự khai báo.
Liệt kê các giá trị của một enum
enum_range(NULL::type) trả về mọi nhãn dưới dạng một mảng, và unnest biến nó thành các hàng:
enum_first(NULL::mood) và enum_last(NULL::mood) trả về nhãn đầu tiên và cuối cùng. Trong psql, \dT+ mood hiển thị kiểu cùng các giá trị của nó.
Thêm hoặc đổi tên một giá trị
ALTER TYPE ... ADD VALUE thêm một nhãn vào cuối, hoặc đặt nó ở vị trí nhất định với BEFORE hay AFTER. RENAME VALUE đổi một nhãn, và mọi hàng dùng nhãn đó đổi theo, vì các hàng lưu tham chiếu tới nhãn chứ không lưu văn bản của nó.
Danh sách bây giờ là pending, paid, packed, shipped, delivered. IF NOT EXISTS khiến việc thêm một nhãn đã có trở thành không làm gì cả.
PostgreSQL không thể xóa một giá trị hay sắp xếp lại các giá trị đã có. Thay vào đó, hãy tạo một kiểu mới, chuyển cột sang kiểu đó, rồi xóa kiểu cũ:
CREATE TYPE order_status_new AS ENUM ('pending', 'paid', 'shipped');
UPDATE orders SET status = 'shipped' WHERE status = 'delivered';
ALTER TABLE orders
ALTER COLUMN status DROP DEFAULT,
ALTER COLUMN status TYPE order_status_new USING status::text::order_status_new;
DROP TYPE order_status;
ALTER TYPE order_status_new RENAME TO order_status;
Giá trị mặc định được bỏ trước vì nó có kiểu là enum cũ. Hãy đặt lại nó sau đó.
Enum so với ràng buộc CHECK
Một cột text với ràng buộc CHECK cho cùng mức bảo vệ, và danh sách của nó có thể thay đổi bằng một lệnh ALTER TABLE thông thường:
Ở đây thứ tự sắp xếp theo bảng chữ cái: new, rồi paid.
| Enum | text + CHECK | |
|---|---|---|
| Thứ tự sắp xếp | Thứ tự khai báo | Bảng chữ cái |
| Dung lượng | 4 byte | Độ dài của văn bản |
| Xóa một giá trị | Kiểu mới và chuyển đổi cột | Thay ràng buộc |
| Dùng lại ở nhiều bảng | Một kiểu | Lặp lại ràng buộc |
Chọn enum cho một danh sách ngắn, ổn định và thứ tự có ý nghĩa, như trạng thái hoặc kích cỡ. Chọn CHECK, hoặc một bảng tra cứu với khóa ngoại, khi danh sách hay thay đổi hoặc có giá trị bị xóa. Chương enum trong tài liệu chính thức nói về các chi tiết còn lại.
Câu hỏi thường gặp
Làm sao xóa một giá trị khỏi enum trong PostgreSQL?
Không có ALTER TYPE ... DROP VALUE. Hãy tạo một enum mới không có giá trị đó, chuyển cột bằng ALTER TABLE ... ALTER COLUMN ... TYPE new_type USING col::text::new_type sau khi đã cập nhật các hàng dùng giá trị đó, rồi xóa kiểu cũ.
Một giá trị enum chiếm bao nhiêu dung lượng?
4 byte cho mỗi giá trị trên đĩa, dù nhãn dài bao nhiêu. Nhãn phân biệt hoa thường và dài tối đa 63 byte.
Có dùng ALTER TYPE ADD VALUE bên trong transaction được không?
Được, từ PostgreSQL 12. Giá trị mới chưa dùng được cho tới khi transaction đó đã commit.
Làm sao so sánh một cột enum với văn bản?
Một literal chuỗi được tự động chuyển sang enum, nên WHERE status = 'paid' chạy được. Một cột hay tham số kiểu text thì cần ép kiểu, status = $1::order_status, hoặc so sánh như văn bản với status::text = $1.