Giới thiệu
Trong các workflow n8n thực tế, bạn hiếm khi có một đường thực thi thẳng duy nhất. Phổ biến hơn là bạn tách luồng: một nhánh truy vấn CRM, nhánh khác lấy dữ liệu analytics, nhánh thứ ba chờ webhook từ khách hàng. Tại một thời điểm nào đó, bạn cần đưa các nhánh song song này hội tụ lại — và đó chính xác là mục đích của node Merge. Hiểu cách kết hợp các nhánh đúng cách sẽ giúp tránh mất dữ liệu, xử lý trùng lặp và các lỗi im lặng chỉ xuất hiện khi vận hành thực tế.
Bài học này trình bày ba chiến lược merge chính trong n8n: chờ tất cả đầu vào, gộp theo khóa khớp (kiểu SQL JOIN), và nối (concatenate) tất cả các item đầu vào. Mỗi chiến lược phục vụ một mục đích khác nhau, và chọn sai chiến lược là một trong những lỗi phổ biến nhất khi xây dựng các tự động hóa phức tạp.
Cách hoạt động của node Merge
Node Merge nhận nhiều luồng đầu vào (Input 1, Input 2, có thể thêm nữa) và tạo ra một luồng đầu ra duy nhất. Node này chỉ thực thi khi mọi đầu vào được kết nối đã gửi ít nhất một item, nghĩa là nó ngầm đồng bộ hóa các nhánh. Đây là hành vi "chờ": dù một nhánh kết thúc nhanh đến đâu, node Merge sẽ tạm dừng cho đến khi nhánh chậm nhất đến.
Bạn cũng có thể thêm timeout trong cài đặt node. Nếu một nhánh không bao giờ hoàn thành, merge sẽ cuối cùng ngừng chờ và hoặc loại bỏ dữ liệu hoặc tiếp tục với những gì đã đến. Điều này quan trọng với các workflow chạy lâu, nơi một API bên ngoài có thể bị treo.
Merge theo khóa (Hành vi Join)
Đây là tương đương gần nhất với SQL JOIN. Bạn chọn một trường (ví dụ `email` hoặc `orderId`) tồn tại trong cả hai luồng đầu vào, và node sẽ ghép cặp các item có chung giá trị. Theo mặc định, các item không khớp sẽ bị loại bỏ, nhưng bạn có thể cấu hình chế độ để hoạt động như LEFT JOIN (giữ các item không khớp từ Input 1) hoặc outer join.
Kết quả là một item cho mỗi cặp khớp, với các trường từ cả hai đầu vào được kết hợp. Các tùy chọn trong dropdown là:
Append: nối tất cả item từ cả hai đầu vào thành một danh sách phẳng, theo thứ tự, không ghép cặp. Dùng khi các nhánh tạo ra các bản ghi độc lập cần được xử lý chung sau đó (ví dụ, tất cả liên hệ từ Mailchimp và tất cả liên hệ từ HubSpot được xếp hàng cho một bước khử trùng lặp duy nhất).
Merge By Key: ghép cặp item trên một trường chung, như database join. Dùng khi mỗi item ở một bên có liên hệ logic với một item ở bên kia, ví dụ như ghép bản ghi đơn hàng với bản ghi thanh toán tương ứng.
Wait: chế độ đơn giản nhất — không thực hiện biến đổi nào, chỉ đồng bộ thời gian. Các item đầu ra theo thứ tự của Input 1, và các item của Input 2 chỉ được gắn vào một-một theo vị trí. Chỉ sử dụng khi bạn kiểm soát cả hai nhánh và biết thứ tự khớp nhau.
Dropdown Mode có bốn tùy chọn: Append, Merge By Key, Merge By Position và Wait. Lưu ý rằng "Merge By Position" là tên kỹ thuật cho hành vi chờ-và-ghép-cặp đơn giản — nó ghép item theo chỉ số (index) trong mảng đầu vào, chỉ hoạt động chính xác khi cả hai nhánh có cùng số lượng item theo cùng thứ tự.
Ví dụ thực tế: Kết hợp dữ liệu Đơn hàng và Thanh toán
Hãy tưởng tượng Nhánh 1 lấy đơn hàng từ cơ sở dữ liệu, và Nhánh 2 lấy trạng thái thanh toán từ Stripe. Mỗi nhánh tạo ra các item có trường `orderId`. Bạn muốn một bản ghi kết hợp cho mỗi đơn hàng.
Với `joinMode` đặt là `inner`, chỉ những đơn hàng tồn tại trong cả hai nhánh mới xuất hiện trong đầu ra. Nếu bạn chuyển sang `left`, những đơn hàng chưa có bản ghi thanh toán vẫn chạy xuống các node phía sau, được đánh dấu là không khớp — hữu ích để phát hiện các khoản thanh toán bị thiếu.
Lỗi thường gặp và các điểm cần lưu ý
Lỗi thường xuyên nhất là dùng "Merge By Position" khi hai nhánh tạo ra số lượng item khác nhau. Nếu Nhánh 1 trả về 10 đơn hàng và Nhánh 2 chỉ trả về 7 bản ghi thanh toán, 3 item đơn hàng sẽ hoặc được ghép với dữ liệu thanh toán `null` hoặc bị loại bỏ âm thầm tùy theo cài đặt. Luôn dùng "Merge By Key" khi số lượng có thể khác nhau.
Một điểm cần lưu ý khác: node Merge không khử trùng lặp. Nếu Nhánh 1 có cùng email hai lần và Nhánh 2 chỉ một lần, bạn có thể nhận các dòng ghép trùng lặp. Việc khử trùng lặp phải diễn ra trước khi merge, hoặc bằng một node riêng sau đó.
Cuối cùng, hãy nhớ rằng Merge chờ mọi đầu vào được kết nối. Nếu bạn quên kết nối một đầu vào, node sẽ chờ mãi mãi (hoặc đến khi hết timeout). Đầu vào không được kết nối là nguyên nhân phổ biến khiến workflow bị treo trong môi trường production.
Tóm tắt
Node Merge là điểm đồng bộ hóa của mọi workflow đa nhánh. Dùng Append khi bạn chỉ muốn xếp chồng các danh sách độc lập, Merge By Key khi các item ở mỗi bên liên quan qua một định danh chung, và Wait / Merge By Position chỉ khi cả hai nhánh tạo ra các mảng khớp có cùng độ dài. Luôn kiểm tra mọi đầu vào đã được kết nối, chọn join mode phù hợp với yêu cầu toàn vẹn dữ liệu của bạn, và đặt bước khử trùng lặp bên ngoài merge để tránh các bất ngờ.
Bài kiểm tra cuối bài
Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.