Menu

Kiểu enum trong PostgreSQL: CREATE TYPE AS ENUM

Kiểu enum là một danh sách cố định, có thứ tự, gồm các giá trị được phép, tạo bằng CREATE TYPE ... AS ENUM. Gồm thêm và đổi tên giá trị, liệt kê, sắp xếp, và khi nào ràng buộc CHECK là lựa chọn tốt hơn.

Trang này có trình soạn thảo chạy trực tiếp. Sửa, chạy và xem đầu ra ngay lập tức.

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.

Enumtext + CHECK
Thứ tự sắp xếpThứ tự khai báoBảng chữ cái
Dung lượng4 byteĐộ dài của văn bản
Xóa một giá trịKiểu mới và chuyển đổi cộtThay ràng buộc
Dùng lại ở nhiều bảngMột kiểuLặ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.

Hình minh họa các ngôn ngữ lập trình của Coddy

Học lập trình cùng Coddy

Bắt đầu