...
Eroare n8n · Gmail, Slack, Telegram și Google Sheets

The 'Column to Match On' parameter is required

Pe scurt

Operația Update (sau Append or Update) din Google Sheets trebuie să știe după ce coloană găsește rândul de modificat. Alege Column to Match On (de exemplu id sau email) și asigură-te că item-ul are valoarea pentru ea.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

La Update Row și Append or Update Row, nodul Google Sheets caută rândul existent după o coloană-cheie: Column to Match On. Fără ea, n8n nu știe ce rând să modifice și se oprește înainte de orice scriere.

Alege o coloană cu valori unice (ID comandă, email client), nu una care se repetă (status, oraș): altfel se modifică primul rând găsit, nu neapărat cel dorit. Valoarea după care se caută vine din maparea coloanei respective (Values to Send).

Dacă rândul nu există, Update nu face nimic, iar Append or Update adaugă un rând nou.

De ce apare: cauzele frecvente

1Coloană-cheie lipsă

Greșit
JSON
Operation: Update, Column to Match On: (gol)
Corect
JSON
Operation: Update, Column to Match On: id

n8n caută rândul după valoarea din coloana id.

2Coloană care se repetă

Greșit
JSON
Column to Match On: status
Corect
JSON
Column to Match On: id

Cu valori repetate se modifică rândul greșit.

3Valoare de potrivire lipsă

Greșit
JSON
Values to Send fără coloana id
Corect
JSON
Values to Send: id = {{ $json.id }}

n8n are nevoie de valoarea după care caută.

Repară tu

Repară eroarea, direct în pagină

Nodul Status trebuie să marcheze comanda 5002 ca livrată în foaia Comenzi, dar operația Update nu are Column to Match On și nodul se oprește. Alege coloana id și rulează: în foaie, comanda 5002 trebuie să aibă statusul livrata.

Indiciu

Coloana-cheie se alege în Column to Match On.

Alte forme ale mesajului

  • Alege „Column to match on”
  • Could not find column to match on

Cum o eviți pe viitor

  • Ține în fiecare foaie o coloană cu ID unic.
  • Folosește Append or Update când nu știi dacă rândul există.
  • Verifică după rulare că s-a modificat rândul corect.

Întrebări frecvente

Ce se întâmplă dacă sunt două rânduri cu același id?

Se modifică de obicei primul. De aceea cheia trebuie să fie unică.

Update vs Append or Update?

Update modifică doar rânduri existente; Append or Update adaugă rândul dacă nu-l găsește.

Erori înrudite

← Toate erorile n8n

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață n8n de la zero, cu exerciții la fiecare lecție

Curs Automatizări AI cu n8n: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.