xref: /sqlite-3.40.0/src/update.c (revision e3147332)
1 /*
2 ** 2001 September 15
3 **
4 ** The author disclaims copyright to this source code.  In place of
5 ** a legal notice, here is a blessing:
6 **
7 **    May you do good and not evil.
8 **    May you find forgiveness for yourself and forgive others.
9 **    May you share freely, never taking more than you give.
10 **
11 *************************************************************************
12 ** This file contains C code routines that are called by the parser
13 ** to handle UPDATE statements.
14 */
15 #include "sqliteInt.h"
16 
17 #ifndef SQLITE_OMIT_VIRTUALTABLE
18 /* Forward declaration */
19 static void updateVirtualTable(
20   Parse *pParse,       /* The parsing context */
21   SrcList *pSrc,       /* The virtual table to be modified */
22   Table *pTab,         /* The virtual table */
23   ExprList *pChanges,  /* The columns to change in the UPDATE statement */
24   Expr *pRowidExpr,    /* Expression used to recompute the rowid */
25   int *aXRef,          /* Mapping from columns of pTab to entries in pChanges */
26   Expr *pWhere,        /* WHERE clause of the UPDATE statement */
27   int onError          /* ON CONFLICT strategy */
28 );
29 #endif /* SQLITE_OMIT_VIRTUALTABLE */
30 
31 /*
32 ** The most recently coded instruction was an OP_Column to retrieve the
33 ** i-th column of table pTab. This routine sets the P4 parameter of the
34 ** OP_Column to the default value, if any.
35 **
36 ** The default value of a column is specified by a DEFAULT clause in the
37 ** column definition. This was either supplied by the user when the table
38 ** was created, or added later to the table definition by an ALTER TABLE
39 ** command. If the latter, then the row-records in the table btree on disk
40 ** may not contain a value for the column and the default value, taken
41 ** from the P4 parameter of the OP_Column instruction, is returned instead.
42 ** If the former, then all row-records are guaranteed to include a value
43 ** for the column and the P4 value is not required.
44 **
45 ** Column definitions created by an ALTER TABLE command may only have
46 ** literal default values specified: a number, null or a string. (If a more
47 ** complicated default expression value was provided, it is evaluated
48 ** when the ALTER TABLE is executed and one of the literal values written
49 ** into the sqlite_master table.)
50 **
51 ** Therefore, the P4 parameter is only required if the default value for
52 ** the column is a literal number, string or null. The sqlite3ValueFromExpr()
53 ** function is capable of transforming these types of expressions into
54 ** sqlite3_value objects.
55 **
56 ** If parameter iReg is not negative, code an OP_RealAffinity instruction
57 ** on register iReg. This is used when an equivalent integer value is
58 ** stored in place of an 8-byte floating point value in order to save
59 ** space.
60 */
61 void sqlite3ColumnDefault(Vdbe *v, Table *pTab, int i, int iReg){
62   assert( pTab!=0 );
63   if( !pTab->pSelect ){
64     sqlite3_value *pValue;
65     u8 enc = ENC(sqlite3VdbeDb(v));
66     Column *pCol = &pTab->aCol[i];
67     VdbeComment((v, "%s.%s", pTab->zName, pCol->zName));
68     assert( i<pTab->nCol );
69     sqlite3ValueFromExpr(sqlite3VdbeDb(v), pCol->pDflt, enc,
70                          pCol->affinity, &pValue);
71     if( pValue ){
72       sqlite3VdbeChangeP4(v, -1, (const char *)pValue, P4_MEM);
73     }
74 #ifndef SQLITE_OMIT_FLOATING_POINT
75     if( iReg>=0 && pTab->aCol[i].affinity==SQLITE_AFF_REAL ){
76       sqlite3VdbeAddOp1(v, OP_RealAffinity, iReg);
77     }
78 #endif
79   }
80 }
81 
82 /*
83 ** Process an UPDATE statement.
84 **
85 **   UPDATE OR IGNORE table_wxyz SET a=b, c=d WHERE e<5 AND f NOT NULL;
86 **          \_______/ \________/     \______/       \________________/
87 *            onError   pTabList      pChanges             pWhere
88 */
89 void sqlite3Update(
90   Parse *pParse,         /* The parser context */
91   SrcList *pTabList,     /* The table in which we should change things */
92   ExprList *pChanges,    /* Things to be changed */
93   Expr *pWhere,          /* The WHERE clause.  May be null */
94   int onError            /* How to handle constraint errors */
95 ){
96   int i, j;              /* Loop counters */
97   Table *pTab;           /* The table to be updated */
98   int addr = 0;          /* VDBE instruction address of the start of the loop */
99   WhereInfo *pWInfo;     /* Information about the WHERE clause */
100   Vdbe *v;               /* The virtual database engine */
101   Index *pIdx;           /* For looping over indices */
102   int nIdx;              /* Number of indices that need updating */
103   int iCur;              /* VDBE Cursor number of pTab */
104   sqlite3 *db;           /* The database structure */
105   int *aRegIdx = 0;      /* One register assigned to each index to be updated */
106   int *aXRef = 0;        /* aXRef[i] is the index in pChanges->a[] of the
107                          ** an expression for the i-th column of the table.
108                          ** aXRef[i]==-1 if the i-th column is not changed. */
109   int chngRowid;         /* True if the record number is being changed */
110   Expr *pRowidExpr = 0;  /* Expression defining the new record number */
111   int openAll = 0;       /* True if all indices need to be opened */
112   AuthContext sContext;  /* The authorization context */
113   NameContext sNC;       /* The name-context to resolve expressions in */
114   int iDb;               /* Database containing the table being updated */
115   int okOnePass;         /* True for one-pass algorithm without the FIFO */
116   int hasFK;             /* True if foreign key processing is required */
117 
118 #ifndef SQLITE_OMIT_TRIGGER
119   int isView;            /* True when updating a view (INSTEAD OF trigger) */
120   Trigger *pTrigger;     /* List of triggers on pTab, if required */
121   int tmask;             /* Mask of TRIGGER_BEFORE|TRIGGER_AFTER */
122 #endif
123   int newmask;           /* Mask of NEW.* columns accessed by BEFORE triggers */
124 
125   /* Register Allocations */
126   int regRowCount = 0;   /* A count of rows changed */
127   int regOldRowid;       /* The old rowid */
128   int regNewRowid;       /* The new rowid */
129   int regNew;            /* Content of the NEW.* table in triggers */
130   int regOld = 0;        /* Content of OLD.* table in triggers */
131   int regRowSet = 0;     /* Rowset of rows to be updated */
132 
133   memset(&sContext, 0, sizeof(sContext));
134   db = pParse->db;
135   if( pParse->nErr || db->mallocFailed ){
136     goto update_cleanup;
137   }
138   assert( pTabList->nSrc==1 );
139 
140   /* Locate the table which we want to update.
141   */
142   pTab = sqlite3SrcListLookup(pParse, pTabList);
143   if( pTab==0 ) goto update_cleanup;
144   iDb = sqlite3SchemaToIndex(pParse->db, pTab->pSchema);
145 
146   /* Figure out if we have any triggers and if the table being
147   ** updated is a view.
148   */
149 #ifndef SQLITE_OMIT_TRIGGER
150   pTrigger = sqlite3TriggersExist(pParse, pTab, TK_UPDATE, pChanges, &tmask);
151   isView = pTab->pSelect!=0;
152   assert( pTrigger || tmask==0 );
153 #else
154 # define pTrigger 0
155 # define isView 0
156 # define tmask 0
157 #endif
158 #ifdef SQLITE_OMIT_VIEW
159 # undef isView
160 # define isView 0
161 #endif
162 
163   if( sqlite3ViewGetColumnNames(pParse, pTab) ){
164     goto update_cleanup;
165   }
166   if( sqlite3IsReadOnly(pParse, pTab, tmask) ){
167     goto update_cleanup;
168   }
169   aXRef = sqlite3DbMallocRaw(db, sizeof(int) * pTab->nCol );
170   if( aXRef==0 ) goto update_cleanup;
171   for(i=0; i<pTab->nCol; i++) aXRef[i] = -1;
172 
173   /* Allocate a cursors for the main database table and for all indices.
174   ** The index cursors might not be used, but if they are used they
175   ** need to occur right after the database cursor.  So go ahead and
176   ** allocate enough space, just in case.
177   */
178   pTabList->a[0].iCursor = iCur = pParse->nTab++;
179   for(pIdx=pTab->pIndex; pIdx; pIdx=pIdx->pNext){
180     pParse->nTab++;
181   }
182 
183   /* Initialize the name-context */
184   memset(&sNC, 0, sizeof(sNC));
185   sNC.pParse = pParse;
186   sNC.pSrcList = pTabList;
187 
188   /* Resolve the column names in all the expressions of the
189   ** of the UPDATE statement.  Also find the column index
190   ** for each column to be updated in the pChanges array.  For each
191   ** column to be updated, make sure we have authorization to change
192   ** that column.
193   */
194   chngRowid = 0;
195   for(i=0; i<pChanges->nExpr; i++){
196     if( sqlite3ResolveExprNames(&sNC, pChanges->a[i].pExpr) ){
197       goto update_cleanup;
198     }
199     for(j=0; j<pTab->nCol; j++){
200       if( sqlite3StrICmp(pTab->aCol[j].zName, pChanges->a[i].zName)==0 ){
201         if( j==pTab->iPKey ){
202           chngRowid = 1;
203           pRowidExpr = pChanges->a[i].pExpr;
204         }
205         aXRef[j] = i;
206         break;
207       }
208     }
209     if( j>=pTab->nCol ){
210       if( sqlite3IsRowid(pChanges->a[i].zName) ){
211         j = -1;
212         chngRowid = 1;
213         pRowidExpr = pChanges->a[i].pExpr;
214       }else{
215         sqlite3ErrorMsg(pParse, "no such column: %s", pChanges->a[i].zName);
216         pParse->checkSchema = 1;
217         goto update_cleanup;
218       }
219     }
220 #ifndef SQLITE_OMIT_AUTHORIZATION
221     {
222       int rc;
223       rc = sqlite3AuthCheck(pParse, SQLITE_UPDATE, pTab->zName,
224                             j<0 ? "ROWID" : pTab->aCol[j].zName,
225                             db->aDb[iDb].zName);
226       if( rc==SQLITE_DENY ){
227         goto update_cleanup;
228       }else if( rc==SQLITE_IGNORE ){
229         aXRef[j] = -1;
230       }
231     }
232 #endif
233   }
234 
235   hasFK = sqlite3FkRequired(pParse, pTab, aXRef, chngRowid);
236 
237   /* Allocate memory for the array aRegIdx[].  There is one entry in the
238   ** array for each index associated with table being updated.  Fill in
239   ** the value with a register number for indices that are to be used
240   ** and with zero for unused indices.
241   */
242   for(nIdx=0, pIdx=pTab->pIndex; pIdx; pIdx=pIdx->pNext, nIdx++){}
243   if( nIdx>0 ){
244     aRegIdx = sqlite3DbMallocRaw(db, sizeof(Index*) * nIdx );
245     if( aRegIdx==0 ) goto update_cleanup;
246   }
247   for(j=0, pIdx=pTab->pIndex; pIdx; pIdx=pIdx->pNext, j++){
248     int reg;
249     if( hasFK || chngRowid ){
250       reg = ++pParse->nMem;
251     }else{
252       reg = 0;
253       for(i=0; i<pIdx->nColumn; i++){
254         if( aXRef[pIdx->aiColumn[i]]>=0 ){
255           reg = ++pParse->nMem;
256           break;
257         }
258       }
259     }
260     aRegIdx[j] = reg;
261   }
262 
263   /* Begin generating code. */
264   v = sqlite3GetVdbe(pParse);
265   if( v==0 ) goto update_cleanup;
266   if( pParse->nested==0 ) sqlite3VdbeCountChanges(v);
267   sqlite3BeginWriteOperation(pParse, 1, iDb);
268 
269 #ifndef SQLITE_OMIT_VIRTUALTABLE
270   /* Virtual tables must be handled separately */
271   if( IsVirtual(pTab) ){
272     updateVirtualTable(pParse, pTabList, pTab, pChanges, pRowidExpr, aXRef,
273                        pWhere, onError);
274     pWhere = 0;
275     pTabList = 0;
276     goto update_cleanup;
277   }
278 #endif
279 
280   /* Allocate required registers. */
281   regRowSet = ++pParse->nMem;
282   regOldRowid = regNewRowid = ++pParse->nMem;
283   if( pTrigger || hasFK ){
284     regOld = pParse->nMem + 1;
285     pParse->nMem += pTab->nCol;
286   }
287   if( chngRowid || pTrigger || hasFK ){
288     regNewRowid = ++pParse->nMem;
289   }
290   regNew = pParse->nMem + 1;
291   pParse->nMem += pTab->nCol;
292 
293   /* Start the view context. */
294   if( isView ){
295     sqlite3AuthContextPush(pParse, &sContext, pTab->zName);
296   }
297 
298   /* If we are trying to update a view, realize that view into
299   ** a ephemeral table.
300   */
301 #if !defined(SQLITE_OMIT_VIEW) && !defined(SQLITE_OMIT_TRIGGER)
302   if( isView ){
303     sqlite3MaterializeView(pParse, pTab, pWhere, iCur);
304   }
305 #endif
306 
307   /* Resolve the column names in all the expressions in the
308   ** WHERE clause.
309   */
310   if( sqlite3ResolveExprNames(&sNC, pWhere) ){
311     goto update_cleanup;
312   }
313 
314   /* Begin the database scan
315   */
316   sqlite3VdbeAddOp3(v, OP_Null, 0, regRowSet, regOldRowid);
317   pWInfo = sqlite3WhereBegin(
318       pParse, pTabList, pWhere, 0, 0, WHERE_ONEPASS_DESIRED, 0
319   );
320   if( pWInfo==0 ) goto update_cleanup;
321   okOnePass = pWInfo->okOnePass;
322 
323   /* Remember the rowid of every item to be updated.
324   */
325   sqlite3VdbeAddOp2(v, OP_Rowid, iCur, regOldRowid);
326   if( !okOnePass ){
327     sqlite3VdbeAddOp2(v, OP_RowSetAdd, regRowSet, regOldRowid);
328   }
329 
330   /* End the database scan loop.
331   */
332   sqlite3WhereEnd(pWInfo);
333 
334   /* Initialize the count of updated rows
335   */
336   if( (db->flags & SQLITE_CountRows) && !pParse->pTriggerTab ){
337     regRowCount = ++pParse->nMem;
338     sqlite3VdbeAddOp2(v, OP_Integer, 0, regRowCount);
339   }
340 
341   if( !isView ){
342     /*
343     ** Open every index that needs updating.  Note that if any
344     ** index could potentially invoke a REPLACE conflict resolution
345     ** action, then we need to open all indices because we might need
346     ** to be deleting some records.
347     */
348     if( !okOnePass ) sqlite3OpenTable(pParse, iCur, iDb, pTab, OP_OpenWrite);
349     if( onError==OE_Replace ){
350       openAll = 1;
351     }else{
352       openAll = 0;
353       for(pIdx=pTab->pIndex; pIdx; pIdx=pIdx->pNext){
354         if( pIdx->onError==OE_Replace ){
355           openAll = 1;
356           break;
357         }
358       }
359     }
360     for(i=0, pIdx=pTab->pIndex; pIdx; pIdx=pIdx->pNext, i++){
361       assert( aRegIdx );
362       if( openAll || aRegIdx[i]>0 ){
363         KeyInfo *pKey = sqlite3IndexKeyinfo(pParse, pIdx);
364         sqlite3VdbeAddOp4(v, OP_OpenWrite, iCur+i+1, pIdx->tnum, iDb,
365                        (char*)pKey, P4_KEYINFO_HANDOFF);
366         assert( pParse->nTab>iCur+i+1 );
367       }
368     }
369   }
370 
371   /* Top of the update loop */
372   if( okOnePass ){
373     int a1 = sqlite3VdbeAddOp1(v, OP_NotNull, regOldRowid);
374     addr = sqlite3VdbeAddOp0(v, OP_Goto);
375     sqlite3VdbeJumpHere(v, a1);
376   }else{
377     addr = sqlite3VdbeAddOp3(v, OP_RowSetRead, regRowSet, 0, regOldRowid);
378   }
379 
380   /* Make cursor iCur point to the record that is being updated. If
381   ** this record does not exist for some reason (deleted by a trigger,
382   ** for example, then jump to the next iteration of the RowSet loop.  */
383   sqlite3VdbeAddOp3(v, OP_NotExists, iCur, addr, regOldRowid);
384 
385   /* If the record number will change, set register regNewRowid to
386   ** contain the new value. If the record number is not being modified,
387   ** then regNewRowid is the same register as regOldRowid, which is
388   ** already populated.  */
389   assert( chngRowid || pTrigger || hasFK || regOldRowid==regNewRowid );
390   if( chngRowid ){
391     sqlite3ExprCode(pParse, pRowidExpr, regNewRowid);
392     sqlite3VdbeAddOp1(v, OP_MustBeInt, regNewRowid);
393   }
394 
395   /* If there are triggers on this table, populate an array of registers
396   ** with the required old.* column data.  */
397   if( hasFK || pTrigger ){
398     u32 oldmask = (hasFK ? sqlite3FkOldmask(pParse, pTab) : 0);
399     oldmask |= sqlite3TriggerColmask(pParse,
400         pTrigger, pChanges, 0, TRIGGER_BEFORE|TRIGGER_AFTER, pTab, onError
401     );
402     for(i=0; i<pTab->nCol; i++){
403       if( aXRef[i]<0 || oldmask==0xffffffff || (i<32 && (oldmask & (1<<i))) ){
404         sqlite3ExprCodeGetColumnOfTable(v, pTab, iCur, i, regOld+i);
405       }else{
406         sqlite3VdbeAddOp2(v, OP_Null, 0, regOld+i);
407       }
408     }
409     if( chngRowid==0 ){
410       sqlite3VdbeAddOp2(v, OP_Copy, regOldRowid, regNewRowid);
411     }
412   }
413 
414   /* Populate the array of registers beginning at regNew with the new
415   ** row data. This array is used to check constaints, create the new
416   ** table and index records, and as the values for any new.* references
417   ** made by triggers.
418   **
419   ** If there are one or more BEFORE triggers, then do not populate the
420   ** registers associated with columns that are (a) not modified by
421   ** this UPDATE statement and (b) not accessed by new.* references. The
422   ** values for registers not modified by the UPDATE must be reloaded from
423   ** the database after the BEFORE triggers are fired anyway (as the trigger
424   ** may have modified them). So not loading those that are not going to
425   ** be used eliminates some redundant opcodes.
426   */
427   newmask = sqlite3TriggerColmask(
428       pParse, pTrigger, pChanges, 1, TRIGGER_BEFORE, pTab, onError
429   );
430   sqlite3VdbeAddOp3(v, OP_Null, 0, regNew, regNew+pTab->nCol-1);
431   for(i=0; i<pTab->nCol; i++){
432     if( i==pTab->iPKey ){
433       /*sqlite3VdbeAddOp2(v, OP_Null, 0, regNew+i);*/
434     }else{
435       j = aXRef[i];
436       if( j>=0 ){
437         sqlite3ExprCode(pParse, pChanges->a[j].pExpr, regNew+i);
438       }else if( 0==(tmask&TRIGGER_BEFORE) || i>31 || (newmask&(1<<i)) ){
439         /* This branch loads the value of a column that will not be changed
440         ** into a register. This is done if there are no BEFORE triggers, or
441         ** if there are one or more BEFORE triggers that use this value via
442         ** a new.* reference in a trigger program.
443         */
444         testcase( i==31 );
445         testcase( i==32 );
446         sqlite3VdbeAddOp3(v, OP_Column, iCur, i, regNew+i);
447         sqlite3ColumnDefault(v, pTab, i, regNew+i);
448       }
449     }
450   }
451 
452   /* Fire any BEFORE UPDATE triggers. This happens before constraints are
453   ** verified. One could argue that this is wrong.
454   */
455   if( tmask&TRIGGER_BEFORE ){
456     sqlite3VdbeAddOp2(v, OP_Affinity, regNew, pTab->nCol);
457     sqlite3TableAffinityStr(v, pTab);
458     sqlite3CodeRowTrigger(pParse, pTrigger, TK_UPDATE, pChanges,
459         TRIGGER_BEFORE, pTab, regOldRowid, onError, addr);
460 
461     /* The row-trigger may have deleted the row being updated. In this
462     ** case, jump to the next row. No updates or AFTER triggers are
463     ** required. This behavior - what happens when the row being updated
464     ** is deleted or renamed by a BEFORE trigger - is left undefined in the
465     ** documentation.
466     */
467     sqlite3VdbeAddOp3(v, OP_NotExists, iCur, addr, regOldRowid);
468 
469     /* If it did not delete it, the row-trigger may still have modified
470     ** some of the columns of the row being updated. Load the values for
471     ** all columns not modified by the update statement into their
472     ** registers in case this has happened.
473     */
474     for(i=0; i<pTab->nCol; i++){
475       if( aXRef[i]<0 && i!=pTab->iPKey ){
476         sqlite3VdbeAddOp3(v, OP_Column, iCur, i, regNew+i);
477         sqlite3ColumnDefault(v, pTab, i, regNew+i);
478       }
479     }
480   }
481 
482   if( !isView ){
483     int j1;                       /* Address of jump instruction */
484 
485     /* Do constraint checks. */
486     sqlite3GenerateConstraintChecks(pParse, pTab, iCur, regNewRowid,
487         aRegIdx, (chngRowid?regOldRowid:0), 1, onError, addr, 0);
488 
489     /* Do FK constraint checks. */
490     if( hasFK ){
491       sqlite3FkCheck(pParse, pTab, regOldRowid, 0);
492     }
493 
494     /* Delete the index entries associated with the current record.  */
495     j1 = sqlite3VdbeAddOp3(v, OP_NotExists, iCur, 0, regOldRowid);
496     sqlite3GenerateRowIndexDelete(pParse, pTab, iCur, aRegIdx);
497 
498     /* If changing the record number, delete the old record.  */
499     if( hasFK || chngRowid ){
500       sqlite3VdbeAddOp2(v, OP_Delete, iCur, 0);
501     }
502     sqlite3VdbeJumpHere(v, j1);
503 
504     if( hasFK ){
505       sqlite3FkCheck(pParse, pTab, 0, regNewRowid);
506     }
507 
508     /* Insert the new index entries and the new record. */
509     sqlite3CompleteInsertion(pParse, pTab, iCur, regNewRowid, aRegIdx, 1, 0, 0);
510 
511     /* Do any ON CASCADE, SET NULL or SET DEFAULT operations required to
512     ** handle rows (possibly in other tables) that refer via a foreign key
513     ** to the row just updated. */
514     if( hasFK ){
515       sqlite3FkActions(pParse, pTab, pChanges, regOldRowid);
516     }
517   }
518 
519   /* Increment the row counter
520   */
521   if( (db->flags & SQLITE_CountRows) && !pParse->pTriggerTab){
522     sqlite3VdbeAddOp2(v, OP_AddImm, regRowCount, 1);
523   }
524 
525   sqlite3CodeRowTrigger(pParse, pTrigger, TK_UPDATE, pChanges,
526       TRIGGER_AFTER, pTab, regOldRowid, onError, addr);
527 
528   /* Repeat the above with the next record to be updated, until
529   ** all record selected by the WHERE clause have been updated.
530   */
531   sqlite3VdbeAddOp2(v, OP_Goto, 0, addr);
532   sqlite3VdbeJumpHere(v, addr);
533 
534   /* Close all tables */
535   for(i=0, pIdx=pTab->pIndex; pIdx; pIdx=pIdx->pNext, i++){
536     assert( aRegIdx );
537     if( openAll || aRegIdx[i]>0 ){
538       sqlite3VdbeAddOp2(v, OP_Close, iCur+i+1, 0);
539     }
540   }
541   sqlite3VdbeAddOp2(v, OP_Close, iCur, 0);
542 
543   /* Update the sqlite_sequence table by storing the content of the
544   ** maximum rowid counter values recorded while inserting into
545   ** autoincrement tables.
546   */
547   if( pParse->nested==0 && pParse->pTriggerTab==0 ){
548     sqlite3AutoincrementEnd(pParse);
549   }
550 
551   /*
552   ** Return the number of rows that were changed. If this routine is
553   ** generating code because of a call to sqlite3NestedParse(), do not
554   ** invoke the callback function.
555   */
556   if( (db->flags&SQLITE_CountRows) && !pParse->pTriggerTab && !pParse->nested ){
557     sqlite3VdbeAddOp2(v, OP_ResultRow, regRowCount, 1);
558     sqlite3VdbeSetNumCols(v, 1);
559     sqlite3VdbeSetColName(v, 0, COLNAME_NAME, "rows updated", SQLITE_STATIC);
560   }
561 
562 update_cleanup:
563   sqlite3AuthContextPop(&sContext);
564   sqlite3DbFree(db, aRegIdx);
565   sqlite3DbFree(db, aXRef);
566   sqlite3SrcListDelete(db, pTabList);
567   sqlite3ExprListDelete(db, pChanges);
568   sqlite3ExprDelete(db, pWhere);
569   return;
570 }
571 /* Make sure "isView" and other macros defined above are undefined. Otherwise
572 ** thely may interfere with compilation of other functions in this file
573 ** (or in another file, if this file becomes part of the amalgamation).  */
574 #ifdef isView
575  #undef isView
576 #endif
577 #ifdef pTrigger
578  #undef pTrigger
579 #endif
580 
581 #ifndef SQLITE_OMIT_VIRTUALTABLE
582 /*
583 ** Generate code for an UPDATE of a virtual table.
584 **
585 ** The strategy is that we create an ephemerial table that contains
586 ** for each row to be changed:
587 **
588 **   (A)  The original rowid of that row.
589 **   (B)  The revised rowid for the row. (note1)
590 **   (C)  The content of every column in the row.
591 **
592 ** Then we loop over this ephemeral table and for each row in
593 ** the ephermeral table call VUpdate.
594 **
595 ** When finished, drop the ephemeral table.
596 **
597 ** (note1) Actually, if we know in advance that (A) is always the same
598 ** as (B) we only store (A), then duplicate (A) when pulling
599 ** it out of the ephemeral table before calling VUpdate.
600 */
601 static void updateVirtualTable(
602   Parse *pParse,       /* The parsing context */
603   SrcList *pSrc,       /* The virtual table to be modified */
604   Table *pTab,         /* The virtual table */
605   ExprList *pChanges,  /* The columns to change in the UPDATE statement */
606   Expr *pRowid,        /* Expression used to recompute the rowid */
607   int *aXRef,          /* Mapping from columns of pTab to entries in pChanges */
608   Expr *pWhere,        /* WHERE clause of the UPDATE statement */
609   int onError          /* ON CONFLICT strategy */
610 ){
611   Vdbe *v = pParse->pVdbe;  /* Virtual machine under construction */
612   ExprList *pEList = 0;     /* The result set of the SELECT statement */
613   Select *pSelect = 0;      /* The SELECT statement */
614   Expr *pExpr;              /* Temporary expression */
615   int ephemTab;             /* Table holding the result of the SELECT */
616   int i;                    /* Loop counter */
617   int addr;                 /* Address of top of loop */
618   int iReg;                 /* First register in set passed to OP_VUpdate */
619   sqlite3 *db = pParse->db; /* Database connection */
620   const char *pVTab = (const char*)sqlite3GetVTable(db, pTab);
621   SelectDest dest;
622 
623   /* Construct the SELECT statement that will find the new values for
624   ** all updated rows.
625   */
626   pEList = sqlite3ExprListAppend(pParse, 0, sqlite3Expr(db, TK_ID, "_rowid_"));
627   if( pRowid ){
628     pEList = sqlite3ExprListAppend(pParse, pEList,
629                                    sqlite3ExprDup(db, pRowid, 0));
630   }
631   assert( pTab->iPKey<0 );
632   for(i=0; i<pTab->nCol; i++){
633     if( aXRef[i]>=0 ){
634       pExpr = sqlite3ExprDup(db, pChanges->a[aXRef[i]].pExpr, 0);
635     }else{
636       pExpr = sqlite3Expr(db, TK_ID, pTab->aCol[i].zName);
637     }
638     pEList = sqlite3ExprListAppend(pParse, pEList, pExpr);
639   }
640   pSelect = sqlite3SelectNew(pParse, pEList, pSrc, pWhere, 0, 0, 0, 0, 0, 0);
641 
642   /* Create the ephemeral table into which the update results will
643   ** be stored.
644   */
645   assert( v );
646   ephemTab = pParse->nTab++;
647   sqlite3VdbeAddOp2(v, OP_OpenEphemeral, ephemTab, pTab->nCol+1+(pRowid!=0));
648   sqlite3VdbeChangeP5(v, BTREE_UNORDERED);
649 
650   /* fill the ephemeral table
651   */
652   sqlite3SelectDestInit(&dest, SRT_Table, ephemTab);
653   sqlite3Select(pParse, pSelect, &dest);
654 
655   /* Generate code to scan the ephemeral table and call VUpdate. */
656   iReg = ++pParse->nMem;
657   pParse->nMem += pTab->nCol+1;
658   addr = sqlite3VdbeAddOp2(v, OP_Rewind, ephemTab, 0);
659   sqlite3VdbeAddOp3(v, OP_Column,  ephemTab, 0, iReg);
660   sqlite3VdbeAddOp3(v, OP_Column, ephemTab, (pRowid?1:0), iReg+1);
661   for(i=0; i<pTab->nCol; i++){
662     sqlite3VdbeAddOp3(v, OP_Column, ephemTab, i+1+(pRowid!=0), iReg+2+i);
663   }
664   sqlite3VtabMakeWritable(pParse, pTab);
665   sqlite3VdbeAddOp4(v, OP_VUpdate, 0, pTab->nCol+2, iReg, pVTab, P4_VTAB);
666   sqlite3VdbeChangeP5(v, onError==OE_Default ? OE_Abort : onError);
667   sqlite3MayAbort(pParse);
668   sqlite3VdbeAddOp2(v, OP_Next, ephemTab, addr+1);
669   sqlite3VdbeJumpHere(v, addr);
670   sqlite3VdbeAddOp2(v, OP_Close, ephemTab, 0);
671 
672   /* Cleanup */
673   sqlite3SelectDelete(db, pSelect);
674 }
675 #endif /* SQLITE_OMIT_VIRTUALTABLE */
676