Hoàn thành bài "Bài 2: Làm việc với Expressions và Data Transformations" trước để mở khoá bài này.Đến bài trước

Giới thiệu

Khi một workflow n8n nhận một danh sách các item — ví dụ 500 dòng từ bảng tính hoặc 1.000 liên hệ từ API — việc đổ toàn bộ chúng sang node tiếp theo một cách thô sơ có thể gây ra các vấn đề: giới hạn tốc độ (rate limit), timeout, tăng đột biến bộ nhớ, hoặc khoá bảng trong cơ sở dữ liệu. Node SplitInBatches giải quyết điều này bằng cách chia danh sách thành các nhóm nhỏ hơn và giải phóng từng lô một, cho phép các node phía sau có thời gian nghỉ giữa các nhóm.

Hãy hình dung đó như một băng chuyền có kiểm soát: thay vì đổ 1.000 thùng hàng cho một công nhân cùng lúc, bạn đưa vào 50 thùng mỗi đợt.

sơ đồ flowchart thể hiện 1 mảng đầu vào được chia thành 3 lô tuần tự, đi vào một node xử lý phía sau

Cách SplitInBatches hoạt động

SplitInBatches nằm giữa nguồn dữ liệu và node xử lý từng item. Ở lần thực thi đầu tiên, nó phát ra lô đầu tiên (kích thước có thể cấu hình, mặc định 1 item), tạm dừng, sau đó ở các lần thực thi tiếp theo sẽ phát ra lô kế tiếp cho đến khi danh sách được xử lý hết. Mỗi lô đi qua cùng một nhánh xử lý phía sau, vì vậy bạn thường kết hợp nó với một node Set, HTTP Request, hoặc node cơ sở dữ liệu.

Node này có hai đầu ra quan trọng: "Done" kích hoạt một lần duy nhất sau khi lô cuối cùng được giải phóng — hữu ích cho bước tổng kết hoặc dọn dẹp cuối cùng — và "Loop" đưa lô tiếp theo quay lại nhánh xử lý của bạn.

Cấu hình cơ bản

Mở node và đặt Batch Size bằng một con số phù hợp với khả năng chịu tải của dịch vụ phía sau. Đối với hầu hết các HTTP API giới hạn 100 request mỗi phút, Batch Size = 10 kết hợp với node Wait 6 giây giữa các lô sẽ hoạt động tốt.

json
{
"node": "SplitInBatches",
"parameters": {
"batchSize": 10,
"options": {}
},
"type": "n8n-nodes-base.splitInBatches"
}

Nối đầu ra "Loop" vào node xử lý của bạn, sau đó từ node đó nối ngược lại SplitInBatches để lô tiếp theo được giải phóng. Nối đầu ra "Done" vào bất kỳ bước tổng kết nào bạn cần.

Ví dụ thực tế: Đẩy danh bạ sang API bên ngoài

Hãy tưởng tượng bạn lấy được 200 liên hệ từ một CRM và cần POST từng liên hệ đến một webhook. Nếu không phân lô, bạn sẽ bắn 200 request ngay lập tức và nhiều khả năng gặp lỗi 429 Too Many Requests.

Workflow trông như sau: một trigger Cron chạy hằng ngày, node HTTP Request lấy danh sách liên hệ, SplitInBatches nhóm chúng theo lô 10, mỗi lô đi vào một vòng lặp gọi webhook cho từng item, sau đó một node Wait tạm dừng 6 giây, rồi quyền điều khiển quay về SplitInBatches để xử lý lô tiếp theo. Khi tất cả các lô đã được xử lý, nhánh "Done" ghi log "Synced 200 contacts" lên Slack.

sơ đồ vòng đời thể hiện một lần lặp hoàn chỉnh: SplitInBatches phát lô → node xử lý xử lý các item → Wait tạm dừng → quay về SplitInBatches → lặp lại cho đến khi nhánh Done kích hoạt

Những lỗi thường gặp

Quên nối vòng lặp ngược lại là lỗi phổ biến nhất — nếu thiếu kết nối đó, workflow sẽ dừng sau lô đầu tiên. Một sai sót thường gặp khác là đặt node Wait sau SplitInBatches thay vì bên trong nhánh lặp; làm vậy sẽ vô hiệu mục đích vì không có thời gian nghỉ giữa các lô. Cuối cùng, hãy nhớ rằng SplitInBatches giữ trạng thái theo từng lần thực thi, vì vậy mỗi lần trigger mới sẽ bắt đầu lại từ lô một — bạn không thể tiếp tục một vòng lặp lô đang dở từ lần thực thi trước.

Tóm tắt

SplitInBatches là node nên dùng mỗi khi dịch vụ phía sau không thể hấp thụ toàn bộ danh sách của bạn trong một lần. Hãy đặt Batch Size hợp lý dựa trên giới hạn tốc độ của API đích, luôn nối đầu ra loop ngược lại, kết hợp node Wait bên trong vòng lặp để nhịp độ thân thiện với rate limit, và sử dụng nhánh "Done" cho việc dọn dẹp cuối lần chạy.

Với các danh sách lớn hơn vài trăm item hoặc khi cần xử lý song song, hãy xem xét node Loop hoặc một sub-workflow với trigger Execute Workflow — những phần đó sẽ được đề cập trong các bài sau.

Luyện tập sau buổi học

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.

0/1
Đã trả lời · 0/1