ترکیب چند منبع داده یکی از نیازهای رایج در هر اتوماسیون است. زمانی که اطلاعات از APIهای مختلف، دیتابیس، وبهوک یا فایل‌ها وارد n8n می‌شود، اغلب لازم است این داده‌ها در یک ساختار یکپارچه تجمیع شوند. Merge Node در n8n دقیقا برای همین هدف ساخته شده است و امکان ترکیب دو جریان داده را با روش‌های متفاوت فراهم می‌کند. در این مقاله یاد می‌گیرید چگونه با استفاده از Merge Node داده‌های مختلف را کنار هم قرار دهید و یک خروجی هماهنگ بسازید تا بتوانید گزارش‌های حرفه‌ای، داشبوردهای دقیق و اتوماسیون‌های هوشمند ایجاد کنید.

Merge Node چیست؟

Merge Node یکی از مهم‌ترین Nodeها در n8n است که اجازه می‌دهد خروجی دو Node مختلف را با هم ترکیب کنید. این ترکیب بسته به نیاز شما می‌تواند به صورت ادغام ساده، الحاق ردیف‌ها یا تطبیق آیتم‌ها بر اساس کلید مشترک انجام شود. نتیجه آن یک جریان داده منسجم است که می‌توان در گزارش‌سازی، ذخیره در دیتابیس یا ارسال به ابزارهای دیگر از آن استفاده کرد.

چرا Merge Node اهمیت دارد؟

Merge Node فقط ادغام داده نیست؛ بلکه یک ابزار کلیدی برای مدیریت جریان داده در اتوماسیون‌های پیچیده است. استفاده از Merge Node در موارد زیر ضروری می‌شود:

  • زمانی که داده از منابع مختلف می‌آید و باید یکپارچه شود.
  • وقتی نیاز دارید داده‌های API را با دیتابیس مقایسه کنید.
  • وقتی می‌خواهید گزارش ترکیبی از چند سرویس تهیه کنید.
  • زمانی که داده‌های خام را باید در ساختار قابل تحلیل قرار دهید.

حالت‌های مختلف Merge Node

Merge چند روش مختلف دارد که هر کدام کاربرد خاص خود را دارد. مهم‌ترین حالت‌ها شامل موارد زیر هستند:

حالت ۱: Append

در این حالت، داده‌های ورودی A و B پشت سر هم قرار می‌گیرند. این روش زمانی مفید است که داده‌های مشابه از دو منبع مختلف دارید و می‌خواهید همه را یکجا پردازش کنید.

حالت ۲: Merge by Index

در این روش، آیتم‌های دو ورودی بر اساس اندیس یکسان در یک ردیف ترکیب می‌شوند. این روش زمانی کاربردی است که ساختار داده‌ها مشابه است.

حالت ۳: Merge by Key

مهم‌ترین و حرفه‌ای‌ترین روش Merge، ترکیب بر اساس کلید مشترک است. برای مثال وقتی می‌خواهید اطلاعات کاربر را از API و دیتابیس کنار هم قرار دهید. با داشتن فیلد مشترک مثل email، دو داده با هم در یک خروجی ادغام می‌شوند.

حالت ۴: Keep Key Matches

این حالت فقط داده‌هایی را نگه می‌دارد که در هر دو جریان دارای کلید مشترک هستند. برای مثال وقتی کاربرانی که خرید کرده‌اند را باید با لیست ثبت‌نام‌ شدگان مقایسه کنید.

مثال عملی: ترکیب داده API و Google Sheets

فرض کنید یک API اطلاعات کاربران جدید را می‌دهد و Google Sheets اطلاعات سفارش‌های ثبت‌شده را نگه می‌دارد. شما می‌خواهید کاربرانی را پیدا کنید که هم ثبت‌نام کرده‌اند و هم سفارش داده‌اند. مراحل کار به صورت زیر است:

  1. دریافت داده کاربران از API با HTTP Request
  2. دریافت اطلاعات سفارش‌ها از Google Sheets
  3. استفاده از Merge Node با حالت Merge by Key
  4. انتخاب کلید مشترک مانند email
  5. بررسی خروجی و ارسال نتیجه به تلگرام یا دیتابیس

این فرآیند باعث تولید یک گزارش دقیق از کاربران فعال می‌شود.

گام‌به‌گام ساخت Workflow

گام ۱: دریافت داده

دو Node ورودی ایجاد کنید؛ یکی از نوع HTTP Request و یکی از نوع Google Sheets. داده‌ها را تست کنید تا خروجی‌ها کاملاً درست باشند.

گام ۲: افزودن Merge Node

یک Merge Node اضافه کرده و آن را به هر دو Node قبلی متصل کنید. روش Merge را بر اساس نیاز انتخاب کنید. اگر داده ساختار مشترک دارد، Merge by Key بهترین گزینه است.

گام ۳: تنظیم کلید مشترک

اگر روش Merge by Key را انتخاب کردید، فیلدهایی مثل email، id یا phone را تنظیم کنید.

گام ۴: مشاهده نتیجه

Workflow را اجرا کنید و در خروجی Merge Node داده‌های ترکیبی را مشاهده کنید.

گام ۵: استفاده از نتیجه

در نهایت می‌توانید این داده‌ها را برای گزارش‌سازی به Google Sheets بفرستید، در Telegram ارسال کنید یا در دیتابیس ذخیره نمایید.

نکات مهم در استفاده از Merge Node

  • خروجی هر دو Node باید ساختار JSON معتبر داشته باشد.
  • کلید مشترک باید در هر دو جریان وجود داشته باشد.
  • Merge Node فقط دو ورودی را پشتیبانی می‌کند، ولی با Workflow بزرگ‌تر می‌توانید چندین مرحله ادغام ایجاد کنید.
  • اگر داده‌ها حجیم هستند، بهتر است قبل از Merge توسط Function یا Set خلاصه شوند.

در قسمت بعد

در قسمت بعدی یاد می گیرید چگونه با استفاده از Merge Node داده های مختلف را ترکیب کرده و یک خروجی یکپارچه بسازید. این قابلیت برای ساخت گزارش های حرفه ای و تجمیع داده بسیار کاربردی است.