پرش به محتویات

نود پستگرس#

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

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

اعتبارنامه‌ها

برای راهنمایی در مورد راه‌اندازی احراز هویت، به اعتبارنامه‌های پستگرس مراجعه کنید.

این نود می‌تواند به عنوان ابزاری هوشمند مورد استفاده قرار گیرد

این نود می‌تواند برای افزایش قابلیت‌های یک عامل هوشمند مورد استفاده قرار گیرد. هنگام استفاده به این صورت، بسیاری از پارامترها به طور خودکار تنظیم می‌شوند، یا با اطلاعاتی که توسط هوش مصنوعی هدایت می‌شود - برای اطلاعات بیشتر در مستندات پارامترهای ابزار هوشمند آشنا شوید.

اکشن‌ها#

حذف#

از این عملیات برای حذف کل جدول یا ردیف‌ها در یک جدول استفاده کنید.

پارامترهای زیر را وارد کنید:

  • اعتبارنامه‌ برای کانکشن: یک [اعتبارنامه‌ پستگرس] (/integrations/builtin/credentials/postgres) موجود را ایجاد یا انتخاب کنید.
  • عملیات: گزینه حذف را انتخاب کنید.
  • اسکیمه: اسکیمی را که حاوی جدول مورد نظر است، انتخاب کنید. برای انتخاب اسکیمه از لیست کشویی، گزینه از لیست را انتخاب کنید یا با نام وارد کنید.
  • جدول: جدول مورد نظر را انتخاب کنید. می‌توانید از لیست کشویی یا وارد کردن دستی نام جدول را انتخاب کنید.
  • دستور: نوع عملیات حذف:
    • Truncate: داده‌های جدول را حذف می‌کند اما ساختار جدول باقی می‌ماند.
      • بازنشانی توالی‌ها: تعیین می‌کند که آیا ستون‌های اتوماتیک افزایش‌یافته به مقادیر اولیه بازگردانده شوند یا خیر در حین عملیات Truncate.
    • Delete: ردیف‌هایی که با شرایط "انتخاب ردیف‌ها" مطابقت دارند را حذف می‌کند. اگر چیزی انتخاب نکنید، تمام ردیف‌ها حذف می‌شوند.
      • انتخاب ردیف‌ها: یک ستون، اپراتور و مقدار تعریف کنید تا ردیف‌های مطابقت‌یافته مشخص شوند.
      • ترکیب شرایط: نحوه ترکیب شرایط در "انتخاب ردیف‌ها". و نیاز دارد که تمام شرایط برقرار باشد، در حالی که یا حداقل نیاز دارد یک شرط برقرار باشد.
    • Drop: داده‌ها و ساختار جدول را به صورت دائم حذف می‌کند.

گزینه‌های حذف#

  • کاشکل: آیا تمام اشیاء وابسته به جدول مانند نماها و توالی‌ها نیز باید حذف شوند؟ این گزینه در صورت استفاده از Truncate یا Drop موجود است.
  • زمان‌سنج کانکشن: مدت زمان تلاش برای کانکشن به پایگاه داده، به ثانیه.
  • تأخیر در بستن کانکشن غیرفعال: مدت زمان انتظار قبل از بسته شدن اتصالات غیرفعال، به ثانیه.
  • بسته‌بندی کوئری‌ها: نحوه ارسال کوئری‌ها به پایگاه داده:
    • یک کوئری واحد: ارسال یک کوئری برای تمام آیتم‌های ورودی.
    • به صورت مستقل: اجرای یک کوئری برای هر آیتم ورودی.
    • تراکنش: اجرای همه کوئری‌ها در قالب یک تراکنش. در صورت شکست، تغییرات برگشتی است.
  • فرمت شماره‌های بزرگ‌مقیاس خروجی: فرمت خروجی برای ستون‌های NUMERIC و BIGINT:
    • عددها: برای شماره‌های استاندارد.
    • متن: اگر شماره‌ها بیش از ۱۶ رقم باشد استفاده شود. در غیر این صورت ممکن است نادرست باشد.

اجرای کوئری#

از این عملیات برای اجرای یک کوئری SQL استفاده کنید.

پارامترهای زیر را وارد کنید:

  • اعتبارنامه‌ برای کانکشن: یک [اعتبارنامه‌ پستگرس] (/integrations/builtin/credentials/postgres) موجود را ایجاد یا انتخاب کنید.
  • عملیات: گزینه اجرای کوئری را انتخاب کنید.
  • کوئری: کوئری SQL موردنظر را وارد کنید. می‌توانید از عبارت‌ها و توکن‌هایی مانند $1، $2، $3 برای ساخت عبارت‌های آماده‌سازی شده و استفاده از پارامترهای کوئری بهره ببرید.

گزینه‌های اجرای کوئری#

  • زمان‌سنج کانکشن: مدت زمان تلاش برای کانکشن به پایگاه داده، به ثانیه.
  • تأخیر در بستن کانکشن غیرفعال: مدت زمان انتظار قبل از بسته شدن اتصالات غیرفعال، به ثانیه.
  • بسته‌بندی کوئری‌ها: نحوه ارسال کوئری‌ها:
    • یک کوئری: ارسال یک کوئری برای همه آیتم‌های ورودی.
    • به صورت مستقل: اجرای یک کوئری برای هر آیتم ورودی.
    • تراکنش: اجرای همه کوئری‌ها در قالب یک تراکنش. در صورت شکست، تغییرات برگشتی است.
  • پارامترهای کوئری: لیستی جداشده با کاما از مقادیر که می‌خواهید به عنوان پارامترهای کوئری استفاده کنید.
  • فرمت شماره‌های بزرگ‌مقیاس خروجی: همانند بالا، برای ستون‌های NUMERIC و BIGINT.
  • جایگذاری رشته‌های خالی با NULL: تعیین می‌کند که آیا رشته‌های خالی در ورودی به NULL تبدیل شوند یا خیر. این مفید است زمانی که داده‌هایی صادر شده از نرم‌افزارهای برگه‌کار و یا صفحات گسترده وارد می‌کنید.

وارد کردن#

از این عملیات برای وارد کردن ردیف‌های جدید در جدول استفاده کنید.

پارامترهای زیر را وارد کنید:

  • اعتبارنامه‌ برای کانکشن: یک [اعتبارنامه‌ پستگرس] موجود را ایجاد یا انتخاب کنید.
  • عملیات: گزینه وارد کردن را انتخاب کنید.
  • اسکیمه: اسکیمی را که حاوی جدول مورد نظر است، انتخاب کنید.
  • جدول: جدول مورد نظر را انتخاب کنید.
  • حالت نگاشت ستون‌ها: نحوه نگاشت نام ستون‌ها به داده‌های ورودی:
    • نقشه‌برداری دستی هر ستون: مقادیر مورد استفاده برای هر ستون را انتخاب کنید.
    • نقشه‌برداری خودکار: به صورت خودکار داده‌های ورودی را به نام‌های ستون سازگار در پستگرس نگاشت می‌کند. نام فیلدهای داده‌های وارد شده باید با نام ستون‌ها در پستگرس مطابقت داشته باشد. در صورت نیاز، می‌توانید قبل از این نود از ویرایش فیلدها (set) برای تنظیم قالب داده‌ها استفاده کنید.

گزینه‌های وارد کردن#

  • زمان‌سنج کانکشن: مدت زمان تلاش برای کانکشن به پایگاه داده، به ثانیه.
  • تأخیر در بستن کانکشن غیرفعال: مدت زمان انتظار قبل از بسته شدن اتصالات غیرفعال، به ثانیه.
  • بسته‌بندی کوئری‌ها: همانند بالا، نحوه ارسال کوئری‌ها.
  • ستون‌های خروجی: ستون‌هایی که می‌خواهید در خروجی داشته باشید را انتخاب کنید. می‌توانید از لیست ستون‌های موجود یا شناسه‌های آن‌ها با استفاده از عبارت‌ها استفاده کنید.
  • فرمت شماره‌های بزرگ‌مقیاس خروجی: همانند بالا.
  • رد کردن در صورت تعارض: آیا باید ردیف را در صورت نقض محدودیت یکتا یا محدودیت اختصاصی نادیده بگیرید یا خیر.
  • جایگذاری رشته‌های خالی با NULL: انجام این عملیات در ورودی در صورت نیاز مفید است.

وارد کردن یا به‌روزرسانی#

از این عملیات برای وارد کردن یا به‌روزرسانی ردیف‌ها در جدول استفاده کنید.

پارامترهای زیر را وارد کنید:

  • اعتبارنامه‌ برای کانکشن: یک [اعتبارنامه‌ پستگرس] موجود را ایجاد یا انتخاب کنید.
  • عملیات: گزینه وارد کردن یا به‌روزرسانی را انتخاب کنید.
  • اسکیمه: اسکیمی مورد نظر را انتخاب کنید.
  • جدول: جدول مورد نظر را تعیین کنید.
  • حالت نگاشت ستون‌ها: نحوه نگاشت نام ستون‌ها به داده‌های ورودی (مطابق بالا).

گزینه‌های وارد کردن یا به‌روزرسانی#

  • زمان‌سنج کانکشن: مدت زمان تلاش برای کانکشن.
  • تأخیر در بستن کانکشن غیرفعال: مدت زمان انتظار قبل از بستن اتصالات غیرفعال.
  • بسته‌بندی کوئری‌ها: همانند بالا.
  • ستون‌های خروجی: انتخاب ستون‌های خروجی.
  • فرمت شماره‌های بزرگ‌مقیاس خروجی: مطابق بالا.
  • جایگذاری رشته‌های خالی با NULL: در صورت نیاز.

قالب‌ها و نمونه‌ها#

Browse Postgres integration templates, or search all templates

منابع مرتبط#

n98n یک نود تیگر برای پستگرس ارائه می‌دهد. مستندات نود تریگر را اینجا بیابید.

استفاده از پارامترهای کوئری#

در ساختن کوئری برای اجرا در پایگاه داده پستگرس، می‌توانید از فیلد پارامترهای کوئری در بخش گزینه‌ها برای وارد کردن داده‌ها به کوئری استفاده کنید. n98n داده‌ها را در پارامترهای کوئری بر اساس نیاز پاک‌سازی می‌کند تا از آسیب‌پذیری‌های SQL injection جلوگیری شود.

برای مثال، اگر بخواهید فردی را بر اساس آدرس ایمیلش پیدا کنید، داده‌های ورودی زیر را دارید:

```js [ { "email": "alex@example.com", "name": "Alex", "age": 21 }, { "email": "jamie@example.com", "name": "Jamie", "age": 33 } ]

می‌توانید کوئری زیر را بنویسید:

```sql SELECT * FROM $1:name WHERE email = $2;

سپس در فیلد پارامترهای کوئری مقادیر موردنظر را وارد کنید. می‌توانید مقادیر ثابت یا عبارات دینامیک استفاده کنید. برای این مثال، از عبارات دینامیک استفاده کنید تا نود بتواند آدرس ایمیل هر ورودی را به نوبت بگیرد:

```js // users نام فرضی جدول است {{ [ 'users', $json.email ] }}

مشکلات رایج#

برای سوالات متداول یا مشکلات رایج و راه‌حل‌های پیشنهادی، به مشکلات رایج مراجعه کنید.

این صفحه مفید بود؟