The 'Column to Match On' parameter is required
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ă
Operation: Update, Column to Match On: (gol)Operation: Update, Column to Match On: idn8n caută rândul după valoarea din coloana id.
2Coloană care se repetă
Column to Match On: statusColumn to Match On: idCu valori repetate se modifică rândul greșit.
3Valoare de potrivire lipsă
Values to Send fără coloana idValues to Send: id = {{ $json.id }}n8n are nevoie de valoarea după care caută.
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.
Reparația
1. Status → Column to Match On: id. 2. Execute workflow: rândul 5002 are acum livrata.
De ce merge
Fără coloana-cheie, n8n nu știa ce rând să modifice. Cu id, caută rândul cu id 5002 și îi schimbă statusul.
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
Column names were updated after the node's setup Coloanele din foaia Google Sheets s-au schimbat (redenumite, șterse, mutate) după ce ai configurat nodul, iar maparea din nod folosește numele vechi. Reîncarcă coloanele în nod (Refresh) și remapează valorile pe coloanele actuale. Sheet with name "Comenzi 2026" not found Google Sheets nu găsește foaia (tab-ul) cu numele din nod: a fost redenumită, are un spațiu în plus sau numele e scris diferit. Alege foaia din listă (From list) sau după ID (gid), care nu se schimbă la redenumire. The field 'produs' wasn't found in any input item Split Out (sau Aggregate) caută câmpul scris în „Fields To Split Out” și nu îl găsește în niciun item: numele e greșit (produs în loc de produse) sau câmpul e mai adânc (body.produse). Scrie exact numele listei, așa cum apare în Input, sau trage-l de acolo. Î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.
