Upsert використовує зовнішній ідентифікатор, щоб визначити, створює він запис чи оновлює існуючий: якщо зовнішній ідентифікатор не збігається, створюється новий запис. Якщо зовнішній ідентифікатор збігається один раз, існуючий запис оновлюється. Якщо зовнішній ідентифікатор збігається кілька разів, повідомляється про помилку.
Термін upsert — це портманто — поєднання слів «оновити» та «вставити». У контексті реляційних баз даних upsert — це операція бази даних, яка буде оновити наявний рядок, якщо вказане значення вже існує в таблиці, і вставити новий рядок, якщо вказане значення ще не існує.
Параметр INSERT надсилає вхідні записи до місця призначення. Параметр UPDATE відстежує записи, які оновлюються в таблиці бази даних. Параметр UPSERT — це комбінація «Оновити» та «Вставити», що означає, що він перевіряє записи, які вставлено або оновлено.
Дія Upsert дозволяє вказати інші поля зовнішнього ідентифікатора для використання замість стандартного внутрішнього ідентифікатора. Це може позбавити вас від виконання запиту Salesforce (пошук виклику з’єднувача), щоб знайти внутрішній ідентифікатор на основі іншого значення, наприклад імені, з ваших вихідних даних.
Якщо у вас є об’єкт, який посилається на інший об’єкт за допомогою зв’язку, ви можете використовуйте REST API, щоб вставити або оновити запис і посилатися на інший об’єкт за допомогою зовнішнього ідентифікатора. У наступному прикладі створюється запис і пов’язується з батьківським записом через зовнішній ідентифікатор.