Chuyển đến nội dung
MINH VO Ghi chép từ công việc
của một kỹ sư tại Việt Nam
Cơ bản12 phút đọc

Chọn ràng buộc duy nhất cho định danh email

Tính khóa email theo tenant, kiểm tra xung đột đồng thời và so sánh giữ khóa đã ngừng dùng với index chỉ xét hàng hoạt động cùng lỗi khôi phục.

Các thành phần máy chủ màu ô liu và than chì nối nhau trên nền be ấm

Hai hàng tài khoản có thể có mã định danh khác nhau nhưng vẫn cùng nhận một địa chỉ đăng nhập. Khóa chính không ngăn xung đột đó. Ràng buộc duy nhất có thể ngăn, với điều kiện giá trị được ràng buộc thể hiện đúng chính sách định danh mà ứng dụng mong muốn.

Với kỹ sư backend đã biết insert và các loại khóa cơ bản, quyết định khó xuất hiện trước SQL: có phân biệt chữ hoa không, định danh có phạm vi toàn hệ thống hay theo tenant, và ngừng dùng tài khoản có giải phóng địa chỉ không? Ví dụ PostgreSQL này làm rõ những lựa chọn ấy và kiểm tra hai lần insert đồng thời. Nó giữ cách viết đã gửi, đồng thời tính một khóa định danh riêng, để các bên ghi không tự cung cấp giá trị chuẩn hóa mâu thuẫn.

Viết rõ quy tắc coi hai giá trị là giống nhau

Chính sách minh họa coi toàn bộ địa chỉ đã gửi là không phân biệt hoa thường trong một tenant. Nó chỉ hỗ trợ chuỗi ASCII in được, không rỗng và không chứa khoảng trắng. Nó giữ dấu chấm cùng dấu cộng. Tài khoản đã ngừng dùng vẫn giữ khóa, trừ khi ta chủ động chuyển sang chính sách thay thế ở phần sau.

Đó là quy tắc của ứng dụng, không phải sự tương đương hộp thư áp dụng khắp nơi. RFC 5321 yêu cầu giữ cách viết hoa thường của phần trước dấu @ trong SMTP và lưu ý một số máy chủ phân biệt smith với Smith, còn miền của hộp thư không phân biệt hoa thường. Ứng dụng không phân biệt hoa thường trên toàn địa chỉ có thể gộp những địa chỉ mà hệ thống thư xem là khác nhau. Hãy quyết định sự đánh đổi này có phù hợp với các địa chỉ được hỗ trợ không trước khi áp dụng.

Hành vi nhà cung cấp là ranh giới khác. Hướng dẫn Gmail của Google nói dấu chấm không phân biệt các địa chỉ Gmail cá nhân, nhưng nêu ngoại lệ rõ ràng cho địa chỉ dùng qua tổ chức có miền riêng. Điều đó không phải cơ sở để xóa dấu chấm khỏi mọi địa chỉ sản phẩm nhận được. Ví dụ này cũng giữ nguyên phần gắn thêm bằng dấu cộng; nó không suy đoán các chuỗi khác nhau nào cùng đến một hộp thư.

Từ chối khoảng trắng khác với cắt bỏ khoảng trắng. Mô hình kiểm thử từ chối khoảng trắng đầu, cuối và giữa chuỗi, thay vì âm thầm sửa giá trị đã gửi. Biểu mẫu có thể chọn cắt trước khi gửi, nhưng hợp đồng backend vẫn phải đủ rõ để các client khác tuân theo.

Tính khóa được lưu thay vì tin mọi bên gọi

Chạy schema này trong cơ sở dữ liệu PostgreSQL trống:

CREATE TABLE tenants (id bigint PRIMARY KEY);
CREATE TABLE identities (
  id bigint PRIMARY KEY,
  tenant_id bigint NOT NULL REFERENCES tenants(id),
  email_original text COLLATE "C" NOT NULL,
  email_key text COLLATE "C" GENERATED ALWAYS AS (lower(email_original)) STORED NOT NULL,
  deleted_at timestamptz,
  CONSTRAINT email_printable_ascii CHECK (email_original ~ '^[!-~]+$'),
  CONSTRAINT identities_tenant_email_key UNIQUE (tenant_id, email_key)
);

Cột sinh tự động tính khóa từ cách viết gốc. Một check chỉ yêu cầu khóa được truyền riêng phải là chữ thường sẽ yếu hơn: bên gọi có thể gửi địa chỉ này cùng khóa chữ thường thuộc địa chỉ khác. Ở đây cơ sở dữ liệu tính lại khóa khi insert và update, và bên gọi không thể ghi đè bằng giá trị khác. Tài liệu cột sinh tự động của PostgreSQL giải thích hành vi đó.

Cả hai cột văn bản dùng collation C tường minh. Tài liệu collation mô tả hành vi ASCII truyền thống của nó cùng vai trò của collation trong chuyển hoa thường và so khớp mẫu. Kết hợp với check ASCII in được, lựa chọn này tạo miền chuẩn hóa hẹp, dễ kiểm tra cho ví dụ. Đây không phải thiết kế hoàn chỉnh cho địa chỉ email quốc tế.

Biểu thức chính quy cũng không phải bộ phân tích địa chỉ hộp thư. Nó từ chối chuỗi rỗng, khoảng trắng, ký tự điều khiển và ký tự ngoài ASCII, nhưng chấp nhận not-an-address. Bộ kiểm tra cục bộ xác nhận có chủ đích kết quả đó. Kiểm tra cú pháp, giới hạn độ dài phù hợp với ứng dụng, khả năng nhận thư và xác minh hộp thư thuộc những ranh giới bổ sung. Đừng xem việc hàng này tồn tại là bằng chứng người nào đó sở hữu hộp thư.

Quy tắc ràng buộc duy nhất áp dụng cho tổ hợp tenant và khóa. Cả hai không null, tránh hành vi mặc định cho phép các null được xem là khác nhau khi xét tính duy nhất. Khóa ngoại tenant xác nhận tenant tồn tại; nó không cấp quyền cho người gọi tạo định danh trong tenant ấy.

Quan sát cách viết được lưu và hành vi tra cứu

Nạp hai cách viết thuộc cùng nhóm địa chỉ vào hai tenant:

INSERT INTO tenants VALUES (1), (2);
INSERT INTO identities (id, tenant_id, email_original) VALUES
  (200, 1, 'Alice@Example.com'),
  (201, 2, 'ALICE@example.com');
SELECT id, tenant_id, email_original, email_key
FROM identities ORDER BY id;
SELECT id FROM identities
WHERE tenant_id = 1 AND email_key = lower('ALICE@EXAMPLE.COM' COLLATE "C");

Hai khóa đều là alice@example.com, nhưng các hàng được chấp nhận vì tenant khác nhau. Cách viết gốc vẫn khác nhau. Truy vấn trả về định danh 200 vì có điều kiện tenant một và áp dụng cùng phép chuyển chữ thường cho giá trị tìm kiếm.

Nếu quá trình đăng nhập bắt đầu khi chưa biết tenant, schema này chưa trả lời phải chọn tài khoản nào. Giải quyết nhập nhằng đó trong luồng đăng nhập của sản phẩm hoặc chọn tính duy nhất toàn hệ thống. Bỏ điều kiện tenant khỏi truy vấn không phải phép đơn giản hóa vô hại đối với mô hình định danh theo tenant.

Bộ kiểm tra PostgreSQL 17.11 từ chối một Alice viết hoa thường khác trong tenant một với 23505. Nó từ chối giá trị khóa sinh tự động do bên gọi cung cấp với 428C9, đầu vào null với 23502, tenant không tồn tại với 23503, và vi phạm chính sách ký tự đã chọn với 23514. Đổi địa chỉ gốc làm khóa được lưu tính lại; đổi sang khóa đã thuộc hàng khác thất bại và giữ nguyên cách viết cùng khóa trước đó.

Mô hình còn thêm ba khóa riêng cho cách viết có dấu chấm, không dấu chấm và có phần gắn thêm bằng dấu cộng. Chúng khác nhau đúng như chính sách ứng dụng. Ràng buộc duy nhất không phát hiện bí danh của nhà cung cấp; ngay cả khi phát hiện được bí danh, riêng điều đó cũng chưa xác lập tài khoản cục bộ nào được kế thừa lịch sử hoặc quyền hạn.

Để lần ghi cuối giải quyết xung đột đồng thời

Select sơ bộ chỉ mang tính tham khảo. Hai yêu cầu đều có thể không tìm thấy định danh cho tenant và khóa trước khi bên nào insert. Bảo đảm hữu ích đến từ ràng buộc duy nhất ở ranh giới ghi, không phải từ việc căn thời điểm tra cứu cho khéo.

Thí nghiệm hai kết nối chủ động giữ lần insert đầu chưa commit. Lần insert thứ hai dùng cách viết hoa thường khác nhưng tạo cùng khóa. Kết nối thứ hai thực sự chờ một khóa của cơ sở dữ liệu. Khi transaction đầu commit, insert đang chờ thất bại với 23505, để lại đúng một định danh.

Lần chạy thứ hai đổi kết quả của transaction đầu thành rollback. Insert đang chờ sau đó thành công, và mã của nó là định danh duy nhất được lưu cho khóa ấy. Khác biệt này quan trọng: “yêu cầu thứ hai luôn thua” không phải quy tắc. PostgreSQL chờ kết quả của transaction xung đột rồi kiểm tra lại, như ghi chú triển khai kiểm tra tính duy nhất mô tả.

Insert cạnh tranh chờ cùng tenant và khóa email được sinh; lần insert đầu commit gây lỗi duy nhất, còn rollback cho phép bên đang chờ ghi thành côngMở ảnh kích thước đầy đủ ↗

API nên xử lý xung đột cuối như kết quả có thể dự kiến, thay vì mù quáng tạo tài khoản khác hoặc thử lại cùng insert vô hạn. Phản hồi công khai có tiết lộ địa chỉ đã được đăng ký hay không là quyết định giao diện riêng. Lỗi cơ sở dữ liệu không cần lộ tên ràng buộc hoặc thông tin tài khoản đang xung đột.

Những ca này chạy qua kết nối PostgreSQL, không qua dịch vụ đăng ký HTTP hay email xác minh. Insert thành công giữ một khóa lưu trữ. Nó không xác lập quyền sở hữu hộp thư, hoàn tất xác thực hoặc khiến toàn bộ quy trình đăng ký có tính nguyên tử cùng nhà cung cấp thư bên ngoài.

Quyết định tài khoản đã ngừng dùng có giữ địa chỉ không

Với ràng buộc duy nhất đầy đủ ban đầu, ngừng dùng định danh không giải phóng khóa:

UPDATE identities SET deleted_at = '2026-09-21T00:00:00Z' WHERE id = 200;
SELECT id, email_key, deleted_at IS NOT NULL AS retired
FROM identities WHERE tenant_id = 1 ORDER BY id;

Định danh 200 đã có thời điểm ngừng dùng, nhưng một Alice khác trong tenant một vẫn xung đột. Quy tắc này có thể giữ định danh tài khoản xuyên qua một lần vô hiệu hóa tạm thời. Nó cũng có thể ngăn người khác đăng ký địa chỉ đã thực sự chuyển chủ. Không kết quả nào tự động đúng với mọi sản phẩm.

Nếu chỉ tài khoản đang hoạt động phải duy nhất, partial unique index có thể loại hàng đã ngừng dùng khỏi phạm vi. Đoạn sau là thí nghiệm trên cùng schema dùng thử, trong transaction được rollback sau đó. Nó không phải quy trình thay đổi hệ thống định danh đang vận hành:

BEGIN;
ALTER TABLE identities DROP CONSTRAINT identities_tenant_email_key;
CREATE UNIQUE INDEX identities_active_email_key
  ON identities (tenant_id, email_key) WHERE deleted_at IS NULL;
INSERT INTO identities (id, tenant_id, email_original)
VALUES (202, 1, 'alice@example.com');
SELECT id, deleted_at IS NULL AS active
FROM identities WHERE tenant_id = 1 ORDER BY id;
ROLLBACK;

Truy vấn cho thấy định danh 200 không hoạt động và định danh 202 mới thêm đang hoạt động. Rollback xóa hàng thay thế, đồng thời khôi phục ràng buộc duy nhất đầy đủ ban đầu cùng dữ liệu trước thí nghiệm. SQL minh họa quy tắc đã đổi mà không để ví dụ chuyển vĩnh viễn sang quy tắc ấy.

Bộ kiểm tra kèm theo còn giữ cấu hình thay thế đủ lâu để thử khôi phục định danh 200. Xóa thời điểm ngừng dùng thất bại với 23505, vì định danh 202 hiện giữ khóa đang hoạt động. Một hàng thay thế hoạt động thứ hai cũng thất bại. Truy vấn chỉ tìm tài khoản đang hoạt động phải có cùng điều kiện về thời điểm ngừng dùng; nếu không, nó có thể thấy cả bản ghi cũ lẫn mới.

Quy tắc duy nhất đầy đủ giữ khóa của định danh đã ngừng dùng; quy tắc chỉ xét hàng hoạt động cho phép thay thế nhưng chặn khôi phục khi hàng thay thế còn hoạt độngMở ảnh kích thước đầy đủ ↗

Vì thế, tái sử dụng địa chỉ thay đổi nhiều hơn một index. Đặt lại mật khẩu, lời mời và liên kết cũ phải xác định đúng tài khoản dự kiến, không âm thầm gắn quyền lịch sử cho bất kỳ hàng hoạt động nào hiện có email đó. Mô hình chưa triển khai các luồng này; nó làm xung đột và hậu quả khi khôi phục trở nên quan sát được để phục vụ quyết định thiết kế.

Xem việc đổi quy tắc là migration định danh

Một quy tắc tương lai xóa dấu câu, đổi ánh xạ hoa thường hoặc mở rộng bộ ký tự được hỗ trợ có thể ánh xạ khóa cũ khác đi. Tính khóa dự kiến trước khi đổi bên ghi, nhóm các xung đột theo phạm vi tenant mong muốn và quyết định cách xử lý từng nhóm. Migration âm thầm chọn một hàng sống sót có thể gán nhầm lịch sử cho tài khoản dù mọi ràng buộc cuối cùng đều vượt qua.

Khóa sinh tự động giảm bất đồng giữa các bên ghi hiện tại, nhưng không khiến thay đổi chuẩn hóa trở nên miễn phí. Tra cứu, tạo tài khoản, đổi địa chỉ, xác minh và khôi phục phải thống nhất cùng ánh xạ. Phối hợp quá trình chuyển đổi và kiểm tra hàng hiện có trước khi thay biểu thức hay index. Transaction ngắn bên trên chỉ minh họa ngữ nghĩa, không phải kế hoạch migration trực tuyến hoặc ước lượng thời gian giữ khóa.

Trong bài tập thực hành, giữ ràng buộc duy nhất đầy đủ và cho định danh 200 ngừng dùng, rồi dự đoán kết quả của insert cùng tenant, tra cứu ở tenant hai và thử ghi đè khóa. Tiếp theo so các kết quả đó với phương án chỉ xét hàng hoạt động và lần khôi phục thất bại của nó. Bạn cần giải thích được từng kết quả bằng phạm vi định danh và vòng đời đã chọn, đồng thời tách cú pháp, quyền sở hữu và phân quyền khỏi tính duy nhất.

Nguồn tham khảo & đọc thêm

  1. PostgreSQL 17: constraints
  2. PostgreSQL 17: partial indexes
  3. PostgreSQL 17: unique checks
  4. PostgreSQL 17: collation
  5. PostgreSQL 17: generated columns
  6. RFC 5321: case sensitivity
  7. Google: dots in Gmail addresses
← Về trang bài viết

Hình minh họa

100%