/ Hex Artifact Content
Login

Artifact 30b9ba3c5906d711b4e5b2e532d7a1f419942a29:


0000: 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 5f 5f  .#if !defined(__
0010: 53 51 4c 49 54 45 53 45 53 53 49 4f 4e 5f 48 5f  SQLITESESSION_H_
0020: 29 20 26 26 20 64 65 66 69 6e 65 64 28 53 51 4c  ) && defined(SQL
0030: 49 54 45 5f 45 4e 41 42 4c 45 5f 53 45 53 53 49  ITE_ENABLE_SESSI
0040: 4f 4e 29 0a 23 64 65 66 69 6e 65 20 5f 5f 53 51  ON).#define __SQ
0050: 4c 49 54 45 53 45 53 53 49 4f 4e 5f 48 5f 20 31  LITESESSION_H_ 1
0060: 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72  ../*.** Make sur
0070: 65 20 77 65 20 63 61 6e 20 63 61 6c 6c 20 74 68  e we can call th
0080: 69 73 20 73 74 75 66 66 20 66 72 6f 6d 20 43 2b  is stuff from C+
0090: 2b 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 5f 5f 63  +..*/.#ifdef __c
00a0: 70 6c 75 73 70 6c 75 73 0a 65 78 74 65 72 6e 20  plusplus.extern 
00b0: 22 43 22 20 7b 0a 23 65 6e 64 69 66 0a 0a 23 69  "C" {.#endif..#i
00c0: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 33 2e  nclude "sqlite3.
00d0: 68 22 0a 0a 2f 2a 0a 2a 2a 20 43 41 50 49 33 52  h"../*.** CAPI3R
00e0: 45 46 3a 20 53 65 73 73 69 6f 6e 20 4f 62 6a 65  EF: Session Obje
00f0: 63 74 20 48 61 6e 64 6c 65 0a 2a 2f 0a 74 79 70  ct Handle.*/.typ
0100: 65 64 65 66 20 73 74 72 75 63 74 20 73 71 6c 69  edef struct sqli
0110: 74 65 33 5f 73 65 73 73 69 6f 6e 20 73 71 6c 69  te3_session sqli
0120: 74 65 33 5f 73 65 73 73 69 6f 6e 3b 0a 0a 2f 2a  te3_session;../*
0130: 0a 2a 2a 20 43 41 50 49 33 52 45 46 3a 20 43 68  .** CAPI3REF: Ch
0140: 61 6e 67 65 73 65 74 20 49 74 65 72 61 74 6f 72  angeset Iterator
0150: 20 48 61 6e 64 6c 65 0a 2a 2f 0a 74 79 70 65 64   Handle.*/.typed
0160: 65 66 20 73 74 72 75 63 74 20 73 71 6c 69 74 65  ef struct sqlite
0170: 33 5f 63 68 61 6e 67 65 73 65 74 5f 69 74 65 72  3_changeset_iter
0180: 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73   sqlite3_changes
0190: 65 74 5f 69 74 65 72 3b 0a 0a 2f 2a 0a 2a 2a 20  et_iter;../*.** 
01a0: 43 41 50 49 33 52 45 46 3a 20 43 72 65 61 74 65  CAPI3REF: Create
01b0: 20 41 20 4e 65 77 20 53 65 73 73 69 6f 6e 20 4f   A New Session O
01c0: 62 6a 65 63 74 0a 2a 2a 0a 2a 2a 20 43 72 65 61  bject.**.** Crea
01d0: 74 65 20 61 20 6e 65 77 20 73 65 73 73 69 6f 6e  te a new session
01e0: 20 6f 62 6a 65 63 74 20 61 74 74 61 63 68 65 64   object attached
01f0: 20 74 6f 20 64 61 74 61 62 61 73 65 20 68 61 6e   to database han
0200: 64 6c 65 20 64 62 2e 20 49 66 20 73 75 63 63 65  dle db. If succe
0210: 73 73 66 75 6c 2c 0a 2a 2a 20 61 20 70 6f 69 6e  ssful,.** a poin
0220: 74 65 72 20 74 6f 20 74 68 65 20 6e 65 77 20 6f  ter to the new o
0230: 62 6a 65 63 74 20 69 73 20 77 72 69 74 74 65 6e  bject is written
0240: 20 74 6f 20 2a 70 70 53 65 73 73 69 6f 6e 20 61   to *ppSession a
0250: 6e 64 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 0a  nd SQLITE_OK is.
0260: 2a 2a 20 72 65 74 75 72 6e 65 64 2e 20 49 66 20  ** returned. If 
0270: 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c  an error occurs,
0280: 20 2a 70 70 53 65 73 73 69 6f 6e 20 69 73 20 73   *ppSession is s
0290: 65 74 20 74 6f 20 4e 55 4c 4c 20 61 6e 64 20 61  et to NULL and a
02a0: 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 65 72 72 6f  n SQLite.** erro
02b0: 72 20 63 6f 64 65 20 28 65 2e 67 2e 20 53 51 4c  r code (e.g. SQL
02c0: 49 54 45 5f 4e 4f 4d 45 4d 29 20 69 73 20 72 65  ITE_NOMEM) is re
02d0: 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 74  turned..**.** It
02e0: 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20   is possible to 
02f0: 63 72 65 61 74 65 20 6d 75 6c 74 69 70 6c 65 20  create multiple 
0300: 73 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 73 20  session objects 
0310: 61 74 74 61 63 68 65 64 20 74 6f 20 61 20 73 69  attached to a si
0320: 6e 67 6c 65 0a 2a 2a 20 64 61 74 61 62 61 73 65  ngle.** database
0330: 20 68 61 6e 64 6c 65 2e 0a 2a 2a 0a 2a 2a 20 53   handle..**.** S
0340: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 73 20 63  ession objects c
0350: 72 65 61 74 65 64 20 75 73 69 6e 67 20 74 68 69  reated using thi
0360: 73 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c  s function shoul
0370: 64 20 62 65 20 64 65 6c 65 74 65 64 20 75 73 69  d be deleted usi
0380: 6e 67 20 74 68 65 0a 2a 2a 20 5b 73 71 6c 69 74  ng the.** [sqlit
0390: 65 33 73 65 73 73 69 6f 6e 5f 64 65 6c 65 74 65  e3session_delete
03a0: 28 29 5d 20 66 75 6e 63 74 69 6f 6e 20 62 65 66  ()] function bef
03b0: 6f 72 65 20 74 68 65 20 64 61 74 61 62 61 73 65  ore the database
03c0: 20 68 61 6e 64 6c 65 20 74 68 61 74 20 74 68 65   handle that the
03d0: 79 0a 2a 2a 20 61 72 65 20 61 74 74 61 63 68 65  y.** are attache
03e0: 64 20 74 6f 20 69 73 20 69 74 73 65 6c 66 20 63  d to is itself c
03f0: 6c 6f 73 65 64 2e 20 49 66 20 74 68 65 20 64 61  losed. If the da
0400: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 69 73  tabase handle is
0410: 20 63 6c 6f 73 65 64 20 62 65 66 6f 72 65 0a 2a   closed before.*
0420: 2a 20 74 68 65 20 73 65 73 73 69 6f 6e 20 6f 62  * the session ob
0430: 6a 65 63 74 20 69 73 20 64 65 6c 65 74 65 64 2c  ject is deleted,
0440: 20 74 68 65 6e 20 74 68 65 20 72 65 73 75 6c 74   then the result
0450: 73 20 6f 66 20 63 61 6c 6c 69 6e 67 20 61 6e 79  s of calling any
0460: 20 73 65 73 73 69 6f 6e 0a 2a 2a 20 6d 6f 64 75   session.** modu
0470: 6c 65 20 66 75 6e 63 74 69 6f 6e 2c 20 69 6e 63  le function, inc
0480: 6c 75 64 69 6e 67 20 5b 73 71 6c 69 74 65 33 73  luding [sqlite3s
0490: 65 73 73 69 6f 6e 5f 64 65 6c 65 74 65 28 29 5d  ession_delete()]
04a0: 20 6f 6e 20 74 68 65 20 73 65 73 73 69 6f 6e 20   on the session 
04b0: 6f 62 6a 65 63 74 0a 2a 2a 20 61 72 65 20 75 6e  object.** are un
04c0: 64 65 66 69 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 42  defined..**.** B
04d0: 65 63 61 75 73 65 20 74 68 65 20 73 65 73 73 69  ecause the sessi
04e0: 6f 6e 20 6d 6f 64 75 6c 65 20 75 73 65 73 20 74  on module uses t
04f0: 68 65 20 5b 73 71 6c 69 74 65 33 5f 70 72 65 75  he [sqlite3_preu
0500: 70 64 61 74 65 5f 68 6f 6f 6b 28 29 5d 20 41 50  pdate_hook()] AP
0510: 49 2c 20 69 74 0a 2a 2a 20 69 73 20 6e 6f 74 20  I, it.** is not 
0520: 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 61 6e 20  possible for an 
0530: 61 70 70 6c 69 63 61 74 69 6f 6e 20 74 6f 20 72  application to r
0540: 65 67 69 73 74 65 72 20 61 20 70 72 65 2d 75 70  egister a pre-up
0550: 64 61 74 65 20 68 6f 6f 6b 20 6f 6e 20 61 0a 2a  date hook on a.*
0560: 2a 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c  * database handl
0570: 65 20 74 68 61 74 20 68 61 73 20 6f 6e 65 20 6f  e that has one o
0580: 72 20 6d 6f 72 65 20 73 65 73 73 69 6f 6e 20 6f  r more session o
0590: 62 6a 65 63 74 73 20 61 74 74 61 63 68 65 64 2e  bjects attached.
05a0: 20 4e 6f 72 20 69 73 0a 2a 2a 20 69 74 20 70 6f   Nor is.** it po
05b0: 73 73 69 62 6c 65 20 74 6f 20 63 72 65 61 74 65  ssible to create
05c0: 20 61 20 73 65 73 73 69 6f 6e 20 6f 62 6a 65 63   a session objec
05d0: 74 20 61 74 74 61 63 68 65 64 20 74 6f 20 61 20  t attached to a 
05e0: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20  database handle 
05f0: 66 6f 72 0a 2a 2a 20 77 68 69 63 68 20 61 20 70  for.** which a p
0600: 72 65 2d 75 70 64 61 74 65 20 68 6f 6f 6b 20 69  re-update hook i
0610: 73 20 61 6c 72 65 61 64 79 20 64 65 66 69 6e 65  s already define
0620: 64 2e 20 54 68 65 20 72 65 73 75 6c 74 73 20 6f  d. The results o
0630: 66 20 61 74 74 65 6d 70 74 69 6e 67 20 0a 2a 2a  f attempting .**
0640: 20 65 69 74 68 65 72 20 6f 66 20 74 68 65 73 65   either of these
0650: 20 74 68 69 6e 67 73 20 61 72 65 20 75 6e 64 65   things are unde
0660: 66 69 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  fined..**.** The
0670: 20 73 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20   session object 
0680: 77 69 6c 6c 20 62 65 20 75 73 65 64 20 74 6f 20  will be used to 
0690: 63 72 65 61 74 65 20 63 68 61 6e 67 65 73 65 74  create changeset
06a0: 73 20 66 6f 72 20 74 61 62 6c 65 73 20 69 6e 0a  s for tables in.
06b0: 2a 2a 20 64 61 74 61 62 61 73 65 20 7a 44 62 2c  ** database zDb,
06c0: 20 77 68 65 72 65 20 7a 44 62 20 69 73 20 65 69   where zDb is ei
06d0: 74 68 65 72 20 22 6d 61 69 6e 22 2c 20 6f 72 20  ther "main", or 
06e0: 22 74 65 6d 70 22 2c 20 6f 72 20 74 68 65 20 6e  "temp", or the n
06f0: 61 6d 65 20 6f 66 20 61 6e 0a 2a 2a 20 61 74 74  ame of an.** att
0700: 61 63 68 65 64 20 64 61 74 61 62 61 73 65 2e 20  ached database. 
0710: 49 74 20 69 73 20 6e 6f 74 20 61 6e 20 65 72 72  It is not an err
0720: 6f 72 20 69 66 20 64 61 74 61 62 61 73 65 20 7a  or if database z
0730: 44 62 20 69 73 20 6e 6f 74 20 61 74 74 61 63 68  Db is not attach
0740: 65 64 0a 2a 2a 20 74 6f 20 74 68 65 20 64 61 74  ed.** to the dat
0750: 61 62 61 73 65 20 77 68 65 6e 20 74 68 65 20 73  abase when the s
0760: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 69 73  ession object is
0770: 20 63 72 65 61 74 65 64 2e 0a 2a 2f 0a 69 6e 74   created..*/.int
0780: 20 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f   sqlite3session_
0790: 63 72 65 61 74 65 28 0a 20 20 73 71 6c 69 74 65  create(.  sqlite
07a0: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  3 *db,          
07b0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74            /* Dat
07c0: 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a  abase handle */.
07d0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44    const char *zD
07e0: 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  b,              
07f0: 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 64 62 20    /* Name of db 
0800: 28 65 2e 67 2e 20 22 6d 61 69 6e 22 29 20 2a 2f  (e.g. "main") */
0810: 0a 20 20 73 71 6c 69 74 65 33 5f 73 65 73 73 69  .  sqlite3_sessi
0820: 6f 6e 20 2a 2a 70 70 53 65 73 73 69 6f 6e 20 20  on **ppSession  
0830: 20 20 20 2f 2a 20 4f 55 54 3a 20 4e 65 77 20 73     /* OUT: New s
0840: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 2a 2f  ession object */
0850: 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 43 41 50 49 33  .);../*.** CAPI3
0860: 52 45 46 3a 20 44 65 6c 65 74 65 20 41 20 53 65  REF: Delete A Se
0870: 73 73 69 6f 6e 20 4f 62 6a 65 63 74 0a 2a 2a 0a  ssion Object.**.
0880: 2a 2a 20 44 65 6c 65 74 65 20 61 20 73 65 73 73  ** Delete a sess
0890: 69 6f 6e 20 6f 62 6a 65 63 74 20 70 72 65 76 69  ion object previ
08a0: 6f 75 73 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20  ously allocated 
08b0: 75 73 69 6e 67 20 0a 2a 2a 20 5b 73 71 6c 69 74  using .** [sqlit
08c0: 65 33 73 65 73 73 69 6f 6e 5f 63 72 65 61 74 65  e3session_create
08d0: 28 29 5d 2e 20 4f 6e 63 65 20 61 20 73 65 73 73  ()]. Once a sess
08e0: 69 6f 6e 20 6f 62 6a 65 63 74 20 68 61 73 20 62  ion object has b
08f0: 65 65 6e 20 64 65 6c 65 74 65 64 2c 20 74 68 65  een deleted, the
0900: 0a 2a 2a 20 72 65 73 75 6c 74 73 20 6f 66 20 61  .** results of a
0910: 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 75 73 65  ttempting to use
0920: 20 70 53 65 73 73 69 6f 6e 20 77 69 74 68 20 61   pSession with a
0930: 6e 79 20 6f 74 68 65 72 20 73 65 73 73 69 6f 6e  ny other session
0940: 20 6d 6f 64 75 6c 65 0a 2a 2a 20 66 75 6e 63 74   module.** funct
0950: 69 6f 6e 20 61 72 65 20 75 6e 64 65 66 69 6e 65  ion are undefine
0960: 64 2e 0a 2a 2a 0a 2a 2a 20 53 65 73 73 69 6f 6e  d..**.** Session
0970: 20 6f 62 6a 65 63 74 73 20 6d 75 73 74 20 62 65   objects must be
0980: 20 64 65 6c 65 74 65 64 20 62 65 66 6f 72 65 20   deleted before 
0990: 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e  the database han
09a0: 64 6c 65 20 74 6f 20 77 68 69 63 68 20 74 68 65  dle to which the
09b0: 79 0a 2a 2a 20 61 72 65 20 61 74 74 61 63 68 65  y.** are attache
09c0: 64 20 69 73 20 63 6c 6f 73 65 64 2e 20 52 65 66  d is closed. Ref
09d0: 65 72 20 74 6f 20 74 68 65 20 64 6f 63 75 6d 65  er to the docume
09e0: 6e 74 61 74 69 6f 6e 20 66 6f 72 20 0a 2a 2a 20  ntation for .** 
09f0: 5b 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f  [sqlite3session_
0a00: 63 72 65 61 74 65 28 29 5d 20 66 6f 72 20 64 65  create()] for de
0a10: 74 61 69 6c 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73  tails..*/.void s
0a20: 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 64 65  qlite3session_de
0a30: 6c 65 74 65 28 73 71 6c 69 74 65 33 5f 73 65 73  lete(sqlite3_ses
0a40: 73 69 6f 6e 20 2a 70 53 65 73 73 69 6f 6e 29 3b  sion *pSession);
0a50: 0a 0a 0a 2f 2a 0a 2a 2a 20 43 41 50 49 33 52 45  .../*.** CAPI3RE
0a60: 46 3a 20 45 6e 61 62 6c 65 20 4f 72 20 44 69 73  F: Enable Or Dis
0a70: 61 62 6c 65 20 41 20 53 65 73 73 69 6f 6e 20 4f  able A Session O
0a80: 62 6a 65 63 74 0a 2a 2a 0a 2a 2a 20 45 6e 61 62  bject.**.** Enab
0a90: 6c 65 20 6f 72 20 64 69 73 61 62 6c 65 20 74 68  le or disable th
0aa0: 65 20 72 65 63 6f 72 64 69 6e 67 20 6f 66 20 63  e recording of c
0ab0: 68 61 6e 67 65 73 20 62 79 20 61 20 73 65 73 73  hanges by a sess
0ac0: 69 6f 6e 20 6f 62 6a 65 63 74 2e 20 57 68 65 6e  ion object. When
0ad0: 0a 2a 2a 20 65 6e 61 62 6c 65 64 2c 20 61 20 73  .** enabled, a s
0ae0: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 72 65  ession object re
0af0: 63 6f 72 64 73 20 63 68 61 6e 67 65 73 20 6d 61  cords changes ma
0b00: 64 65 20 74 6f 20 74 68 65 20 64 61 74 61 62 61  de to the databa
0b10: 73 65 2e 20 57 68 65 6e 0a 2a 2a 20 64 69 73 61  se. When.** disa
0b20: 62 6c 65 64 20 2d 20 69 74 20 64 6f 65 73 20 6e  bled - it does n
0b30: 6f 74 2e 20 41 20 6e 65 77 6c 79 20 63 72 65 61  ot. A newly crea
0b40: 74 65 64 20 73 65 73 73 69 6f 6e 20 6f 62 6a 65  ted session obje
0b50: 63 74 20 69 73 20 65 6e 61 62 6c 65 64 2e 0a 2a  ct is enabled..*
0b60: 2a 20 52 65 66 65 72 20 74 6f 20 74 68 65 20 64  * Refer to the d
0b70: 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72  ocumentation for
0b80: 20 5b 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e   [sqlite3session
0b90: 5f 63 68 61 6e 67 65 73 65 74 28 29 5d 20 66 6f  _changeset()] fo
0ba0: 72 20 66 75 72 74 68 65 72 0a 2a 2a 20 64 65 74  r further.** det
0bb0: 61 69 6c 73 20 72 65 67 61 72 64 69 6e 67 20 68  ails regarding h
0bc0: 6f 77 20 65 6e 61 62 6c 69 6e 67 20 61 6e 64 20  ow enabling and 
0bd0: 64 69 73 61 62 6c 69 6e 67 20 61 20 73 65 73 73  disabling a sess
0be0: 69 6f 6e 20 6f 62 6a 65 63 74 20 61 66 66 65 63  ion object affec
0bf0: 74 73 0a 2a 2a 20 74 68 65 20 65 76 65 6e 74 75  ts.** the eventu
0c00: 61 6c 20 63 68 61 6e 67 65 73 65 74 73 2e 0a 2a  al changesets..*
0c10: 2a 0a 2a 2a 20 50 61 73 73 69 6e 67 20 7a 65 72  *.** Passing zer
0c20: 6f 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69  o to this functi
0c30: 6f 6e 20 64 69 73 61 62 6c 65 73 20 74 68 65 20  on disables the 
0c40: 73 65 73 73 69 6f 6e 2e 20 50 61 73 73 69 6e 67  session. Passing
0c50: 20 61 20 76 61 6c 75 65 0a 2a 2a 20 67 72 65 61   a value.** grea
0c60: 74 65 72 20 74 68 61 6e 20 7a 65 72 6f 20 65 6e  ter than zero en
0c70: 61 62 6c 65 73 20 69 74 2e 20 50 61 73 73 69 6e  ables it. Passin
0c80: 67 20 61 20 76 61 6c 75 65 20 6c 65 73 73 20 74  g a value less t
0c90: 68 61 6e 20 7a 65 72 6f 20 69 73 20 61 20 0a 2a  han zero is a .*
0ca0: 2a 20 6e 6f 2d 6f 70 2c 20 61 6e 64 20 6d 61 79  * no-op, and may
0cb0: 20 62 65 20 75 73 65 64 20 74 6f 20 71 75 65 72   be used to quer
0cc0: 79 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 74  y the current st
0cd0: 61 74 65 20 6f 66 20 74 68 65 20 73 65 73 73 69  ate of the sessi
0ce0: 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 72 65  on..**.** The re
0cf0: 74 75 72 6e 20 76 61 6c 75 65 20 69 6e 64 69 63  turn value indic
0d00: 61 74 65 73 20 74 68 65 20 66 69 6e 61 6c 20 73  ates the final s
0d10: 74 61 74 65 20 6f 66 20 74 68 65 20 73 65 73 73  tate of the sess
0d20: 69 6f 6e 20 6f 62 6a 65 63 74 3a 20 30 20 69 66  ion object: 0 if
0d30: 20 0a 2a 2a 20 74 68 65 20 73 65 73 73 69 6f 6e   .** the session
0d40: 20 69 73 20 64 69 73 61 62 6c 65 64 2c 20 6f 72   is disabled, or
0d50: 20 31 20 69 66 20 69 74 20 69 73 20 65 6e 61 62   1 if it is enab
0d60: 6c 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  led..*/.int sqli
0d70: 74 65 33 73 65 73 73 69 6f 6e 5f 65 6e 61 62 6c  te3session_enabl
0d80: 65 28 73 71 6c 69 74 65 33 5f 73 65 73 73 69 6f  e(sqlite3_sessio
0d90: 6e 20 2a 70 53 65 73 73 69 6f 6e 2c 20 69 6e 74  n *pSession, int
0da0: 20 62 45 6e 61 62 6c 65 29 3b 0a 0a 2f 2a 0a 2a   bEnable);../*.*
0db0: 2a 20 43 41 50 49 33 52 45 46 3a 20 53 65 74 20  * CAPI3REF: Set 
0dc0: 4f 72 20 43 6c 65 61 72 20 74 68 65 20 49 6e 64  Or Clear the Ind
0dd0: 69 72 65 63 74 20 43 68 61 6e 67 65 20 46 6c 61  irect Change Fla
0de0: 67 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 63 68 61  g.**.** Each cha
0df0: 6e 67 65 20 72 65 63 6f 72 64 65 64 20 62 79 20  nge recorded by 
0e00: 61 20 73 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74  a session object
0e10: 20 69 73 20 6d 61 72 6b 65 64 20 61 73 20 65 69   is marked as ei
0e20: 74 68 65 72 20 64 69 72 65 63 74 20 6f 72 0a 2a  ther direct or.*
0e30: 2a 20 69 6e 64 69 72 65 63 74 2e 20 41 20 63 68  * indirect. A ch
0e40: 61 6e 67 65 20 69 73 20 6d 61 72 6b 65 64 20 61  ange is marked a
0e50: 73 20 69 6e 64 69 72 65 63 74 20 69 66 20 65 69  s indirect if ei
0e60: 74 68 65 72 3a 0a 2a 2a 0a 2a 2a 20 3c 75 6c 3e  ther:.**.** <ul>
0e70: 0a 2a 2a 20 20 20 3c 6c 69 3e 20 54 68 65 20 73  .**   <li> The s
0e80: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 22 69  ession object "i
0e90: 6e 64 69 72 65 63 74 22 20 66 6c 61 67 20 69 73  ndirect" flag is
0ea0: 20 73 65 74 20 77 68 65 6e 20 74 68 65 20 63 68   set when the ch
0eb0: 61 6e 67 65 20 69 73 0a 2a 2a 20 20 20 20 20 20  ange is.**      
0ec0: 20 20 6d 61 64 65 2c 20 6f 72 0a 2a 2a 20 20 20    made, or.**   
0ed0: 3c 6c 69 3e 20 54 68 65 20 63 68 61 6e 67 65 20  <li> The change 
0ee0: 69 73 20 6d 61 64 65 20 62 79 20 61 6e 20 53 51  is made by an SQ
0ef0: 4c 20 74 72 69 67 67 65 72 20 6f 72 20 66 6f 72  L trigger or for
0f00: 65 69 67 6e 20 6b 65 79 20 61 63 74 69 6f 6e 20  eign key action 
0f10: 0a 2a 2a 20 20 20 20 20 20 20 20 69 6e 73 74 65  .**        inste
0f20: 61 64 20 6f 66 20 64 69 72 65 63 74 6c 79 20 61  ad of directly a
0f30: 73 20 61 20 72 65 73 75 6c 74 20 6f 66 20 61 20  s a result of a 
0f40: 75 73 65 72 73 20 53 51 4c 20 73 74 61 74 65 6d  users SQL statem
0f50: 65 6e 74 2e 0a 2a 2a 20 3c 2f 75 6c 3e 0a 2a 2a  ent..** </ul>.**
0f60: 0a 2a 2a 20 49 66 20 61 20 73 69 6e 67 6c 65 20  .** If a single 
0f70: 72 6f 77 20 69 73 20 61 66 66 65 63 74 65 64 20  row is affected 
0f80: 62 79 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65  by more than one
0f90: 20 6f 70 65 72 61 74 69 6f 6e 20 77 69 74 68 69   operation withi
0fa0: 6e 20 61 20 73 65 73 73 69 6f 6e 2c 0a 2a 2a 20  n a session,.** 
0fb0: 74 68 65 6e 20 74 68 65 20 63 68 61 6e 67 65 20  then the change 
0fc0: 69 73 20 63 6f 6e 73 69 64 65 72 65 64 20 69 6e  is considered in
0fd0: 64 69 72 65 63 74 20 69 66 20 61 6c 6c 20 6f 70  direct if all op
0fe0: 65 72 61 74 69 6f 6e 73 20 6d 65 65 74 20 74 68  erations meet th
0ff0: 65 20 63 72 69 74 65 72 69 61 0a 2a 2a 20 66 6f  e criteria.** fo
1000: 72 20 61 6e 20 69 6e 64 69 72 65 63 74 20 63 68  r an indirect ch
1010: 61 6e 67 65 20 61 62 6f 76 65 2c 20 6f 72 20 64  ange above, or d
1020: 69 72 65 63 74 20 6f 74 68 65 72 77 69 73 65 2e  irect otherwise.
1030: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  .**.** This func
1040: 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20  tion is used to 
1050: 73 65 74 2c 20 63 6c 65 61 72 20 6f 72 20 71 75  set, clear or qu
1060: 65 72 79 20 74 68 65 20 73 65 73 73 69 6f 6e 20  ery the session 
1070: 6f 62 6a 65 63 74 20 69 6e 64 69 72 65 63 74 0a  object indirect.
1080: 2a 2a 20 66 6c 61 67 2e 20 20 49 66 20 74 68 65  ** flag.  If the
1090: 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74   second argument
10a0: 20 70 61 73 73 65 64 20 74 6f 20 74 68 69 73 20   passed to this 
10b0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 7a 65 72 6f  function is zero
10c0: 2c 20 74 68 65 6e 20 74 68 65 0a 2a 2a 20 69 6e  , then the.** in
10d0: 64 69 72 65 63 74 20 66 6c 61 67 20 69 73 20 63  direct flag is c
10e0: 6c 65 61 72 65 64 2e 20 49 66 20 69 74 20 69 73  leared. If it is
10f0: 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 7a 65   greater than ze
1100: 72 6f 2c 20 74 68 65 20 69 6e 64 69 72 65 63 74  ro, the indirect
1110: 20 66 6c 61 67 0a 2a 2a 20 69 73 20 73 65 74 2e   flag.** is set.
1120: 20 50 61 73 73 69 6e 67 20 61 20 76 61 6c 75 65   Passing a value
1130: 20 6c 65 73 73 20 74 68 61 6e 20 7a 65 72 6f 20   less than zero 
1140: 64 6f 65 73 20 6e 6f 74 20 6d 6f 64 69 66 79 20  does not modify 
1150: 74 68 65 20 63 75 72 72 65 6e 74 20 76 61 6c 75  the current valu
1160: 65 0a 2a 2a 20 6f 66 20 74 68 65 20 69 6e 64 69  e.** of the indi
1170: 72 65 63 74 20 66 6c 61 67 2c 20 61 6e 64 20 6d  rect flag, and m
1180: 61 79 20 62 65 20 75 73 65 64 20 74 6f 20 71 75  ay be used to qu
1190: 65 72 79 20 74 68 65 20 63 75 72 72 65 6e 74 20  ery the current 
11a0: 73 74 61 74 65 20 6f 66 20 74 68 65 20 0a 2a 2a  state of the .**
11b0: 20 69 6e 64 69 72 65 63 74 20 66 6c 61 67 20 66   indirect flag f
11c0: 6f 72 20 74 68 65 20 73 70 65 63 69 66 69 65 64  or the specified
11d0: 20 73 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 2e   session object.
11e0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 72 65 74 75 72  .**.** The retur
11f0: 6e 20 76 61 6c 75 65 20 69 6e 64 69 63 61 74 65  n value indicate
1200: 73 20 74 68 65 20 66 69 6e 61 6c 20 73 74 61 74  s the final stat
1210: 65 20 6f 66 20 74 68 65 20 69 6e 64 69 72 65 63  e of the indirec
1220: 74 20 66 6c 61 67 3a 20 30 20 69 66 20 0a 2a 2a  t flag: 0 if .**
1230: 20 69 74 20 69 73 20 63 6c 65 61 72 2c 20 6f 72   it is clear, or
1240: 20 31 20 69 66 20 69 74 20 69 73 20 73 65 74 2e   1 if it is set.
1250: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 73  .*/.int sqlite3s
1260: 65 73 73 69 6f 6e 5f 69 6e 64 69 72 65 63 74 28  ession_indirect(
1270: 73 71 6c 69 74 65 33 5f 73 65 73 73 69 6f 6e 20  sqlite3_session 
1280: 2a 70 53 65 73 73 69 6f 6e 2c 20 69 6e 74 20 62  *pSession, int b
1290: 49 6e 64 69 72 65 63 74 29 3b 0a 0a 2f 2a 0a 2a  Indirect);../*.*
12a0: 2a 20 43 41 50 49 33 52 45 46 3a 20 41 74 74 61  * CAPI3REF: Atta
12b0: 63 68 20 41 20 54 61 62 6c 65 20 54 6f 20 41 20  ch A Table To A 
12c0: 53 65 73 73 69 6f 6e 20 4f 62 6a 65 63 74 0a 2a  Session Object.*
12d0: 2a 0a 2a 2a 20 49 66 20 61 72 67 75 6d 65 6e 74  *.** If argument
12e0: 20 7a 54 61 62 20 69 73 20 6e 6f 74 20 4e 55 4c   zTab is not NUL
12f0: 4c 2c 20 74 68 65 6e 20 69 74 20 69 73 20 74 68  L, then it is th
1300: 65 20 6e 61 6d 65 20 6f 66 20 61 20 74 61 62 6c  e name of a tabl
1310: 65 20 74 6f 20 61 74 74 61 63 68 0a 2a 2a 20 74  e to attach.** t
1320: 6f 20 74 68 65 20 73 65 73 73 69 6f 6e 20 6f 62  o the session ob
1330: 6a 65 63 74 20 70 61 73 73 65 64 20 61 73 20 74  ject passed as t
1340: 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e  he first argumen
1350: 74 2e 20 41 6c 6c 20 73 75 62 73 65 71 75 65 6e  t. All subsequen
1360: 74 20 63 68 61 6e 67 65 73 20 0a 2a 2a 20 6d 61  t changes .** ma
1370: 64 65 20 74 6f 20 74 68 65 20 74 61 62 6c 65 20  de to the table 
1380: 77 68 69 6c 65 20 74 68 65 20 73 65 73 73 69 6f  while the sessio
1390: 6e 20 6f 62 6a 65 63 74 20 69 73 20 65 6e 61 62  n object is enab
13a0: 6c 65 64 20 77 69 6c 6c 20 62 65 20 72 65 63 6f  led will be reco
13b0: 72 64 65 64 2e 20 53 65 65 20 0a 2a 2a 20 64 6f  rded. See .** do
13c0: 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20  cumentation for 
13d0: 5b 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f  [sqlite3session_
13e0: 63 68 61 6e 67 65 73 65 74 28 29 5d 20 66 6f 72  changeset()] for
13f0: 20 66 75 72 74 68 65 72 20 64 65 74 61 69 6c 73   further details
1400: 2e 0a 2a 2a 0a 2a 2a 20 4f 72 2c 20 69 66 20 61  ..**.** Or, if a
1410: 72 67 75 6d 65 6e 74 20 7a 54 61 62 20 69 73 20  rgument zTab is 
1420: 4e 55 4c 4c 2c 20 74 68 65 6e 20 63 68 61 6e 67  NULL, then chang
1430: 65 73 20 61 72 65 20 72 65 63 6f 72 64 65 64 20  es are recorded 
1440: 66 6f 72 20 61 6c 6c 20 74 61 62 6c 65 73 0a 2a  for all tables.*
1450: 2a 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73  * in the databas
1460: 65 2e 20 49 66 20 61 64 64 69 74 69 6f 6e 61 6c  e. If additional
1470: 20 74 61 62 6c 65 73 20 61 72 65 20 61 64 64 65   tables are adde
1480: 64 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73  d to the databas
1490: 65 20 28 62 79 20 0a 2a 2a 20 65 78 65 63 75 74  e (by .** execut
14a0: 69 6e 67 20 22 43 52 45 41 54 45 20 54 41 42 4c  ing "CREATE TABL
14b0: 45 22 20 73 74 61 74 65 6d 65 6e 74 73 29 20 61  E" statements) a
14c0: 66 74 65 72 20 74 68 69 73 20 63 61 6c 6c 20 69  fter this call i
14d0: 73 20 6d 61 64 65 2c 20 63 68 61 6e 67 65 73 20  s made, changes 
14e0: 66 6f 72 20 0a 2a 2a 20 74 68 65 20 6e 65 77 20  for .** the new 
14f0: 74 61 62 6c 65 73 20 61 72 65 20 61 6c 73 6f 20  tables are also 
1500: 72 65 63 6f 72 64 65 64 2e 0a 2a 2a 0a 2a 2a 20  recorded..**.** 
1510: 43 68 61 6e 67 65 73 20 63 61 6e 20 6f 6e 6c 79  Changes can only
1520: 20 62 65 20 72 65 63 6f 72 64 65 64 20 66 6f 72   be recorded for
1530: 20 74 61 62 6c 65 73 20 74 68 61 74 20 68 61 76   tables that hav
1540: 65 20 61 20 50 52 49 4d 41 52 59 20 4b 45 59 20  e a PRIMARY KEY 
1550: 65 78 70 6c 69 63 69 74 6c 79 0a 2a 2a 20 64 65  explicitly.** de
1560: 66 69 6e 65 64 20 61 73 20 70 61 72 74 20 6f 66  fined as part of
1570: 20 74 68 65 69 72 20 43 52 45 41 54 45 20 54 41   their CREATE TA
1580: 42 4c 45 20 73 74 61 74 65 6d 65 6e 74 2e 20 49  BLE statement. I
1590: 74 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 74 65  t does not matte
15a0: 72 20 69 66 20 74 68 65 20 0a 2a 2a 20 50 52 49  r if the .** PRI
15b0: 4d 41 52 59 20 4b 45 59 20 69 73 20 61 6e 20 22  MARY KEY is an "
15c0: 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 20  INTEGER PRIMARY 
15d0: 4b 45 59 22 20 28 72 6f 77 69 64 20 61 6c 69 61  KEY" (rowid alia
15e0: 73 29 20 6f 72 20 6e 6f 74 2e 20 54 68 65 20 50  s) or not. The P
15f0: 52 49 4d 41 52 59 0a 2a 2a 20 4b 45 59 20 6d 61  RIMARY.** KEY ma
1600: 79 20 63 6f 6e 73 69 73 74 20 6f 66 20 61 20 73  y consist of a s
1610: 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 2c 20 6f 72  ingle column, or
1620: 20 6d 61 79 20 62 65 20 61 20 63 6f 6d 70 6f 73   may be a compos
1630: 69 74 65 20 6b 65 79 2e 0a 2a 2a 20 0a 2a 2a 20  ite key..** .** 
1640: 49 74 20 69 73 20 6e 6f 74 20 61 6e 20 65 72 72  It is not an err
1650: 6f 72 20 69 66 20 74 68 65 20 6e 61 6d 65 64 20  or if the named 
1660: 74 61 62 6c 65 20 64 6f 65 73 20 6e 6f 74 20 65  table does not e
1670: 78 69 73 74 20 69 6e 20 74 68 65 20 64 61 74 61  xist in the data
1680: 62 61 73 65 2e 20 4e 6f 72 0a 2a 2a 20 69 73 20  base. Nor.** is 
1690: 69 74 20 61 6e 20 65 72 72 6f 72 20 69 66 20 74  it an error if t
16a0: 68 65 20 6e 61 6d 65 64 20 74 61 62 6c 65 20 64  he named table d
16b0: 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 61 20 50  oes not have a P
16c0: 52 49 4d 41 52 59 20 4b 45 59 2e 20 48 6f 77 65  RIMARY KEY. Howe
16d0: 76 65 72 2c 0a 2a 2a 20 6e 6f 20 63 68 61 6e 67  ver,.** no chang
16e0: 65 73 20 77 69 6c 6c 20 62 65 20 72 65 63 6f 72  es will be recor
16f0: 64 65 64 20 69 6e 20 65 69 74 68 65 72 20 6f 66  ded in either of
1700: 20 74 68 65 73 65 20 73 63 65 6e 61 72 69 6f 73   these scenarios
1710: 2e 0a 2a 2a 0a 2a 2a 20 43 68 61 6e 67 65 73 20  ..**.** Changes 
1720: 61 72 65 20 6e 6f 74 20 72 65 63 6f 72 64 65 64  are not recorded
1730: 20 66 6f 72 20 69 6e 64 69 76 69 64 75 61 6c 20   for individual 
1740: 72 6f 77 73 20 74 68 61 74 20 68 61 76 65 20 4e  rows that have N
1750: 55 4c 4c 20 76 61 6c 75 65 73 20 73 74 6f 72 65  ULL values store
1760: 64 0a 2a 2a 20 69 6e 20 6f 6e 65 20 6f 72 20 6d  d.** in one or m
1770: 6f 72 65 20 6f 66 20 74 68 65 69 72 20 50 52 49  ore of their PRI
1780: 4d 41 52 59 20 4b 45 59 20 63 6f 6c 75 6d 6e 73  MARY KEY columns
1790: 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f  ..**.** SQLITE_O
17a0: 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66  K is returned if
17b0: 20 74 68 65 20 63 61 6c 6c 20 63 6f 6d 70 6c 65   the call comple
17c0: 74 65 73 20 77 69 74 68 6f 75 74 20 65 72 72 6f  tes without erro
17d0: 72 2e 20 4f 72 2c 20 69 66 20 61 6e 20 65 72 72  r. Or, if an err
17e0: 6f 72 20 0a 2a 2a 20 6f 63 63 75 72 73 2c 20 61  or .** occurs, a
17f0: 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63  n SQLite error c
1800: 6f 64 65 20 28 65 2e 67 2e 20 53 51 4c 49 54 45  ode (e.g. SQLITE
1810: 5f 4e 4f 4d 45 4d 29 20 69 73 20 72 65 74 75 72  _NOMEM) is retur
1820: 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ned..*/.int sqli
1830: 74 65 33 73 65 73 73 69 6f 6e 5f 61 74 74 61 63  te3session_attac
1840: 68 28 0a 20 20 73 71 6c 69 74 65 33 5f 73 65 73  h(.  sqlite3_ses
1850: 73 69 6f 6e 20 2a 70 53 65 73 73 69 6f 6e 2c 20  sion *pSession, 
1860: 20 20 20 20 20 2f 2a 20 53 65 73 73 69 6f 6e 20       /* Session 
1870: 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 63 6f 6e 73  object */.  cons
1880: 74 20 63 68 61 72 20 2a 7a 54 61 62 20 20 20 20  t char *zTab    
1890: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
18a0: 61 62 6c 65 20 6e 61 6d 65 20 2a 2f 0a 29 3b 0a  able name */.);.
18b0: 0a 2f 2a 0a 2a 2a 20 43 41 50 49 33 52 45 46 3a  ./*.** CAPI3REF:
18c0: 20 53 65 74 20 61 20 74 61 62 6c 65 20 66 69 6c   Set a table fil
18d0: 74 65 72 20 6f 6e 20 61 20 53 65 73 73 69 6f 6e  ter on a Session
18e0: 20 4f 62 6a 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 54   Object..**.** T
18f0: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65  he second argume
1900: 6e 74 20 28 78 46 69 6c 74 65 72 29 20 69 73 20  nt (xFilter) is 
1910: 74 68 65 20 22 66 69 6c 74 65 72 20 63 61 6c 6c  the "filter call
1920: 62 61 63 6b 22 2e 20 46 6f 72 20 63 68 61 6e 67  back". For chang
1930: 65 73 20 74 6f 20 72 6f 77 73 20 0a 2a 2a 20 69  es to rows .** i
1940: 6e 20 74 61 62 6c 65 73 20 74 68 61 74 20 61 72  n tables that ar
1950: 65 20 6e 6f 74 20 61 74 74 61 63 68 65 64 20 74  e not attached t
1960: 6f 20 74 68 65 20 53 65 73 73 69 6f 6e 20 6f 62  o the Session ob
1970: 6a 65 63 74 2c 20 74 68 65 20 66 69 6c 74 65 72  ject, the filter
1980: 20 69 73 20 63 61 6c 6c 65 64 0a 2a 2a 20 74 6f   is called.** to
1990: 20 64 65 74 65 72 6d 69 6e 65 20 77 68 65 74 68   determine wheth
19a0: 65 72 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68  er changes to th
19b0: 65 20 74 61 62 6c 65 27 73 20 72 6f 77 73 20 73  e table's rows s
19c0: 68 6f 75 6c 64 20 62 65 20 74 72 61 63 6b 65 64  hould be tracked
19d0: 20 6f 72 20 6e 6f 74 2e 20 0a 2a 2a 20 49 66 20   or not. .** If 
19e0: 78 46 69 6c 74 65 72 20 72 65 74 75 72 6e 73 20  xFilter returns 
19f0: 30 2c 20 63 68 61 6e 67 65 73 20 69 73 20 6e 6f  0, changes is no
1a00: 74 20 74 72 61 63 6b 65 64 2e 20 4e 6f 74 65 20  t tracked. Note 
1a10: 74 68 61 74 20 6f 6e 63 65 20 61 20 74 61 62 6c  that once a tabl
1a20: 65 20 69 73 20 0a 2a 2a 20 61 74 74 61 63 68 65  e is .** attache
1a30: 64 2c 20 78 46 69 6c 74 65 72 20 77 69 6c 6c 20  d, xFilter will 
1a40: 6e 6f 74 20 62 65 20 63 61 6c 6c 65 64 20 61 67  not be called ag
1a50: 61 69 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  ain..*/.void sql
1a60: 69 74 65 33 73 65 73 73 69 6f 6e 5f 74 61 62 6c  ite3session_tabl
1a70: 65 5f 66 69 6c 74 65 72 28 0a 20 20 73 71 6c 69  e_filter(.  sqli
1a80: 74 65 33 5f 73 65 73 73 69 6f 6e 20 2a 70 53 65  te3_session *pSe
1a90: 73 73 69 6f 6e 2c 20 20 20 20 20 20 2f 2a 20 53  ssion,      /* S
1aa0: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 2a 2f  ession object */
1ab0: 0a 20 20 69 6e 74 28 2a 78 46 69 6c 74 65 72 29  .  int(*xFilter)
1ac0: 28 0a 20 20 20 20 76 6f 69 64 20 2a 70 43 74 78  (.    void *pCtx
1ad0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
1ae0: 20 20 20 20 2f 2a 20 43 6f 70 79 20 6f 66 20 74      /* Copy of t
1af0: 68 69 72 64 20 61 72 67 20 74 6f 20 5f 66 69 6c  hird arg to _fil
1b00: 74 65 72 5f 74 61 62 6c 65 28 29 20 2a 2f 0a 20  ter_table() */. 
1b10: 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a     const char *z
1b20: 54 61 62 20 20 20 20 20 20 20 20 20 20 20 20 20  Tab             
1b30: 20 2f 2a 20 54 61 62 6c 65 20 6e 61 6d 65 20 2a   /* Table name *
1b40: 2f 0a 20 20 29 2c 0a 20 20 76 6f 69 64 20 2a 70  /.  ),.  void *p
1b50: 43 74 78 20 20 20 20 20 20 20 20 20 20 20 20 20  Ctx             
1b60: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73           /* Firs
1b70: 74 20 61 72 67 75 6d 65 6e 74 20 70 61 73 73 65  t argument passe
1b80: 64 20 74 6f 20 78 46 69 6c 74 65 72 20 2a 2f 0a  d to xFilter */.
1b90: 29 3b 0a 0a 2f 2a 0a 2a 2a 20 43 41 50 49 33 52  );../*.** CAPI3R
1ba0: 45 46 3a 20 47 65 6e 65 72 61 74 65 20 41 20 43  EF: Generate A C
1bb0: 68 61 6e 67 65 73 65 74 20 46 72 6f 6d 20 41 20  hangeset From A 
1bc0: 53 65 73 73 69 6f 6e 20 4f 62 6a 65 63 74 0a 2a  Session Object.*
1bd0: 2a 0a 2a 2a 20 4f 62 74 61 69 6e 20 61 20 63 68  *.** Obtain a ch
1be0: 61 6e 67 65 73 65 74 20 63 6f 6e 74 61 69 6e 69  angeset containi
1bf0: 6e 67 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68  ng changes to th
1c00: 65 20 74 61 62 6c 65 73 20 61 74 74 61 63 68 65  e tables attache
1c10: 64 20 74 6f 20 74 68 65 20 0a 2a 2a 20 73 65 73  d to the .** ses
1c20: 73 69 6f 6e 20 6f 62 6a 65 63 74 20 70 61 73 73  sion object pass
1c30: 65 64 20 61 73 20 74 68 65 20 66 69 72 73 74 20  ed as the first 
1c40: 61 72 67 75 6d 65 6e 74 2e 20 49 66 20 73 75 63  argument. If suc
1c50: 63 65 73 73 66 75 6c 2c 20 0a 2a 2a 20 73 65 74  cessful, .** set
1c60: 20 2a 70 70 43 68 61 6e 67 65 73 65 74 20 74 6f   *ppChangeset to
1c70: 20 70 6f 69 6e 74 20 74 6f 20 61 20 62 75 66 66   point to a buff
1c80: 65 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68  er containing th
1c90: 65 20 63 68 61 6e 67 65 73 65 74 20 0a 2a 2a 20  e changeset .** 
1ca0: 61 6e 64 20 2a 70 6e 43 68 61 6e 67 65 73 65 74  and *pnChangeset
1cb0: 20 74 6f 20 74 68 65 20 73 69 7a 65 20 6f 66 20   to the size of 
1cc0: 74 68 65 20 63 68 61 6e 67 65 73 65 74 20 69 6e  the changeset in
1cd0: 20 62 79 74 65 73 20 62 65 66 6f 72 65 20 72 65   bytes before re
1ce0: 74 75 72 6e 69 6e 67 0a 2a 2a 20 53 51 4c 49 54  turning.** SQLIT
1cf0: 45 5f 4f 4b 2e 20 49 66 20 61 6e 20 65 72 72 6f  E_OK. If an erro
1d00: 72 20 6f 63 63 75 72 73 2c 20 73 65 74 20 62 6f  r occurs, set bo
1d10: 74 68 20 2a 70 70 43 68 61 6e 67 65 73 65 74 20  th *ppChangeset 
1d20: 61 6e 64 20 2a 70 6e 43 68 61 6e 67 65 73 65 74  and *pnChangeset
1d30: 20 74 6f 0a 2a 2a 20 7a 65 72 6f 20 61 6e 64 20   to.** zero and 
1d40: 72 65 74 75 72 6e 20 61 6e 20 53 51 4c 69 74 65  return an SQLite
1d50: 20 65 72 72 6f 72 20 63 6f 64 65 2e 0a 2a 2a 0a   error code..**.
1d60: 2a 2a 20 41 20 63 68 61 6e 67 65 73 65 74 20 63  ** A changeset c
1d70: 6f 6e 73 69 73 74 73 20 6f 66 20 7a 65 72 6f 20  onsists of zero 
1d80: 6f 72 20 6d 6f 72 65 20 49 4e 53 45 52 54 2c 20  or more INSERT, 
1d90: 55 50 44 41 54 45 20 61 6e 64 2f 6f 72 20 44 45  UPDATE and/or DE
1da0: 4c 45 54 45 20 63 68 61 6e 67 65 73 2c 0a 2a 2a  LETE changes,.**
1db0: 20 65 61 63 68 20 72 65 70 72 65 73 65 6e 74 69   each representi
1dc0: 6e 67 20 61 20 63 68 61 6e 67 65 20 74 6f 20 61  ng a change to a
1dd0: 20 73 69 6e 67 6c 65 20 72 6f 77 20 6f 66 20 61   single row of a
1de0: 6e 20 61 74 74 61 63 68 65 64 20 74 61 62 6c 65  n attached table
1df0: 2e 20 41 6e 20 49 4e 53 45 52 54 0a 2a 2a 20 63  . An INSERT.** c
1e00: 68 61 6e 67 65 20 63 6f 6e 74 61 69 6e 73 20 74  hange contains t
1e10: 68 65 20 76 61 6c 75 65 73 20 6f 66 20 65 61 63  he values of eac
1e20: 68 20 66 69 65 6c 64 20 6f 66 20 61 20 6e 65 77  h field of a new
1e30: 20 64 61 74 61 62 61 73 65 20 72 6f 77 2e 20 41   database row. A
1e40: 20 44 45 4c 45 54 45 0a 2a 2a 20 63 6f 6e 74 61   DELETE.** conta
1e50: 69 6e 73 20 74 68 65 20 6f 72 69 67 69 6e 61 6c  ins the original
1e60: 20 76 61 6c 75 65 73 20 6f 66 20 65 61 63 68 20   values of each 
1e70: 66 69 65 6c 64 20 6f 66 20 61 20 64 65 6c 65 74  field of a delet
1e80: 65 64 20 64 61 74 61 62 61 73 65 20 72 6f 77 2e  ed database row.
1e90: 20 41 6e 0a 2a 2a 20 55 50 44 41 54 45 20 63 68   An.** UPDATE ch
1ea0: 61 6e 67 65 20 63 6f 6e 74 61 69 6e 73 20 74 68  ange contains th
1eb0: 65 20 6f 72 69 67 69 6e 61 6c 20 76 61 6c 75 65  e original value
1ec0: 73 20 6f 66 20 65 61 63 68 20 66 69 65 6c 64 20  s of each field 
1ed0: 6f 66 20 61 6e 20 75 70 64 61 74 65 64 0a 2a 2a  of an updated.**
1ee0: 20 64 61 74 61 62 61 73 65 20 72 6f 77 20 61 6c   database row al
1ef0: 6f 6e 67 20 77 69 74 68 20 74 68 65 20 75 70 64  ong with the upd
1f00: 61 74 65 64 20 76 61 6c 75 65 73 20 66 6f 72 20  ated values for 
1f10: 65 61 63 68 20 75 70 64 61 74 65 64 20 6e 6f 6e  each updated non
1f20: 2d 70 72 69 6d 61 72 79 2d 6b 65 79 0a 2a 2a 20  -primary-key.** 
1f30: 63 6f 6c 75 6d 6e 2e 20 49 74 20 69 73 20 6e 6f  column. It is no
1f40: 74 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 61  t possible for a
1f50: 6e 20 55 50 44 41 54 45 20 63 68 61 6e 67 65 20  n UPDATE change 
1f60: 74 6f 20 72 65 70 72 65 73 65 6e 74 20 61 20 63  to represent a c
1f70: 68 61 6e 67 65 20 74 68 61 74 0a 2a 2a 20 6d 6f  hange that.** mo
1f80: 64 69 66 69 65 73 20 74 68 65 20 76 61 6c 75 65  difies the value
1f90: 73 20 6f 66 20 70 72 69 6d 61 72 79 20 6b 65 79  s of primary key
1fa0: 20 63 6f 6c 75 6d 6e 73 2e 20 49 66 20 73 75 63   columns. If suc
1fb0: 68 20 61 20 63 68 61 6e 67 65 20 69 73 20 6d 61  h a change is ma
1fc0: 64 65 2c 20 69 74 0a 2a 2a 20 69 73 20 72 65 70  de, it.** is rep
1fd0: 72 65 73 65 6e 74 65 64 20 69 6e 20 61 20 63 68  resented in a ch
1fe0: 61 6e 67 65 73 65 74 20 61 73 20 61 20 44 45 4c  angeset as a DEL
1ff0: 45 54 45 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20  ETE followed by 
2000: 61 6e 20 49 4e 53 45 52 54 2e 0a 2a 2a 0a 2a 2a  an INSERT..**.**
2010: 20 43 68 61 6e 67 65 73 20 61 72 65 20 6e 6f 74   Changes are not
2020: 20 72 65 63 6f 72 64 65 64 20 66 6f 72 20 72 6f   recorded for ro
2030: 77 73 20 74 68 61 74 20 68 61 76 65 20 4e 55 4c  ws that have NUL
2040: 4c 20 76 61 6c 75 65 73 20 73 74 6f 72 65 64 20  L values stored 
2050: 69 6e 20 6f 6e 65 20 6f 72 20 0a 2a 2a 20 6d 6f  in one or .** mo
2060: 72 65 20 6f 66 20 74 68 65 69 72 20 50 52 49 4d  re of their PRIM
2070: 41 52 59 20 4b 45 59 20 63 6f 6c 75 6d 6e 73 2e  ARY KEY columns.
2080: 20 49 66 20 73 75 63 68 20 61 20 72 6f 77 20 69   If such a row i
2090: 73 20 69 6e 73 65 72 74 65 64 20 6f 72 20 64 65  s inserted or de
20a0: 6c 65 74 65 64 2c 0a 2a 2a 20 6e 6f 20 63 6f 72  leted,.** no cor
20b0: 72 65 73 70 6f 6e 64 69 6e 67 20 63 68 61 6e 67  responding chang
20c0: 65 20 69 73 20 70 72 65 73 65 6e 74 20 69 6e 20  e is present in 
20d0: 74 68 65 20 63 68 61 6e 67 65 73 65 74 73 20 72  the changesets r
20e0: 65 74 75 72 6e 65 64 20 62 79 20 74 68 69 73 0a  eturned by this.
20f0: 2a 2a 20 66 75 6e 63 74 69 6f 6e 2e 20 49 66 20  ** function. If 
2100: 61 6e 20 65 78 69 73 74 69 6e 67 20 72 6f 77 20  an existing row 
2110: 77 69 74 68 20 6f 6e 65 20 6f 72 20 6d 6f 72 65  with one or more
2120: 20 4e 55 4c 4c 20 76 61 6c 75 65 73 20 73 74 6f   NULL values sto
2130: 72 65 64 20 69 6e 0a 2a 2a 20 50 52 49 4d 41 52  red in.** PRIMAR
2140: 59 20 4b 45 59 20 63 6f 6c 75 6d 6e 73 20 69 73  Y KEY columns is
2150: 20 75 70 64 61 74 65 64 20 73 6f 20 74 68 61 74   updated so that
2160: 20 61 6c 6c 20 50 52 49 4d 41 52 59 20 4b 45 59   all PRIMARY KEY
2170: 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 6e 6f 6e   columns are non
2180: 2d 4e 55 4c 4c 2c 0a 2a 2a 20 6f 6e 6c 79 20 61  -NULL,.** only a
2190: 6e 20 49 4e 53 45 52 54 20 69 73 20 61 70 70 65  n INSERT is appe
21a0: 61 72 73 20 69 6e 20 74 68 65 20 63 68 61 6e 67  ars in the chang
21b0: 65 73 65 74 2e 20 53 69 6d 69 6c 61 72 6c 79 2c  eset. Similarly,
21c0: 20 69 66 20 61 6e 20 65 78 69 73 74 69 6e 67 20   if an existing 
21d0: 72 6f 77 0a 2a 2a 20 77 69 74 68 20 6e 6f 6e 2d  row.** with non-
21e0: 4e 55 4c 4c 20 50 52 49 4d 41 52 59 20 4b 45 59  NULL PRIMARY KEY
21f0: 20 76 61 6c 75 65 73 20 69 73 20 75 70 64 61 74   values is updat
2200: 65 64 20 73 6f 20 74 68 61 74 20 6f 6e 65 20 6f  ed so that one o
2210: 72 20 6d 6f 72 65 20 6f 66 20 69 74 73 0a 2a 2a  r more of its.**
2220: 20 50 52 49 4d 41 52 59 20 4b 45 59 20 63 6f 6c   PRIMARY KEY col
2230: 75 6d 6e 73 20 61 72 65 20 73 65 74 20 74 6f 20  umns are set to 
2240: 4e 55 4c 4c 2c 20 74 68 65 20 72 65 73 75 6c 74  NULL, the result
2250: 69 6e 67 20 63 68 61 6e 67 65 73 65 74 20 63 6f  ing changeset co
2260: 6e 74 61 69 6e 73 20 61 0a 2a 2a 20 44 45 4c 45  ntains a.** DELE
2270: 54 45 20 63 68 61 6e 67 65 20 6f 6e 6c 79 2e 0a  TE change only..
2280: 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f 6e 74 65 6e  **.** The conten
2290: 74 73 20 6f 66 20 61 20 63 68 61 6e 67 65 73 65  ts of a changese
22a0: 74 20 6d 61 79 20 62 65 20 74 72 61 76 65 72 73  t may be travers
22b0: 65 64 20 75 73 69 6e 67 20 61 6e 20 69 74 65 72  ed using an iter
22c0: 61 74 6f 72 20 63 72 65 61 74 65 64 0a 2a 2a 20  ator created.** 
22d0: 75 73 69 6e 67 20 74 68 65 20 5b 73 71 6c 69 74  using the [sqlit
22e0: 65 33 63 68 61 6e 67 65 73 65 74 5f 73 74 61 72  e3changeset_star
22f0: 74 28 29 5d 20 41 50 49 2e 20 41 20 63 68 61 6e  t()] API. A chan
2300: 67 65 73 65 74 20 6d 61 79 20 62 65 20 61 70 70  geset may be app
2310: 6c 69 65 64 20 74 6f 0a 2a 2a 20 61 20 64 61 74  lied to.** a dat
2320: 61 62 61 73 65 20 77 69 74 68 20 61 20 63 6f 6d  abase with a com
2330: 70 61 74 69 62 6c 65 20 73 63 68 65 6d 61 20 75  patible schema u
2340: 73 69 6e 67 20 74 68 65 20 5b 73 71 6c 69 74 65  sing the [sqlite
2350: 33 63 68 61 6e 67 65 73 65 74 5f 61 70 70 6c 79  3changeset_apply
2360: 28 29 5d 0a 2a 2a 20 41 50 49 2e 0a 2a 2a 0a 2a  ()].** API..**.*
2370: 2a 20 57 69 74 68 69 6e 20 61 20 63 68 61 6e 67  * Within a chang
2380: 65 73 65 74 20 67 65 6e 65 72 61 74 65 64 20 62  eset generated b
2390: 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2c  y this function,
23a0: 20 61 6c 6c 20 63 68 61 6e 67 65 73 20 72 65 6c   all changes rel
23b0: 61 74 65 64 20 74 6f 20 61 0a 2a 2a 20 73 69 6e  ated to a.** sin
23c0: 67 6c 65 20 74 61 62 6c 65 20 61 72 65 20 67 72  gle table are gr
23d0: 6f 75 70 65 64 20 74 6f 67 65 74 68 65 72 2e 20  ouped together. 
23e0: 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20  In other words, 
23f0: 77 68 65 6e 20 69 74 65 72 61 74 69 6e 67 20 74  when iterating t
2400: 68 72 6f 75 67 68 0a 2a 2a 20 61 20 63 68 61 6e  hrough.** a chan
2410: 67 65 73 65 74 20 6f 72 20 77 68 65 6e 20 61 70  geset or when ap
2420: 70 6c 79 69 6e 67 20 61 20 63 68 61 6e 67 65 73  plying a changes
2430: 65 74 20 74 6f 20 61 20 64 61 74 61 62 61 73 65  et to a database
2440: 2c 20 61 6c 6c 20 63 68 61 6e 67 65 73 20 72 65  , all changes re
2450: 6c 61 74 65 64 0a 2a 2a 20 74 6f 20 61 20 73 69  lated.** to a si
2460: 6e 67 6c 65 20 74 61 62 6c 65 20 61 72 65 20 70  ngle table are p
2470: 72 6f 63 65 73 73 65 64 20 62 65 66 6f 72 65 20  rocessed before 
2480: 6d 6f 76 69 6e 67 20 6f 6e 20 74 6f 20 74 68 65  moving on to the
2490: 20 6e 65 78 74 20 74 61 62 6c 65 2e 20 54 61 62   next table. Tab
24a0: 6c 65 73 0a 2a 2a 20 61 72 65 20 73 6f 72 74 65  les.** are sorte
24b0: 64 20 69 6e 20 74 68 65 20 73 61 6d 65 20 6f 72  d in the same or
24c0: 64 65 72 20 69 6e 20 77 68 69 63 68 20 74 68 65  der in which the
24d0: 79 20 77 65 72 65 20 61 74 74 61 63 68 65 64 20  y were attached 
24e0: 28 6f 72 20 61 75 74 6f 2d 61 74 74 61 63 68 65  (or auto-attache
24f0: 64 29 0a 2a 2a 20 74 6f 20 74 68 65 20 73 71 6c  d).** to the sql
2500: 69 74 65 33 5f 73 65 73 73 69 6f 6e 20 6f 62 6a  ite3_session obj
2510: 65 63 74 2e 20 54 68 65 20 6f 72 64 65 72 20 69  ect. The order i
2520: 6e 20 77 68 69 63 68 20 74 68 65 20 63 68 61 6e  n which the chan
2530: 67 65 73 20 72 65 6c 61 74 65 64 20 74 6f 0a 2a  ges related to.*
2540: 2a 20 61 20 73 69 6e 67 6c 65 20 74 61 62 6c 65  * a single table
2550: 20 61 72 65 20 73 74 6f 72 65 64 20 69 73 20 75   are stored is u
2560: 6e 64 65 66 69 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20  ndefined..**.** 
2570: 46 6f 6c 6c 6f 77 69 6e 67 20 61 20 73 75 63 63  Following a succ
2580: 65 73 73 66 75 6c 20 63 61 6c 6c 20 74 6f 20 74  essful call to t
2590: 68 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 69 74  his function, it
25a0: 20 69 73 20 74 68 65 20 72 65 73 70 6f 6e 73 69   is the responsi
25b0: 62 69 6c 69 74 79 20 6f 66 0a 2a 2a 20 74 68 65  bility of.** the
25c0: 20 63 61 6c 6c 65 72 20 74 6f 20 65 76 65 6e 74   caller to event
25d0: 75 61 6c 6c 79 20 66 72 65 65 20 74 68 65 20 62  ually free the b
25e0: 75 66 66 65 72 20 74 68 61 74 20 2a 70 70 43 68  uffer that *ppCh
25f0: 61 6e 67 65 73 65 74 20 70 6f 69 6e 74 73 20 74  angeset points t
2600: 6f 20 75 73 69 6e 67 0a 2a 2a 20 5b 73 71 6c 69  o using.** [sqli
2610: 74 65 33 5f 66 72 65 65 28 29 5d 2e 0a 2a 2a 0a  te3_free()]..**.
2620: 2a 2a 20 3c 68 33 3e 43 68 61 6e 67 65 73 65 74  ** <h3>Changeset
2630: 20 47 65 6e 65 72 61 74 69 6f 6e 3c 2f 68 33 3e   Generation</h3>
2640: 0a 2a 2a 0a 2a 2a 20 4f 6e 63 65 20 61 20 74 61  .**.** Once a ta
2650: 62 6c 65 20 68 61 73 20 62 65 65 6e 20 61 74 74  ble has been att
2660: 61 63 68 65 64 20 74 6f 20 61 20 73 65 73 73 69  ached to a sessi
2670: 6f 6e 20 6f 62 6a 65 63 74 2c 20 74 68 65 20 73  on object, the s
2680: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 0a 2a 2a  ession object.**
2690: 20 72 65 63 6f 72 64 73 20 74 68 65 20 70 72 69   records the pri
26a0: 6d 61 72 79 20 6b 65 79 20 76 61 6c 75 65 73 20  mary key values 
26b0: 6f 66 20 61 6c 6c 20 6e 65 77 20 72 6f 77 73 20  of all new rows 
26c0: 69 6e 73 65 72 74 65 64 20 69 6e 74 6f 20 74 68  inserted into th
26d0: 65 20 74 61 62 6c 65 2e 0a 2a 2a 20 49 74 20 61  e table..** It a
26e0: 6c 73 6f 20 72 65 63 6f 72 64 73 20 74 68 65 20  lso records the 
26f0: 6f 72 69 67 69 6e 61 6c 20 70 72 69 6d 61 72 79  original primary
2700: 20 6b 65 79 20 61 6e 64 20 6f 74 68 65 72 20 63   key and other c
2710: 6f 6c 75 6d 6e 20 76 61 6c 75 65 73 20 6f 66 20  olumn values of 
2720: 61 6e 79 0a 2a 2a 20 64 65 6c 65 74 65 64 20 6f  any.** deleted o
2730: 72 20 75 70 64 61 74 65 64 20 72 6f 77 73 2e 20  r updated rows. 
2740: 46 6f 72 20 65 61 63 68 20 75 6e 69 71 75 65 20  For each unique 
2750: 70 72 69 6d 61 72 79 20 6b 65 79 20 76 61 6c 75  primary key valu
2760: 65 2c 20 64 61 74 61 20 69 73 20 6f 6e 6c 79 0a  e, data is only.
2770: 2a 2a 20 72 65 63 6f 72 64 65 64 20 6f 6e 63 65  ** recorded once
2780: 20 2d 20 74 68 65 20 66 69 72 73 74 20 74 69 6d   - the first tim
2790: 65 20 61 20 72 6f 77 20 77 69 74 68 20 73 61 69  e a row with sai
27a0: 64 20 70 72 69 6d 61 72 79 20 6b 65 79 20 69 73  d primary key is
27b0: 20 69 6e 73 65 72 74 65 64 2c 0a 2a 2a 20 75 70   inserted,.** up
27c0: 64 61 74 65 64 20 6f 72 20 64 65 6c 65 74 65 64  dated or deleted
27d0: 20 69 6e 20 74 68 65 20 6c 69 66 65 74 69 6d 65   in the lifetime
27e0: 20 6f 66 20 74 68 65 20 73 65 73 73 69 6f 6e 2e   of the session.
27f0: 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 69 73 20  .**.** There is 
2800: 6f 6e 65 20 65 78 63 65 70 74 69 6f 6e 20 74 6f  one exception to
2810: 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 70 61   the previous pa
2820: 72 61 67 72 61 70 68 3a 20 77 68 65 6e 20 61 20  ragraph: when a 
2830: 72 6f 77 20 69 73 20 69 6e 73 65 72 74 65 64 2c  row is inserted,
2840: 0a 2a 2a 20 75 70 64 61 74 65 64 20 6f 72 20 64  .** updated or d
2850: 65 6c 65 74 65 64 2c 20 69 66 20 6f 6e 65 20 6f  eleted, if one o
2860: 72 20 6d 6f 72 65 20 6f 66 20 69 74 73 20 70 72  r more of its pr
2870: 69 6d 61 72 79 20 6b 65 79 20 63 6f 6c 75 6d 6e  imary key column
2880: 73 20 63 6f 6e 74 61 69 6e 20 61 0a 2a 2a 20 4e  s contain a.** N
2890: 55 4c 4c 20 76 61 6c 75 65 2c 20 6e 6f 20 72 65  ULL value, no re
28a0: 63 6f 72 64 20 6f 66 20 74 68 65 20 63 68 61 6e  cord of the chan
28b0: 67 65 20 69 73 20 6d 61 64 65 2e 0a 2a 2a 0a 2a  ge is made..**.*
28c0: 2a 20 54 68 65 20 73 65 73 73 69 6f 6e 20 6f 62  * The session ob
28d0: 6a 65 63 74 20 74 68 65 72 65 66 6f 72 65 20 61  ject therefore a
28e0: 63 63 75 6d 75 6c 61 74 65 73 20 74 77 6f 20 74  ccumulates two t
28f0: 79 70 65 73 20 6f 66 20 72 65 63 6f 72 64 73 20  ypes of records 
2900: 2d 20 74 68 6f 73 65 0a 2a 2a 20 74 68 61 74 20  - those.** that 
2910: 63 6f 6e 73 69 73 74 20 6f 66 20 70 72 69 6d 61  consist of prima
2920: 72 79 20 6b 65 79 20 76 61 6c 75 65 73 20 6f 6e  ry key values on
2930: 6c 79 20 28 63 72 65 61 74 65 64 20 77 68 65 6e  ly (created when
2940: 20 74 68 65 20 75 73 65 72 20 69 6e 73 65 72 74   the user insert
2950: 73 0a 2a 2a 20 61 20 6e 65 77 20 72 65 63 6f 72  s.** a new recor
2960: 64 29 20 61 6e 64 20 74 68 6f 73 65 20 74 68 61  d) and those tha
2970: 74 20 63 6f 6e 73 69 73 74 20 6f 66 20 74 68 65  t consist of the
2980: 20 70 72 69 6d 61 72 79 20 6b 65 79 20 76 61 6c   primary key val
2990: 75 65 73 20 61 6e 64 20 74 68 65 0a 2a 2a 20 6f  ues and the.** o
29a0: 72 69 67 69 6e 61 6c 20 76 61 6c 75 65 73 20 6f  riginal values o
29b0: 66 20 6f 74 68 65 72 20 74 61 62 6c 65 20 63 6f  f other table co
29c0: 6c 75 6d 6e 73 20 28 63 72 65 61 74 65 64 20 77  lumns (created w
29d0: 68 65 6e 20 74 68 65 20 75 73 65 72 73 20 64 65  hen the users de
29e0: 6c 65 74 65 73 0a 2a 2a 20 6f 72 20 75 70 64 61  letes.** or upda
29f0: 74 65 73 20 61 20 72 65 63 6f 72 64 29 2e 0a 2a  tes a record)..*
2a00: 2a 0a 2a 2a 20 57 68 65 6e 20 74 68 69 73 20 66  *.** When this f
2a10: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
2a20: 64 2c 20 74 68 65 20 72 65 71 75 65 73 74 65 64  d, the requested
2a30: 20 63 68 61 6e 67 65 73 65 74 20 69 73 20 63 72   changeset is cr
2a40: 65 61 74 65 64 20 75 73 69 6e 67 0a 2a 2a 20 62  eated using.** b
2a50: 6f 74 68 20 74 68 65 20 61 63 63 75 6d 75 6c 61  oth the accumula
2a60: 74 65 64 20 72 65 63 6f 72 64 73 20 61 6e 64 20  ted records and 
2a70: 74 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6e 74  the current cont
2a80: 65 6e 74 73 20 6f 66 20 74 68 65 20 64 61 74 61  ents of the data
2a90: 62 61 73 65 0a 2a 2a 20 66 69 6c 65 2e 20 53 70  base.** file. Sp
2aa0: 65 63 69 66 69 63 61 6c 6c 79 3a 0a 2a 2a 0a 2a  ecifically:.**.*
2ab0: 2a 20 3c 75 6c 3e 0a 2a 2a 20 20 20 3c 6c 69 3e  * <ul>.**   <li>
2ac0: 20 46 6f 72 20 65 61 63 68 20 72 65 63 6f 72 64   For each record
2ad0: 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 61 6e   generated by an
2ae0: 20 69 6e 73 65 72 74 2c 20 74 68 65 20 64 61 74   insert, the dat
2af0: 61 62 61 73 65 20 69 73 20 71 75 65 72 69 65 64  abase is queried
2b00: 0a 2a 2a 20 20 20 20 20 20 20 20 66 6f 72 20 61  .**        for a
2b10: 20 72 6f 77 20 77 69 74 68 20 61 20 6d 61 74 63   row with a matc
2b20: 68 69 6e 67 20 70 72 69 6d 61 72 79 20 6b 65 79  hing primary key
2b30: 2e 20 49 66 20 6f 6e 65 20 69 73 20 66 6f 75 6e  . If one is foun
2b40: 64 2c 20 61 6e 20 49 4e 53 45 52 54 0a 2a 2a 20  d, an INSERT.** 
2b50: 20 20 20 20 20 20 20 63 68 61 6e 67 65 20 69 73         change is
2b60: 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 63 68   added to the ch
2b70: 61 6e 67 65 73 65 74 2e 20 49 66 20 6e 6f 20 73  angeset. If no s
2b80: 75 63 68 20 72 6f 77 20 69 73 20 66 6f 75 6e 64  uch row is found
2b90: 2c 20 6e 6f 20 63 68 61 6e 67 65 20 0a 2a 2a 20  , no change .** 
2ba0: 20 20 20 20 20 20 20 69 73 20 61 64 64 65 64 20         is added 
2bb0: 74 6f 20 74 68 65 20 63 68 61 6e 67 65 73 65 74  to the changeset
2bc0: 2e 0a 2a 2a 0a 2a 2a 20 20 20 3c 6c 69 3e 20 46  ..**.**   <li> F
2bd0: 6f 72 20 65 61 63 68 20 72 65 63 6f 72 64 20 67  or each record g
2be0: 65 6e 65 72 61 74 65 64 20 62 79 20 61 6e 20 75  enerated by an u
2bf0: 70 64 61 74 65 20 6f 72 20 64 65 6c 65 74 65 2c  pdate or delete,
2c00: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73   the database is
2c10: 20 0a 2a 2a 20 20 20 20 20 20 20 20 71 75 65 72   .**        quer
2c20: 69 65 64 20 66 6f 72 20 61 20 72 6f 77 20 77 69  ied for a row wi
2c30: 74 68 20 61 20 6d 61 74 63 68 69 6e 67 20 70 72  th a matching pr
2c40: 69 6d 61 72 79 20 6b 65 79 2e 20 49 66 20 73 75  imary key. If su
2c50: 63 68 20 61 20 72 6f 77 20 69 73 0a 2a 2a 20 20  ch a row is.**  
2c60: 20 20 20 20 20 20 66 6f 75 6e 64 20 61 6e 64 20        found and 
2c70: 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 66 20 74  one or more of t
2c80: 68 65 20 6e 6f 6e 2d 70 72 69 6d 61 72 79 20 6b  he non-primary k
2c90: 65 79 20 66 69 65 6c 64 73 20 68 61 76 65 20 62  ey fields have b
2ca0: 65 65 6e 0a 2a 2a 20 20 20 20 20 20 20 20 6d 6f  een.**        mo
2cb0: 64 69 66 69 65 64 20 66 72 6f 6d 20 74 68 65 69  dified from thei
2cc0: 72 20 6f 72 69 67 69 6e 61 6c 20 76 61 6c 75 65  r original value
2cd0: 73 2c 20 61 6e 20 55 50 44 41 54 45 20 63 68 61  s, an UPDATE cha
2ce0: 6e 67 65 20 69 73 20 61 64 64 65 64 20 74 6f 20  nge is added to 
2cf0: 0a 2a 2a 20 20 20 20 20 20 20 20 74 68 65 20 63  .**        the c
2d00: 68 61 6e 67 65 73 65 74 2e 20 4f 72 2c 20 69 66  hangeset. Or, if
2d10: 20 6e 6f 20 73 75 63 68 20 72 6f 77 20 69 73 20   no such row is 
2d20: 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 74 61 62  found in the tab
2d30: 6c 65 2c 20 61 20 44 45 4c 45 54 45 20 0a 2a 2a  le, a DELETE .**
2d40: 20 20 20 20 20 20 20 20 63 68 61 6e 67 65 20 69          change i
2d50: 73 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 63  s added to the c
2d60: 68 61 6e 67 65 73 65 74 2e 20 49 66 20 74 68 65  hangeset. If the
2d70: 72 65 20 69 73 20 61 20 72 6f 77 20 77 69 74 68  re is a row with
2d80: 20 61 20 6d 61 74 63 68 69 6e 67 0a 2a 2a 20 20   a matching.**  
2d90: 20 20 20 20 20 20 70 72 69 6d 61 72 79 20 6b 65        primary ke
2da0: 79 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73  y in the databas
2db0: 65 2c 20 62 75 74 20 61 6c 6c 20 66 69 65 6c 64  e, but all field
2dc0: 73 20 63 6f 6e 74 61 69 6e 20 74 68 65 69 72 20  s contain their 
2dd0: 6f 72 69 67 69 6e 61 6c 0a 2a 2a 20 20 20 20 20  original.**     
2de0: 20 20 20 76 61 6c 75 65 73 2c 20 6e 6f 20 63 68     values, no ch
2df0: 61 6e 67 65 20 69 73 20 61 64 64 65 64 20 74 6f  ange is added to
2e00: 20 74 68 65 20 63 68 61 6e 67 65 73 65 74 2e 0a   the changeset..
2e10: 2a 2a 20 3c 2f 75 6c 3e 0a 2a 2a 0a 2a 2a 20 54  ** </ul>.**.** T
2e20: 68 69 73 20 6d 65 61 6e 73 2c 20 61 6d 6f 6e 67  his means, among
2e30: 73 74 20 6f 74 68 65 72 20 74 68 69 6e 67 73 2c  st other things,
2e40: 20 74 68 61 74 20 69 66 20 61 20 72 6f 77 20 69   that if a row i
2e50: 73 20 69 6e 73 65 72 74 65 64 20 61 6e 64 20 74  s inserted and t
2e60: 68 65 6e 20 6c 61 74 65 72 0a 2a 2a 20 64 65 6c  hen later.** del
2e70: 65 74 65 64 20 77 68 69 6c 65 20 61 20 73 65 73  eted while a ses
2e80: 73 69 6f 6e 20 6f 62 6a 65 63 74 20 69 73 20 61  sion object is a
2e90: 63 74 69 76 65 2c 20 6e 65 69 74 68 65 72 20 74  ctive, neither t
2ea0: 68 65 20 69 6e 73 65 72 74 20 6e 6f 72 20 74 68  he insert nor th
2eb0: 65 20 64 65 6c 65 74 65 0a 2a 2a 20 77 69 6c 6c  e delete.** will
2ec0: 20 62 65 20 70 72 65 73 65 6e 74 20 69 6e 20 74   be present in t
2ed0: 68 65 20 63 68 61 6e 67 65 73 65 74 2e 20 4f 72  he changeset. Or
2ee0: 20 69 66 20 61 20 72 6f 77 20 69 73 20 64 65 6c   if a row is del
2ef0: 65 74 65 64 20 61 6e 64 20 74 68 65 6e 20 6c 61  eted and then la
2f00: 74 65 72 20 61 20 0a 2a 2a 20 72 6f 77 20 77 69  ter a .** row wi
2f10: 74 68 20 74 68 65 20 73 61 6d 65 20 70 72 69 6d  th the same prim
2f20: 61 72 79 20 6b 65 79 20 76 61 6c 75 65 73 20 69  ary key values i
2f30: 6e 73 65 72 74 65 64 20 77 68 69 6c 65 20 61 20  nserted while a 
2f40: 73 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 69  session object i
2f50: 73 0a 2a 2a 20 61 63 74 69 76 65 2c 20 74 68 65  s.** active, the
2f60: 20 72 65 73 75 6c 74 69 6e 67 20 63 68 61 6e 67   resulting chang
2f70: 65 73 65 74 20 77 69 6c 6c 20 63 6f 6e 74 61 69  eset will contai
2f80: 6e 20 61 6e 20 55 50 44 41 54 45 20 63 68 61 6e  n an UPDATE chan
2f90: 67 65 20 69 6e 73 74 65 61 64 20 6f 66 0a 2a 2a  ge instead of.**
2fa0: 20 61 20 44 45 4c 45 54 45 20 61 6e 64 20 61 6e   a DELETE and an
2fb0: 20 49 4e 53 45 52 54 2e 0a 2a 2a 0a 2a 2a 20 57   INSERT..**.** W
2fc0: 68 65 6e 20 61 20 73 65 73 73 69 6f 6e 20 6f 62  hen a session ob
2fd0: 6a 65 63 74 20 69 73 20 64 69 73 61 62 6c 65 64  ject is disabled
2fe0: 20 28 73 65 65 20 74 68 65 20 5b 73 71 6c 69 74   (see the [sqlit
2ff0: 65 33 73 65 73 73 69 6f 6e 5f 65 6e 61 62 6c 65  e3session_enable
3000: 28 29 5d 20 41 50 49 29 2c 0a 2a 2a 20 69 74 20  ()] API),.** it 
3010: 64 6f 65 73 20 6e 6f 74 20 61 63 63 75 6d 75 6c  does not accumul
3020: 61 74 65 20 72 65 63 6f 72 64 73 20 77 68 65 6e  ate records when
3030: 20 72 6f 77 73 20 61 72 65 20 69 6e 73 65 72 74   rows are insert
3040: 65 64 2c 20 75 70 64 61 74 65 64 20 6f 72 20 64  ed, updated or d
3050: 65 6c 65 74 65 64 2e 0a 2a 2a 20 54 68 69 73 20  eleted..** This 
3060: 6d 61 79 20 61 70 70 65 61 72 20 74 6f 20 68 61  may appear to ha
3070: 76 65 20 73 6f 6d 65 20 63 6f 75 6e 74 65 72 2d  ve some counter-
3080: 69 6e 74 75 69 74 69 76 65 20 65 66 66 65 63 74  intuitive effect
3090: 73 20 69 66 20 61 20 73 69 6e 67 6c 65 20 72 6f  s if a single ro
30a0: 77 0a 2a 2a 20 69 73 20 77 72 69 74 74 65 6e 20  w.** is written 
30b0: 74 6f 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 63  to more than onc
30c0: 65 20 64 75 72 69 6e 67 20 61 20 73 65 73 73 69  e during a sessi
30d0: 6f 6e 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c  on. For example,
30e0: 20 69 66 20 61 20 72 6f 77 0a 2a 2a 20 69 73 20   if a row.** is 
30f0: 69 6e 73 65 72 74 65 64 20 77 68 69 6c 65 20 61  inserted while a
3100: 20 73 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20   session object 
3110: 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 6e  is enabled, then
3120: 20 6c 61 74 65 72 20 64 65 6c 65 74 65 64 20 77   later deleted w
3130: 68 69 6c 65 20 0a 2a 2a 20 74 68 65 20 73 61 6d  hile .** the sam
3140: 65 20 73 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74  e session object
3150: 20 69 73 20 64 69 73 61 62 6c 65 64 2c 20 6e 6f   is disabled, no
3160: 20 49 4e 53 45 52 54 20 72 65 63 6f 72 64 20 77   INSERT record w
3170: 69 6c 6c 20 61 70 70 65 61 72 20 69 6e 20 74 68  ill appear in th
3180: 65 0a 2a 2a 20 63 68 61 6e 67 65 73 65 74 2c 20  e.** changeset, 
3190: 65 76 65 6e 20 74 68 6f 75 67 68 20 74 68 65 20  even though the 
31a0: 64 65 6c 65 74 65 20 74 6f 6f 6b 20 70 6c 61 63  delete took plac
31b0: 65 20 77 68 69 6c 65 20 74 68 65 20 73 65 73 73  e while the sess
31c0: 69 6f 6e 20 77 61 73 20 64 69 73 61 62 6c 65 64  ion was disabled
31d0: 2e 0a 2a 2a 20 4f 72 2c 20 69 66 20 6f 6e 65 20  ..** Or, if one 
31e0: 66 69 65 6c 64 20 6f 66 20 61 20 72 6f 77 20 69  field of a row i
31f0: 73 20 75 70 64 61 74 65 64 20 77 68 69 6c 65 20  s updated while 
3200: 61 20 73 65 73 73 69 6f 6e 20 69 73 20 64 69 73  a session is dis
3210: 61 62 6c 65 64 2c 20 61 6e 64 20 0a 2a 2a 20 61  abled, and .** a
3220: 6e 6f 74 68 65 72 20 66 69 65 6c 64 20 6f 66 20  nother field of 
3230: 74 68 65 20 73 61 6d 65 20 72 6f 77 20 69 73 20  the same row is 
3240: 75 70 64 61 74 65 64 20 77 68 69 6c 65 20 74 68  updated while th
3250: 65 20 73 65 73 73 69 6f 6e 20 69 73 20 65 6e 61  e session is ena
3260: 62 6c 65 64 2c 20 74 68 65 0a 2a 2a 20 72 65 73  bled, the.** res
3270: 75 6c 74 69 6e 67 20 63 68 61 6e 67 65 73 65 74  ulting changeset
3280: 20 77 69 6c 6c 20 63 6f 6e 74 61 69 6e 20 61 6e   will contain an
3290: 20 55 50 44 41 54 45 20 63 68 61 6e 67 65 20 74   UPDATE change t
32a0: 68 61 74 20 75 70 64 61 74 65 73 20 62 6f 74 68  hat updates both
32b0: 20 66 69 65 6c 64 73 2e 0a 2a 2f 0a 69 6e 74 20   fields..*/.int 
32c0: 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 63  sqlite3session_c
32d0: 68 61 6e 67 65 73 65 74 28 0a 20 20 73 71 6c 69  hangeset(.  sqli
32e0: 74 65 33 5f 73 65 73 73 69 6f 6e 20 2a 70 53 65  te3_session *pSe
32f0: 73 73 69 6f 6e 2c 20 20 20 20 20 20 2f 2a 20 53  ssion,      /* S
3300: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 2a 2f  ession object */
3310: 0a 20 20 69 6e 74 20 2a 70 6e 43 68 61 6e 67 65  .  int *pnChange
3320: 73 65 74 2c 20 20 20 20 20 20 20 20 20 20 20 20  set,            
3330: 20 20 20 2f 2a 20 4f 55 54 3a 20 53 69 7a 65 20     /* OUT: Size 
3340: 6f 66 20 62 75 66 66 65 72 20 61 74 20 2a 70 70  of buffer at *pp
3350: 43 68 61 6e 67 65 73 65 74 20 2a 2f 0a 20 20 76  Changeset */.  v
3360: 6f 69 64 20 2a 2a 70 70 43 68 61 6e 67 65 73 65  oid **ppChangese
3370: 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  t              /
3380: 2a 20 4f 55 54 3a 20 42 75 66 66 65 72 20 63 6f  * OUT: Buffer co
3390: 6e 74 61 69 6e 69 6e 67 20 63 68 61 6e 67 65 73  ntaining changes
33a0: 65 74 20 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20  et */.);../*.** 
33b0: 43 41 50 49 33 52 45 46 3a 20 47 65 6e 65 72 61  CAPI3REF: Genera
33c0: 74 65 20 41 20 46 75 6c 6c 20 43 68 61 6e 67 65  te A Full Change
33d0: 73 65 74 20 46 72 6f 6d 20 41 20 53 65 73 73 69  set From A Sessi
33e0: 6f 6e 20 4f 62 6a 65 63 74 0a 2a 2a 0a 2a 2a 20  on Object.**.** 
33f0: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  This function is
3400: 20 73 69 6d 69 6c 61 72 20 74 6f 20 73 71 6c 69   similar to sqli
3410: 74 65 33 73 65 73 73 69 6f 6e 5f 63 68 61 6e 67  te3session_chang
3420: 65 73 65 74 28 29 2c 20 65 78 63 65 70 74 20 74  eset(), except t
3430: 68 61 74 20 66 6f 72 0a 2a 2a 20 65 61 63 68 20  hat for.** each 
3440: 72 6f 77 20 61 66 66 65 63 74 65 64 20 62 79 20  row affected by 
3450: 61 6e 20 55 50 44 41 54 45 20 73 74 61 74 65 6d  an UPDATE statem
3460: 65 6e 74 2c 20 61 6c 6c 20 6f 6c 64 2e 2a 20 76  ent, all old.* v
3470: 61 6c 75 65 73 20 61 72 65 20 72 65 63 6f 72 64  alues are record
3480: 65 64 0a 2a 2a 20 61 73 20 70 61 72 74 20 6f 66  ed.** as part of
3490: 20 74 68 65 20 63 68 61 6e 67 65 73 65 74 2c 20   the changeset, 
34a0: 6e 6f 74 20 6a 75 73 74 20 74 68 6f 73 65 20 6d  not just those m
34b0: 6f 64 69 66 69 65 64 2e 0a 2a 2f 0a 69 6e 74 20  odified..*/.int 
34c0: 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 66  sqlite3session_f
34d0: 75 6c 6c 63 68 61 6e 67 65 73 65 74 28 0a 20 20  ullchangeset(.  
34e0: 73 71 6c 69 74 65 33 5f 73 65 73 73 69 6f 6e 20  sqlite3_session 
34f0: 2a 70 53 65 73 73 69 6f 6e 2c 20 20 20 20 20 20  *pSession,      
3500: 2f 2a 20 53 65 73 73 69 6f 6e 20 6f 62 6a 65 63  /* Session objec
3510: 74 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 43 68  t */.  int *pnCh
3520: 61 6e 67 65 73 65 74 2c 20 20 20 20 20 20 20 20  angeset,        
3530: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 53         /* OUT: S
3540: 69 7a 65 20 6f 66 20 62 75 66 66 65 72 20 61 74  ize of buffer at
3550: 20 2a 70 70 43 68 61 6e 67 65 73 65 74 20 2a 2f   *ppChangeset */
3560: 0a 20 20 76 6f 69 64 20 2a 2a 70 70 43 68 61 6e  .  void **ppChan
3570: 67 65 73 65 74 20 20 20 20 20 20 20 20 20 20 20  geset           
3580: 20 20 20 2f 2a 20 4f 55 54 3a 20 42 75 66 66 65     /* OUT: Buffe
3590: 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 63 68 61  r containing cha
35a0: 6e 67 65 73 65 74 20 2a 2f 0a 29 3b 0a 0a 2f 2a  ngeset */.);../*
35b0: 0a 2a 2a 20 43 41 50 49 33 52 45 46 3a 20 4c 6f  .** CAPI3REF: Lo
35c0: 61 64 20 54 68 65 20 44 69 66 66 65 72 65 6e 63  ad The Differenc
35d0: 65 20 42 65 74 77 65 65 6e 20 54 61 62 6c 65 73  e Between Tables
35e0: 20 49 6e 74 6f 20 41 20 53 65 73 73 69 6f 6e 20   Into A Session 
35f0: 0a 2a 2a 0a 2a 2a 20 49 66 20 69 74 20 69 73 20  .**.** If it is 
3600: 6e 6f 74 20 61 6c 72 65 61 64 79 20 61 74 74 61  not already atta
3610: 63 68 65 64 20 74 6f 20 74 68 65 20 73 65 73 73  ched to the sess
3620: 69 6f 6e 20 6f 62 6a 65 63 74 20 70 61 73 73 65  ion object passe
3630: 64 20 61 73 20 74 68 65 20 66 69 72 73 74 0a 2a  d as the first.*
3640: 2a 20 61 72 67 75 6d 65 6e 74 2c 20 74 68 69 73  * argument, this
3650: 20 66 75 6e 63 74 69 6f 6e 20 61 74 74 61 63 68   function attach
3660: 65 73 20 74 61 62 6c 65 20 7a 54 62 6c 20 69 6e  es table zTbl in
3670: 20 74 68 65 20 73 61 6d 65 20 6d 61 6e 6e 65 72   the same manner
3680: 20 61 73 20 74 68 65 0a 2a 2a 20 5b 73 71 6c 69   as the.** [sqli
3690: 74 65 33 73 65 73 73 69 6f 6e 5f 61 74 74 61 63  te3session_attac
36a0: 68 28 29 5d 20 66 75 6e 63 74 69 6f 6e 2e 20 49  h()] function. I
36b0: 66 20 7a 54 62 6c 20 64 6f 65 73 20 6e 6f 74 20  f zTbl does not 
36c0: 65 78 69 73 74 2c 20 6f 72 20 69 66 20 69 74 0a  exist, or if it.
36d0: 2a 2a 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65  ** does not have
36e0: 20 61 20 70 72 69 6d 61 72 79 20 6b 65 79 2c 20   a primary key, 
36f0: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  this function is
3700: 20 61 20 6e 6f 2d 6f 70 20 28 62 75 74 20 64 6f   a no-op (but do
3710: 65 73 20 6e 6f 74 20 72 65 74 75 72 6e 0a 2a 2a  es not return.**
3720: 20 61 6e 20 65 72 72 6f 72 29 2e 0a 2a 2a 0a 2a   an error)..**.*
3730: 2a 20 41 72 67 75 6d 65 6e 74 20 7a 46 72 6f 6d  * Argument zFrom
3740: 44 62 20 6d 75 73 74 20 62 65 20 74 68 65 20 6e  Db must be the n
3750: 61 6d 65 20 6f 66 20 61 20 64 61 74 61 62 61 73  ame of a databas
3760: 65 20 28 22 6d 61 69 6e 22 2c 20 22 74 65 6d 70  e ("main", "temp
3770: 22 20 65 74 63 2e 29 0a 2a 2a 20 61 74 74 61 63  " etc.).** attac
3780: 68 65 64 20 74 6f 20 74 68 65 20 73 61 6d 65 20  hed to the same 
3790: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20  database handle 
37a0: 61 73 20 74 68 65 20 73 65 73 73 69 6f 6e 20 6f  as the session o
37b0: 62 6a 65 63 74 20 74 68 61 74 20 63 6f 6e 74 61  bject that conta
37c0: 69 6e 73 20 0a 2a 2a 20 61 20 74 61 62 6c 65 20  ins .** a table 
37d0: 63 6f 6d 70 61 74 69 62 6c 65 20 77 69 74 68 20  compatible with 
37e0: 74 68 65 20 74 61 62 6c 65 20 61 74 74 61 63 68  the table attach
37f0: 65 64 20 74 6f 20 74 68 65 20 73 65 73 73 69 6f  ed to the sessio
3800: 6e 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 69  n by this functi
3810: 6f 6e 2e 0a 2a 2a 20 41 20 74 61 62 6c 65 20 69  on..** A table i
3820: 73 20 63 6f 6e 73 69 64 65 72 65 64 20 63 6f 6d  s considered com
3830: 70 61 74 69 62 6c 65 20 69 66 20 69 74 3a 0a 2a  patible if it:.*
3840: 2a 0a 2a 2a 20 3c 75 6c 3e 0a 2a 2a 20 20 20 3c  *.** <ul>.**   <
3850: 6c 69 3e 20 48 61 73 20 74 68 65 20 73 61 6d 65  li> Has the same
3860: 20 6e 61 6d 65 2c 0a 2a 2a 20 20 20 3c 6c 69 3e   name,.**   <li>
3870: 20 48 61 73 20 74 68 65 20 73 61 6d 65 20 73 65   Has the same se
3880: 74 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 64 65 63  t of columns dec
3890: 6c 61 72 65 64 20 69 6e 20 74 68 65 20 73 61 6d  lared in the sam
38a0: 65 20 6f 72 64 65 72 2c 20 61 6e 64 0a 2a 2a 20  e order, and.** 
38b0: 20 20 3c 6c 69 3e 20 48 61 73 20 74 68 65 20 73    <li> Has the s
38c0: 61 6d 65 20 50 52 49 4d 41 52 59 20 4b 45 59 20  ame PRIMARY KEY 
38d0: 64 65 66 69 6e 69 74 69 6f 6e 2e 0a 2a 2a 20 3c  definition..** <
38e0: 2f 75 6c 3e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68  /ul>.**.** If th
38f0: 65 20 74 61 62 6c 65 73 20 61 72 65 20 6e 6f 74  e tables are not
3900: 20 63 6f 6d 70 61 74 69 62 6c 65 2c 20 53 51 4c   compatible, SQL
3910: 49 54 45 5f 53 43 48 45 4d 41 20 69 73 20 72 65  ITE_SCHEMA is re
3920: 74 75 72 6e 65 64 2e 20 49 66 20 74 68 65 20 74  turned. If the t
3930: 61 62 6c 65 73 0a 2a 2a 20 61 72 65 20 63 6f 6d  ables.** are com
3940: 70 61 74 69 62 6c 65 20 62 75 74 20 64 6f 20 6e  patible but do n
3950: 6f 74 20 68 61 76 65 20 61 6e 79 20 50 52 49 4d  ot have any PRIM
3960: 41 52 59 20 4b 45 59 20 63 6f 6c 75 6d 6e 73 2c  ARY KEY columns,
3970: 20 69 74 20 69 73 20 6e 6f 74 20 61 6e 20 65 72   it is not an er
3980: 72 6f 72 0a 2a 2a 20 62 75 74 20 6e 6f 20 63 68  ror.** but no ch
3990: 61 6e 67 65 73 20 61 72 65 20 61 64 64 65 64 20  anges are added 
39a0: 74 6f 20 74 68 65 20 73 65 73 73 69 6f 6e 20 6f  to the session o
39b0: 62 6a 65 63 74 2e 20 41 73 20 77 69 74 68 20 6f  bject. As with o
39c0: 74 68 65 72 20 73 65 73 73 69 6f 6e 0a 2a 2a 20  ther session.** 
39d0: 41 50 49 73 2c 20 74 61 62 6c 65 73 20 77 69 74  APIs, tables wit
39e0: 68 6f 75 74 20 50 52 49 4d 41 52 59 20 4b 45 59  hout PRIMARY KEY
39f0: 73 20 61 72 65 20 73 69 6d 70 6c 79 20 69 67 6e  s are simply ign
3a00: 6f 72 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73  ored..**.** This
3a10: 20 66 75 6e 63 74 69 6f 6e 20 61 64 64 73 20 61   function adds a
3a20: 20 73 65 74 20 6f 66 20 63 68 61 6e 67 65 73 20   set of changes 
3a30: 74 6f 20 74 68 65 20 73 65 73 73 69 6f 6e 20 6f  to the session o
3a40: 62 6a 65 63 74 20 74 68 61 74 20 63 6f 75 6c 64  bject that could
3a50: 20 62 65 0a 2a 2a 20 75 73 65 64 20 74 6f 20 75   be.** used to u
3a60: 70 64 61 74 65 20 74 68 65 20 74 61 62 6c 65 20  pdate the table 
3a70: 69 6e 20 64 61 74 61 62 61 73 65 20 7a 46 72 6f  in database zFro
3a80: 6d 20 28 63 61 6c 6c 20 74 68 69 73 20 74 68 65  m (call this the
3a90: 20 22 66 72 6f 6d 2d 74 61 62 6c 65 22 29 20 0a   "from-table") .
3aa0: 2a 2a 20 73 6f 20 74 68 61 74 20 69 74 73 20 63  ** so that its c
3ab0: 6f 6e 74 65 6e 74 20 69 73 20 74 68 65 20 73 61  ontent is the sa
3ac0: 6d 65 20 61 73 20 74 68 65 20 74 61 62 6c 65 20  me as the table 
3ad0: 61 74 74 61 63 68 65 64 20 74 6f 20 74 68 65 20  attached to the 
3ae0: 73 65 73 73 69 6f 6e 20 0a 2a 2a 20 6f 62 6a 65  session .** obje
3af0: 63 74 20 28 63 61 6c 6c 20 74 68 69 73 20 74 68  ct (call this th
3b00: 65 20 22 74 6f 2d 74 61 62 6c 65 22 29 2e 20 53  e "to-table"). S
3b10: 70 65 63 69 66 69 63 61 6c 6c 79 3a 0a 2a 2a 0a  pecifically:.**.
3b20: 2a 2a 20 3c 75 6c 3e 0a 2a 2a 20 20 20 3c 6c 69  ** <ul>.**   <li
3b30: 3e 20 46 6f 72 20 65 61 63 68 20 72 6f 77 20 28  > For each row (
3b40: 70 72 69 6d 61 72 79 20 6b 65 79 29 20 74 68 61  primary key) tha
3b50: 74 20 65 78 69 73 74 73 20 69 6e 20 74 68 65 20  t exists in the 
3b60: 74 6f 2d 74 61 62 6c 65 20 62 75 74 20 6e 6f 74  to-table but not
3b70: 20 69 6e 20 0a 2a 2a 20 20 20 20 20 74 68 65 20   in .**     the 
3b80: 66 72 6f 6d 2d 74 61 62 6c 65 2c 20 61 6e 20 49  from-table, an I
3b90: 4e 53 45 52 54 20 72 65 63 6f 72 64 20 69 73 20  NSERT record is 
3ba0: 61 64 64 65 64 20 74 6f 20 74 68 65 20 73 65 73  added to the ses
3bb0: 73 69 6f 6e 20 6f 62 6a 65 63 74 2e 0a 2a 2a 0a  sion object..**.
3bc0: 2a 2a 20 20 20 3c 6c 69 3e 20 46 6f 72 20 65 61  **   <li> For ea
3bd0: 63 68 20 72 6f 77 20 28 70 72 69 6d 61 72 79 20  ch row (primary 
3be0: 6b 65 79 29 20 74 68 61 74 20 65 78 69 73 74 73  key) that exists
3bf0: 20 69 6e 20 74 68 65 20 74 6f 2d 74 61 62 6c 65   in the to-table
3c00: 20 62 75 74 20 6e 6f 74 20 69 6e 20 0a 2a 2a 20   but not in .** 
3c10: 20 20 20 20 74 68 65 20 66 72 6f 6d 2d 74 61 62      the from-tab
3c20: 6c 65 2c 20 61 20 44 45 4c 45 54 45 20 72 65 63  le, a DELETE rec
3c30: 6f 72 64 20 69 73 20 61 64 64 65 64 20 74 6f 20  ord is added to 
3c40: 74 68 65 20 73 65 73 73 69 6f 6e 20 6f 62 6a 65  the session obje
3c50: 63 74 2e 0a 2a 2a 0a 2a 2a 20 20 20 3c 6c 69 3e  ct..**.**   <li>
3c60: 20 46 6f 72 20 65 61 63 68 20 72 6f 77 20 28 70   For each row (p
3c70: 72 69 6d 61 72 79 20 6b 65 79 29 20 74 68 61 74  rimary key) that
3c80: 20 65 78 69 73 74 73 20 69 6e 20 62 6f 74 68 20   exists in both 
3c90: 74 61 62 6c 65 73 2c 20 62 75 74 20 66 65 61 74  tables, but feat
3ca0: 75 72 65 73 20 0a 2a 2a 20 20 20 20 20 64 69 66  ures .**     dif
3cb0: 66 65 72 65 6e 74 20 69 6e 20 65 61 63 68 2c 20  ferent in each, 
3cc0: 61 6e 20 55 50 44 41 54 45 20 72 65 63 6f 72 64  an UPDATE record
3cd0: 20 69 73 20 61 64 64 65 64 20 74 6f 20 74 68 65   is added to the
3ce0: 20 73 65 73 73 69 6f 6e 2e 0a 2a 2a 20 3c 2f 75   session..** </u
3cf0: 6c 3e 0a 2a 2a 0a 2a 2a 20 54 6f 20 63 6c 61 72  l>.**.** To clar
3d00: 69 66 79 2c 20 69 66 20 74 68 69 73 20 66 75 6e  ify, if this fun
3d10: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20  ction is called 
3d20: 61 6e 64 20 74 68 65 6e 20 61 20 63 68 61 6e 67  and then a chang
3d30: 65 73 65 74 20 63 6f 6e 73 74 72 75 63 74 65 64  eset constructed
3d40: 0a 2a 2a 20 75 73 69 6e 67 20 5b 73 71 6c 69 74  .** using [sqlit
3d50: 65 33 73 65 73 73 69 6f 6e 5f 63 68 61 6e 67 65  e3session_change
3d60: 73 65 74 28 29 5d 2c 20 74 68 65 6e 20 61 66 74  set()], then aft
3d70: 65 72 20 61 70 70 6c 79 69 6e 67 20 74 68 61 74  er applying that
3d80: 20 63 68 61 6e 67 65 73 65 74 20 74 6f 20 0a 2a   changeset to .*
3d90: 2a 20 64 61 74 61 62 61 73 65 20 7a 46 72 6f 6d  * database zFrom
3da0: 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66   the contents of
3db0: 20 74 68 65 20 74 77 6f 20 63 6f 6d 70 61 74 69   the two compati
3dc0: 62 6c 65 20 74 61 62 6c 65 73 20 77 6f 75 6c 64  ble tables would
3dd0: 20 62 65 20 0a 2a 2a 20 69 64 65 6e 74 69 63 61   be .** identica
3de0: 6c 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 61 6e 20 65  l..**.** It an e
3df0: 72 72 6f 72 20 69 66 20 64 61 74 61 62 61 73 65  rror if database
3e00: 20 7a 46 72 6f 6d 20 64 6f 65 73 20 6e 6f 74 20   zFrom does not 
3e10: 65 78 69 73 74 20 6f 72 20 64 6f 65 73 20 6e 6f  exist or does no
3e20: 74 20 63 6f 6e 74 61 69 6e 20 74 68 65 0a 2a 2a  t contain the.**
3e30: 20 72 65 71 75 69 72 65 64 20 63 6f 6d 70 61 74   required compat
3e40: 69 62 6c 65 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a  ible table..**.*
3e50: 2a 20 49 66 20 74 68 65 20 6f 70 65 72 61 74 69  * If the operati
3e60: 6f 6e 20 73 75 63 63 65 73 73 66 75 6c 2c 20 53  on successful, S
3e70: 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75  QLITE_OK is retu
3e80: 72 6e 65 64 2e 20 4f 74 68 65 72 77 69 73 65 2c  rned. Otherwise,
3e90: 20 61 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 65 72   an SQLite.** er
3ea0: 72 6f 72 20 63 6f 64 65 2e 20 49 6e 20 74 68 69  ror code. In thi
3eb0: 73 20 63 61 73 65 2c 20 69 66 20 61 72 67 75 6d  s case, if argum
3ec0: 65 6e 74 20 70 7a 45 72 72 4d 73 67 20 69 73 20  ent pzErrMsg is 
3ed0: 6e 6f 74 20 4e 55 4c 4c 2c 20 2a 70 7a 45 72 72  not NULL, *pzErr
3ee0: 4d 73 67 0a 2a 2a 20 6d 61 79 20 62 65 20 73 65  Msg.** may be se
3ef0: 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 61 20  t to point to a 
3f00: 62 75 66 66 65 72 20 63 6f 6e 74 61 69 6e 69 6e  buffer containin
3f10: 67 20 61 6e 20 45 6e 67 6c 69 73 68 20 6c 61 6e  g an English lan
3f20: 67 75 61 67 65 20 65 72 72 6f 72 20 0a 2a 2a 20  guage error .** 
3f30: 6d 65 73 73 61 67 65 2e 20 49 74 20 69 73 20 74  message. It is t
3f40: 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74  he responsibilit
3f50: 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 20  y of the caller 
3f60: 74 6f 20 66 72 65 65 20 74 68 69 73 20 62 75 66  to free this buf
3f70: 66 65 72 20 75 73 69 6e 67 0a 2a 2a 20 73 71 6c  fer using.** sql
3f80: 69 74 65 33 5f 66 72 65 65 28 29 2e 0a 2a 2f 0a  ite3_free()..*/.
3f90: 69 6e 74 20 73 71 6c 69 74 65 33 73 65 73 73 69  int sqlite3sessi
3fa0: 6f 6e 5f 64 69 66 66 28 0a 20 20 73 71 6c 69 74  on_diff(.  sqlit
3fb0: 65 33 5f 73 65 73 73 69 6f 6e 20 2a 70 53 65 73  e3_session *pSes
3fc0: 73 69 6f 6e 2c 0a 20 20 63 6f 6e 73 74 20 63 68  sion,.  const ch
3fd0: 61 72 20 2a 7a 46 72 6f 6d 44 62 2c 0a 20 20 63  ar *zFromDb,.  c
3fe0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 62 6c 2c  onst char *zTbl,
3ff0: 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d  .  char **pzErrM
4000: 73 67 0a 29 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 43 41  sg.);.../*.** CA
4010: 50 49 33 52 45 46 3a 20 47 65 6e 65 72 61 74 65  PI3REF: Generate
4020: 20 41 20 50 61 74 63 68 73 65 74 20 46 72 6f 6d   A Patchset From
4030: 20 41 20 53 65 73 73 69 6f 6e 20 4f 62 6a 65 63   A Session Objec
4040: 74 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64 69 66 66  t.**.** The diff
4050: 65 72 65 6e 63 65 73 20 62 65 74 77 65 65 6e 20  erences between 
4060: 61 20 70 61 74 63 68 73 65 74 20 61 6e 64 20 61  a patchset and a
4070: 20 63 68 61 6e 67 65 73 65 74 20 61 72 65 20 74   changeset are t
4080: 68 61 74 3a 0a 2a 2a 0a 2a 2a 20 3c 75 6c 3e 0a  hat:.**.** <ul>.
4090: 2a 2a 20 20 20 3c 6c 69 3e 20 44 45 4c 45 54 45  **   <li> DELETE
40a0: 20 72 65 63 6f 72 64 73 20 63 6f 6e 73 69 73 74   records consist
40b0: 20 6f 66 20 74 68 65 20 70 72 69 6d 61 72 79 20   of the primary 
40c0: 6b 65 79 20 66 69 65 6c 64 73 20 6f 6e 6c 79 2e  key fields only.
40d0: 20 54 68 65 20 0a 2a 2a 20 20 20 20 20 20 20 20   The .**        
40e0: 6f 72 69 67 69 6e 61 6c 20 76 61 6c 75 65 73 20  original values 
40f0: 6f 66 20 6f 74 68 65 72 20 66 69 65 6c 64 73 20  of other fields 
4100: 61 72 65 20 6f 6d 69 74 74 65 64 2e 0a 2a 2a 20  are omitted..** 
4110: 20 20 3c 6c 69 3e 20 54 68 65 20 6f 72 69 67 69    <li> The origi
4120: 6e 61 6c 20 76 61 6c 75 65 73 20 6f 66 20 61 6e  nal values of an
4130: 79 20 6d 6f 64 69 66 69 65 64 20 66 69 65 6c 64  y modified field
4140: 73 20 61 72 65 20 6f 6d 69 74 74 65 64 20 66 72  s are omitted fr
4150: 6f 6d 20 0a 2a 2a 20 20 20 20 20 20 20 20 55 50  om .**        UP
4160: 44 41 54 45 20 72 65 63 6f 72 64 73 2e 0a 2a 2a  DATE records..**
4170: 20 3c 2f 75 6c 3e 0a 2a 2a 0a 2a 2a 20 41 20 70   </ul>.**.** A p
4180: 61 74 63 68 73 65 74 20 62 6c 6f 62 20 6d 61 79  atchset blob may
4190: 20 62 65 20 75 73 65 64 20 77 69 74 68 20 75 70   be used with up
41a0: 20 74 6f 20 64 61 74 65 20 76 65 72 73 69 6f 6e   to date version
41b0: 73 20 6f 66 20 61 6c 6c 20 0a 2a 2a 20 73 71 6c  s of all .** sql
41c0: 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f 78 78  ite3changeset_xx
41d0: 78 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 20  x API functions 
41e0: 65 78 63 65 70 74 20 66 6f 72 20 73 71 6c 69 74  except for sqlit
41f0: 65 33 63 68 61 6e 67 65 73 65 74 5f 69 6e 76 65  e3changeset_inve
4200: 72 74 28 29 2c 20 0a 2a 2a 20 77 68 69 63 68 20  rt(), .** which 
4210: 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 43  returns SQLITE_C
4220: 4f 52 52 55 50 54 20 69 66 20 69 74 20 69 73 20  ORRUPT if it is 
4230: 70 61 73 73 65 64 20 61 20 70 61 74 63 68 73 65  passed a patchse
4240: 74 2e 20 53 69 6d 69 6c 61 72 6c 79 2c 0a 2a 2a  t. Similarly,.**
4250: 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 75   attempting to u
4260: 73 65 20 61 20 70 61 74 63 68 73 65 74 20 62 6c  se a patchset bl
4270: 6f 62 20 77 69 74 68 20 6f 6c 64 20 76 65 72 73  ob with old vers
4280: 69 6f 6e 73 20 6f 66 20 74 68 65 0a 2a 2a 20 73  ions of the.** s
4290: 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f  qlite3changeset_
42a0: 78 78 78 20 41 50 49 73 20 61 6c 73 6f 20 70 72  xxx APIs also pr
42b0: 6f 76 6f 6b 65 73 20 61 6e 20 53 51 4c 49 54 45  ovokes an SQLITE
42c0: 5f 43 4f 52 52 55 50 54 20 65 72 72 6f 72 2e 20  _CORRUPT error. 
42d0: 0a 2a 2a 0a 2a 2a 20 42 65 63 61 75 73 65 20 74  .**.** Because t
42e0: 68 65 20 6e 6f 6e 2d 70 72 69 6d 61 72 79 20 6b  he non-primary k
42f0: 65 79 20 22 6f 6c 64 2e 2a 22 20 66 69 65 6c 64  ey "old.*" field
4300: 73 20 61 72 65 20 6f 6d 69 74 74 65 64 2c 20 6e  s are omitted, n
4310: 6f 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 48 41  o .** SQLITE_CHA
4320: 4e 47 45 53 45 54 5f 44 41 54 41 20 63 6f 6e 66  NGESET_DATA conf
4330: 6c 69 63 74 73 20 63 61 6e 20 62 65 20 64 65 74  licts can be det
4340: 65 63 74 65 64 20 6f 72 20 72 65 70 6f 72 74 65  ected or reporte
4350: 64 20 69 66 20 61 20 70 61 74 63 68 73 65 74 0a  d if a patchset.
4360: 2a 2a 20 69 73 20 70 61 73 73 65 64 20 74 6f 20  ** is passed to 
4370: 74 68 65 20 73 71 6c 69 74 65 33 63 68 61 6e 67  the sqlite3chang
4380: 65 73 65 74 5f 61 70 70 6c 79 28 29 20 41 50 49  eset_apply() API
4390: 2e 20 4f 74 68 65 72 20 63 6f 6e 66 6c 69 63 74  . Other conflict
43a0: 20 74 79 70 65 73 20 77 6f 72 6b 0a 2a 2a 20 69   types work.** i
43b0: 6e 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 61  n the same way a
43c0: 73 20 66 6f 72 20 63 68 61 6e 67 65 73 65 74 73  s for changesets
43d0: 2e 0a 2a 2a 0a 2a 2a 20 43 68 61 6e 67 65 73 20  ..**.** Changes 
43e0: 77 69 74 68 69 6e 20 61 20 70 61 74 63 68 73 65  within a patchse
43f0: 74 20 61 72 65 20 6f 72 64 65 72 65 64 20 69 6e  t are ordered in
4400: 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 73   the same way as
4410: 20 66 6f 72 20 63 68 61 6e 67 65 73 65 74 73 0a   for changesets.
4420: 2a 2a 20 67 65 6e 65 72 61 74 65 64 20 62 79 20  ** generated by 
4430: 74 68 65 20 73 71 6c 69 74 65 33 73 65 73 73 69  the sqlite3sessi
4440: 6f 6e 5f 63 68 61 6e 67 65 73 65 74 28 29 20 66  on_changeset() f
4450: 75 6e 63 74 69 6f 6e 20 28 69 2e 65 2e 20 61 6c  unction (i.e. al
4460: 6c 20 63 68 61 6e 67 65 73 20 66 6f 72 0a 2a 2a  l changes for.**
4470: 20 61 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 20   a single table 
4480: 61 72 65 20 67 72 6f 75 70 65 64 20 74 6f 67 65  are grouped toge
4490: 74 68 65 72 2c 20 74 61 62 6c 65 73 20 61 70 70  ther, tables app
44a0: 65 61 72 20 69 6e 20 74 68 65 20 6f 72 64 65 72  ear in the order
44b0: 20 69 6e 20 77 68 69 63 68 0a 2a 2a 20 74 68 65   in which.** the
44c0: 79 20 77 65 72 65 20 61 74 74 61 63 68 65 64 20  y were attached 
44d0: 74 6f 20 74 68 65 20 73 65 73 73 69 6f 6e 20 6f  to the session o
44e0: 62 6a 65 63 74 29 2e 0a 2a 2f 0a 69 6e 74 20 73  bject)..*/.int s
44f0: 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 70 61  qlite3session_pa
4500: 74 63 68 73 65 74 28 0a 20 20 73 71 6c 69 74 65  tchset(.  sqlite
4510: 33 5f 73 65 73 73 69 6f 6e 20 2a 70 53 65 73 73  3_session *pSess
4520: 69 6f 6e 2c 20 20 20 20 20 20 2f 2a 20 53 65 73  ion,      /* Ses
4530: 73 69 6f 6e 20 6f 62 6a 65 63 74 20 2a 2f 0a 20  sion object */. 
4540: 20 69 6e 74 20 2a 70 6e 50 61 74 63 68 73 65 74   int *pnPatchset
4550: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
4560: 20 2f 2a 20 4f 55 54 3a 20 53 69 7a 65 20 6f 66   /* OUT: Size of
4570: 20 62 75 66 66 65 72 20 61 74 20 2a 70 70 43 68   buffer at *ppCh
4580: 61 6e 67 65 73 65 74 20 2a 2f 0a 20 20 76 6f 69  angeset */.  voi
4590: 64 20 2a 2a 70 70 50 61 74 63 68 73 65 74 20 20  d **ppPatchset  
45a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
45b0: 4f 55 54 3a 20 42 75 66 66 65 72 20 63 6f 6e 74  OUT: Buffer cont
45c0: 61 69 6e 69 6e 67 20 63 68 61 6e 67 65 73 65 74  aining changeset
45d0: 20 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 43 41   */.);../*.** CA
45e0: 50 49 33 52 45 46 3a 20 54 65 73 74 20 69 66 20  PI3REF: Test if 
45f0: 61 20 63 68 61 6e 67 65 73 65 74 20 68 61 73 20  a changeset has 
4600: 72 65 63 6f 72 64 65 64 20 61 6e 79 20 63 68 61  recorded any cha
4610: 6e 67 65 73 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75  nges..**.** Retu
4620: 72 6e 20 6e 6f 6e 2d 7a 65 72 6f 20 69 66 20 6e  rn non-zero if n
4630: 6f 20 63 68 61 6e 67 65 73 20 74 6f 20 61 74 74  o changes to att
4640: 61 63 68 65 64 20 74 61 62 6c 65 73 20 68 61 76  ached tables hav
4650: 65 20 62 65 65 6e 20 72 65 63 6f 72 64 65 64 20  e been recorded 
4660: 62 79 20 0a 2a 2a 20 74 68 65 20 73 65 73 73 69  by .** the sessi
4670: 6f 6e 20 6f 62 6a 65 63 74 20 70 61 73 73 65 64  on object passed
4680: 20 61 73 20 74 68 65 20 66 69 72 73 74 20 61 72   as the first ar
4690: 67 75 6d 65 6e 74 2e 20 4f 74 68 65 72 77 69 73  gument. Otherwis
46a0: 65 2c 20 69 66 20 6f 6e 65 20 6f 72 20 0a 2a 2a  e, if one or .**
46b0: 20 6d 6f 72 65 20 63 68 61 6e 67 65 73 20 68 61   more changes ha
46c0: 76 65 20 62 65 65 6e 20 72 65 63 6f 72 64 65 64  ve been recorded
46d0: 2c 20 72 65 74 75 72 6e 20 7a 65 72 6f 2e 0a 2a  , return zero..*
46e0: 2a 0a 2a 2a 20 45 76 65 6e 20 69 66 20 74 68 69  *.** Even if thi
46f0: 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72  s function retur
4700: 6e 73 20 7a 65 72 6f 2c 20 69 74 20 69 73 20 70  ns zero, it is p
4710: 6f 73 73 69 62 6c 65 20 74 68 61 74 20 63 61 6c  ossible that cal
4720: 6c 69 6e 67 0a 2a 2a 20 5b 73 71 6c 69 74 65 33  ling.** [sqlite3
4730: 73 65 73 73 69 6f 6e 5f 63 68 61 6e 67 65 73 65  session_changese
4740: 74 28 29 5d 20 6f 6e 20 74 68 65 20 73 65 73 73  t()] on the sess
4750: 69 6f 6e 20 68 61 6e 64 6c 65 20 6d 61 79 20 73  ion handle may s
4760: 74 69 6c 6c 20 72 65 74 75 72 6e 20 61 0a 2a 2a  till return a.**
4770: 20 63 68 61 6e 67 65 73 65 74 20 74 68 61 74 20   changeset that 
4780: 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 63 68 61 6e  contains no chan
4790: 67 65 73 2e 20 54 68 69 73 20 63 61 6e 20 68 61  ges. This can ha
47a0: 70 70 65 6e 20 77 68 65 6e 20 61 20 72 6f 77 20  ppen when a row 
47b0: 69 6e 20 0a 2a 2a 20 61 6e 20 61 74 74 61 63 68  in .** an attach
47c0: 65 64 20 74 61 62 6c 65 20 69 73 20 6d 6f 64 69  ed table is modi
47d0: 66 69 65 64 20 61 6e 64 20 74 68 65 6e 20 6c 61  fied and then la
47e0: 74 65 72 20 6f 6e 20 74 68 65 20 6f 72 69 67 69  ter on the origi
47f0: 6e 61 6c 20 76 61 6c 75 65 73 20 0a 2a 2a 20 61  nal values .** a
4800: 72 65 20 72 65 73 74 6f 72 65 64 2e 20 48 6f 77  re restored. How
4810: 65 76 65 72 2c 20 69 66 20 74 68 69 73 20 66 75  ever, if this fu
4820: 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 6e  nction returns n
4830: 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 69 74  on-zero, then it
4840: 20 69 73 0a 2a 2a 20 67 75 61 72 61 6e 74 65 65   is.** guarantee
4850: 64 20 74 68 61 74 20 61 20 63 61 6c 6c 20 74 6f  d that a call to
4860: 20 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f   sqlite3session_
4870: 63 68 61 6e 67 65 73 65 74 28 29 20 77 69 6c 6c  changeset() will
4880: 20 72 65 74 75 72 6e 20 61 20 0a 2a 2a 20 63 68   return a .** ch
4890: 61 6e 67 65 73 65 74 20 63 6f 6e 74 61 69 6e 69  angeset containi
48a0: 6e 67 20 7a 65 72 6f 20 63 68 61 6e 67 65 73 2e  ng zero changes.
48b0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 73  .*/.int sqlite3s
48c0: 65 73 73 69 6f 6e 5f 69 73 65 6d 70 74 79 28 73  ession_isempty(s
48d0: 71 6c 69 74 65 33 5f 73 65 73 73 69 6f 6e 20 2a  qlite3_session *
48e0: 70 53 65 73 73 69 6f 6e 29 3b 0a 0a 2f 2a 0a 2a  pSession);../*.*
48f0: 2a 20 43 41 50 49 33 52 45 46 3a 20 43 72 65 61  * CAPI3REF: Crea
4900: 74 65 20 41 6e 20 49 74 65 72 61 74 6f 72 20 54  te An Iterator T
4910: 6f 20 54 72 61 76 65 72 73 65 20 41 20 43 68 61  o Traverse A Cha
4920: 6e 67 65 73 65 74 20 0a 2a 2a 0a 2a 2a 20 43 72  ngeset .**.** Cr
4930: 65 61 74 65 20 61 6e 20 69 74 65 72 61 74 6f 72  eate an iterator
4940: 20 75 73 65 64 20 74 6f 20 69 74 65 72 61 74 65   used to iterate
4950: 20 74 68 72 6f 75 67 68 20 74 68 65 20 63 6f 6e   through the con
4960: 74 65 6e 74 73 20 6f 66 20 61 20 63 68 61 6e 67  tents of a chang
4970: 65 73 65 74 2e 0a 2a 2a 20 49 66 20 73 75 63 63  eset..** If succ
4980: 65 73 73 66 75 6c 2c 20 2a 70 70 20 69 73 20 73  essful, *pp is s
4990: 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74  et to point to t
49a0: 68 65 20 69 74 65 72 61 74 6f 72 20 68 61 6e 64  he iterator hand
49b0: 6c 65 20 61 6e 64 20 53 51 4c 49 54 45 5f 4f 4b  le and SQLITE_OK
49c0: 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 2e  .** is returned.
49d0: 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 61   Otherwise, if a
49e0: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20  n error occurs, 
49f0: 2a 70 70 20 69 73 20 73 65 74 20 74 6f 20 7a 65  *pp is set to ze
4a00: 72 6f 20 61 6e 64 20 61 6e 0a 2a 2a 20 53 51 4c  ro and an.** SQL
4a10: 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 20 69  ite error code i
4a20: 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a  s returned..**.*
4a30: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
4a40: 66 75 6e 63 74 69 6f 6e 73 20 63 61 6e 20 62 65  functions can be
4a50: 20 75 73 65 64 20 74 6f 20 61 64 76 61 6e 63 65   used to advance
4a60: 20 61 6e 64 20 71 75 65 72 79 20 61 20 63 68 61   and query a cha
4a70: 6e 67 65 73 65 74 20 0a 2a 2a 20 69 74 65 72 61  ngeset .** itera
4a80: 74 6f 72 20 63 72 65 61 74 65 64 20 62 79 20 74  tor created by t
4a90: 68 69 73 20 66 75 6e 63 74 69 6f 6e 3a 0a 2a 2a  his function:.**
4aa0: 0a 2a 2a 20 3c 75 6c 3e 0a 2a 2a 20 20 20 3c 6c  .** <ul>.**   <l
4ab0: 69 3e 20 5b 73 71 6c 69 74 65 33 63 68 61 6e 67  i> [sqlite3chang
4ac0: 65 73 65 74 5f 6e 65 78 74 28 29 5d 0a 2a 2a 20  eset_next()].** 
4ad0: 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65 33 63    <li> [sqlite3c
4ae0: 68 61 6e 67 65 73 65 74 5f 6f 70 28 29 5d 0a 2a  hangeset_op()].*
4af0: 2a 20 20 20 3c 6c 69 3e 20 5b 73 71 6c 69 74 65  *   <li> [sqlite
4b00: 33 63 68 61 6e 67 65 73 65 74 5f 6e 65 77 28 29  3changeset_new()
4b10: 5d 0a 2a 2a 20 20 20 3c 6c 69 3e 20 5b 73 71 6c  ].**   <li> [sql
4b20: 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f 6f 6c  ite3changeset_ol
4b30: 64 28 29 5d 0a 2a 2a 20 3c 2f 75 6c 3e 0a 2a 2a  d()].** </ul>.**
4b40: 0a 2a 2a 20 49 74 20 69 73 20 74 68 65 20 72 65  .** It is the re
4b50: 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 6f 66 20  sponsibility of 
4b60: 74 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 65 76  the caller to ev
4b70: 65 6e 74 75 61 6c 6c 79 20 64 65 73 74 72 6f 79  entually destroy
4b80: 20 74 68 65 20 69 74 65 72 61 74 6f 72 0a 2a 2a   the iterator.**
4b90: 20 62 79 20 70 61 73 73 69 6e 67 20 69 74 20 74   by passing it t
4ba0: 6f 20 5b 73 71 6c 69 74 65 33 63 68 61 6e 67 65  o [sqlite3change
4bb0: 73 65 74 5f 66 69 6e 61 6c 69 7a 65 28 29 5d 2e  set_finalize()].
4bc0: 20 54 68 65 20 62 75 66 66 65 72 20 63 6f 6e 74   The buffer cont
4bd0: 61 69 6e 69 6e 67 20 74 68 65 0a 2a 2a 20 63 68  aining the.** ch
4be0: 61 6e 67 65 73 65 74 20 28 70 43 68 61 6e 67 65  angeset (pChange
4bf0: 73 65 74 29 20 6d 75 73 74 20 72 65 6d 61 69 6e  set) must remain
4c00: 20 76 61 6c 69 64 20 75 6e 74 69 6c 20 61 66 74   valid until aft
4c10: 65 72 20 74 68 65 20 69 74 65 72 61 74 6f 72 20  er the iterator 
4c20: 69 73 0a 2a 2a 20 64 65 73 74 72 6f 79 65 64 2e  is.** destroyed.
4c30: 0a 2a 2a 0a 2a 2a 20 41 73 73 75 6d 69 6e 67 20  .**.** Assuming 
4c40: 74 68 65 20 63 68 61 6e 67 65 73 65 74 20 62 6c  the changeset bl
4c50: 6f 62 20 77 61 73 20 63 72 65 61 74 65 64 20 62  ob was created b
4c60: 79 20 6f 6e 65 20 6f 66 20 74 68 65 0a 2a 2a 20  y one of the.** 
4c70: 5b 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f  [sqlite3session_
4c80: 63 68 61 6e 67 65 73 65 74 28 29 5d 2c 20 5b 73  changeset()], [s
4c90: 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f  qlite3changeset_
4ca0: 63 6f 6e 63 61 74 28 29 5d 20 6f 72 0a 2a 2a 20  concat()] or.** 
4cb0: 5b 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65  [sqlite3changese
4cc0: 74 5f 69 6e 76 65 72 74 28 29 5d 20 66 75 6e 63  t_invert()] func
4cd0: 74 69 6f 6e 73 2c 20 61 6c 6c 20 63 68 61 6e 67  tions, all chang
4ce0: 65 73 20 77 69 74 68 69 6e 20 74 68 65 20 63 68  es within the ch
4cf0: 61 6e 67 65 73 65 74 20 0a 2a 2a 20 74 68 61 74  angeset .** that
4d00: 20 61 70 70 6c 79 20 74 6f 20 61 20 73 69 6e 67   apply to a sing
4d10: 6c 65 20 74 61 62 6c 65 20 61 72 65 20 67 72 6f  le table are gro
4d20: 75 70 65 64 20 74 6f 67 65 74 68 65 72 2e 20 54  uped together. T
4d30: 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 77  his means that w
4d40: 68 65 6e 20 0a 2a 2a 20 61 6e 20 61 70 70 6c 69  hen .** an appli
4d50: 63 61 74 69 6f 6e 20 69 74 65 72 61 74 65 73 20  cation iterates 
4d60: 74 68 72 6f 75 67 68 20 61 20 63 68 61 6e 67 65  through a change
4d70: 73 65 74 20 75 73 69 6e 67 20 61 6e 20 69 74 65  set using an ite
4d80: 72 61 74 6f 72 20 63 72 65 61 74 65 64 20 62 79  rator created by
4d90: 20 0a 2a 2a 20 74 68 69 73 20 66 75 6e 63 74 69   .** this functi
4da0: 6f 6e 2c 20 61 6c 6c 20 63 68 61 6e 67 65 73 20  on, all changes 
4db0: 74 68 61 74 20 72 65 6c 61 74 65 20 74 6f 20 61  that relate to a
4dc0: 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 20 61 72   single table ar
4dd0: 65 20 76 69 73 69 74 65 64 20 0a 2a 2a 20 63 6f  e visited .** co
4de0: 6e 73 65 63 75 74 69 76 65 6c 79 2e 20 54 68 65  nsecutively. The
4df0: 72 65 20 69 73 20 6e 6f 20 63 68 61 6e 63 65 20  re is no chance 
4e00: 74 68 61 74 20 74 68 65 20 69 74 65 72 61 74 6f  that the iterato
4e10: 72 20 77 69 6c 6c 20 76 69 73 69 74 20 61 20 63  r will visit a c
4e20: 68 61 6e 67 65 20 0a 2a 2a 20 74 68 65 20 61 70  hange .** the ap
4e30: 70 6c 69 65 73 20 74 6f 20 74 61 62 6c 65 20 58  plies to table X
4e40: 2c 20 74 68 65 6e 20 6f 6e 65 20 66 6f 72 20 74  , then one for t
4e50: 61 62 6c 65 20 59 2c 20 61 6e 64 20 74 68 65 6e  able Y, and then
4e60: 20 6c 61 74 65 72 20 6f 6e 20 76 69 73 69 74 20   later on visit 
4e70: 0a 2a 2a 20 61 6e 6f 74 68 65 72 20 63 68 61 6e  .** another chan
4e80: 67 65 20 66 6f 72 20 74 61 62 6c 65 20 58 2e 0a  ge for table X..
4e90: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 63 68  */.int sqlite3ch
4ea0: 61 6e 67 65 73 65 74 5f 73 74 61 72 74 28 0a 20  angeset_start(. 
4eb0: 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73   sqlite3_changes
4ec0: 65 74 5f 69 74 65 72 20 2a 2a 70 70 2c 20 20 20  et_iter **pp,   
4ed0: 20 2f 2a 20 4f 55 54 3a 20 4e 65 77 20 63 68 61   /* OUT: New cha
4ee0: 6e 67 65 73 65 74 20 69 74 65 72 61 74 6f 72 20  ngeset iterator 
4ef0: 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 69 6e 74 20  handle */.  int 
4f00: 6e 43 68 61 6e 67 65 73 65 74 2c 20 20 20 20 20  nChangeset,     
4f10: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53              /* S
4f20: 69 7a 65 20 6f 66 20 63 68 61 6e 67 65 73 65 74  ize of changeset
4f30: 20 62 6c 6f 62 20 69 6e 20 62 79 74 65 73 20 2a   blob in bytes *
4f40: 2f 0a 20 20 76 6f 69 64 20 2a 70 43 68 61 6e 67  /.  void *pChang
4f50: 65 73 65 74 20 20 20 20 20 20 20 20 20 20 20 20  eset            
4f60: 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74      /* Pointer t
4f70: 6f 20 62 6c 6f 62 20 63 6f 6e 74 61 69 6e 69 6e  o blob containin
4f80: 67 20 63 68 61 6e 67 65 73 65 74 20 2a 2f 0a 29  g changeset */.)
4f90: 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 43 41 50 49 33 52  ;.../*.** CAPI3R
4fa0: 45 46 3a 20 41 64 76 61 6e 63 65 20 41 20 43 68  EF: Advance A Ch
4fb0: 61 6e 67 65 73 65 74 20 49 74 65 72 61 74 6f 72  angeset Iterator
4fc0: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  .**.** This func
4fd0: 74 69 6f 6e 20 6d 61 79 20 6f 6e 6c 79 20 62 65  tion may only be
4fe0: 20 75 73 65 64 20 77 69 74 68 20 69 74 65 72 61   used with itera
4ff0: 74 6f 72 73 20 63 72 65 61 74 65 64 20 62 79 20  tors created by 
5000: 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 5b 73 71 6c  function.** [sql
5010: 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f 73 74  ite3changeset_st
5020: 61 72 74 28 29 5d 2e 20 49 66 20 69 74 20 69 73  art()]. If it is
5030: 20 63 61 6c 6c 65 64 20 6f 6e 20 61 6e 20 69 74   called on an it
5040: 65 72 61 74 6f 72 20 70 61 73 73 65 64 20 74 6f  erator passed to
5050: 0a 2a 2a 20 61 20 63 6f 6e 66 6c 69 63 74 2d 68  .** a conflict-h
5060: 61 6e 64 6c 65 72 20 63 61 6c 6c 62 61 63 6b 20  andler callback 
5070: 62 79 20 5b 73 71 6c 69 74 65 33 63 68 61 6e 67  by [sqlite3chang
5080: 65 73 65 74 5f 61 70 70 6c 79 28 29 5d 2c 20 53  eset_apply()], S
5090: 51 4c 49 54 45 5f 4d 49 53 55 53 45 0a 2a 2a 20  QLITE_MISUSE.** 
50a0: 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20  is returned and 
50b0: 74 68 65 20 63 61 6c 6c 20 68 61 73 20 6e 6f 20  the call has no 
50c0: 65 66 66 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 49 6d  effect..**.** Im
50d0: 6d 65 64 69 61 74 65 6c 79 20 61 66 74 65 72 20  mediately after 
50e0: 61 6e 20 69 74 65 72 61 74 6f 72 20 69 73 20 63  an iterator is c
50f0: 72 65 61 74 65 64 20 62 79 20 73 71 6c 69 74 65  reated by sqlite
5100: 33 63 68 61 6e 67 65 73 65 74 5f 73 74 61 72 74  3changeset_start
5110: 28 29 2c 20 69 74 0a 2a 2a 20 64 6f 65 73 20 6e  (), it.** does n
5120: 6f 74 20 70 6f 69 6e 74 20 74 6f 20 61 6e 79 20  ot point to any 
5130: 63 68 61 6e 67 65 20 69 6e 20 74 68 65 20 63 68  change in the ch
5140: 61 6e 67 65 73 65 74 2e 20 41 73 73 75 6d 69 6e  angeset. Assumin
5150: 67 20 74 68 65 20 63 68 61 6e 67 65 73 65 74 0a  g the changeset.
5160: 2a 2a 20 69 73 20 6e 6f 74 20 65 6d 70 74 79 2c  ** is not empty,
5170: 20 74 68 65 20 66 69 72 73 74 20 63 61 6c 6c 20   the first call 
5180: 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  to this function
5190: 20 61 64 76 61 6e 63 65 73 20 74 68 65 20 69 74   advances the it
51a0: 65 72 61 74 6f 72 20 74 6f 0a 2a 2a 20 70 6f 69  erator to.** poi
51b0: 6e 74 20 74 6f 20 74 68 65 20 66 69 72 73 74 20  nt to the first 
51c0: 63 68 61 6e 67 65 20 69 6e 20 74 68 65 20 63 68  change in the ch
51d0: 61 6e 67 65 73 65 74 2e 20 45 61 63 68 20 73 75  angeset. Each su
51e0: 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 20 61 64  bsequent call ad
51f0: 76 61 6e 63 65 73 0a 2a 2a 20 74 68 65 20 69 74  vances.** the it
5200: 65 72 61 74 6f 72 20 74 6f 20 70 6f 69 6e 74 20  erator to point 
5210: 74 6f 20 74 68 65 20 6e 65 78 74 20 63 68 61 6e  to the next chan
5220: 67 65 20 69 6e 20 74 68 65 20 63 68 61 6e 67 65  ge in the change
5230: 73 65 74 20 28 69 66 20 61 6e 79 29 2e 20 49 66  set (if any). If
5240: 0a 2a 2a 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63  .** no error occ
5250: 75 72 73 20 61 6e 64 20 74 68 65 20 69 74 65 72  urs and the iter
5260: 61 74 6f 72 20 70 6f 69 6e 74 73 20 74 6f 20 61  ator points to a
5270: 20 76 61 6c 69 64 20 63 68 61 6e 67 65 20 61 66   valid change af
5280: 74 65 72 20 61 20 63 61 6c 6c 0a 2a 2a 20 74 6f  ter a call.** to
5290: 20 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65   sqlite3changese
52a0: 74 5f 6e 65 78 74 28 29 20 68 61 73 20 61 64 76  t_next() has adv
52b0: 61 6e 63 65 64 20 69 74 2c 20 53 51 4c 49 54 45  anced it, SQLITE
52c0: 5f 52 4f 57 20 69 73 20 72 65 74 75 72 6e 65 64  _ROW is returned
52d0: 2e 20 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c  . .** Otherwise,
52e0: 20 69 66 20 61 6c 6c 20 63 68 61 6e 67 65 73 20   if all changes 
52f0: 69 6e 20 74 68 65 20 63 68 61 6e 67 65 73 65 74  in the changeset
5300: 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 62 65   have already be
5310: 65 6e 20 76 69 73 69 74 65 64 2c 0a 2a 2a 20 53  en visited,.** S
5320: 51 4c 49 54 45 5f 44 4f 4e 45 20 69 73 20 72 65  QLITE_DONE is re
5330: 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66  turned..**.** If
5340: 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73   an error occurs
5350: 2c 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f  , an SQLite erro
5360: 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e  r code is return
5370: 65 64 2e 20 50 6f 73 73 69 62 6c 65 20 65 72 72  ed. Possible err
5380: 6f 72 20 0a 2a 2a 20 63 6f 64 65 73 20 69 6e 63  or .** codes inc
5390: 6c 75 64 65 20 53 51 4c 49 54 45 5f 43 4f 52 52  lude SQLITE_CORR
53a0: 55 50 54 20 28 69 66 20 74 68 65 20 63 68 61 6e  UPT (if the chan
53b0: 67 65 73 65 74 20 62 75 66 66 65 72 20 69 73 20  geset buffer is 
53c0: 63 6f 72 72 75 70 74 29 20 6f 72 20 0a 2a 2a 20  corrupt) or .** 
53d0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2e 0a 2a 2f  SQLITE_NOMEM..*/
53e0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 63 68 61 6e  .int sqlite3chan
53f0: 67 65 73 65 74 5f 6e 65 78 74 28 73 71 6c 69 74  geset_next(sqlit
5400: 65 33 5f 63 68 61 6e 67 65 73 65 74 5f 69 74 65  e3_changeset_ite
5410: 72 20 2a 70 49 74 65 72 29 3b 0a 0a 2f 2a 0a 2a  r *pIter);../*.*
5420: 2a 20 43 41 50 49 33 52 45 46 3a 20 4f 62 74 61  * CAPI3REF: Obta
5430: 69 6e 20 54 68 65 20 43 75 72 72 65 6e 74 20 4f  in The Current O
5440: 70 65 72 61 74 69 6f 6e 20 46 72 6f 6d 20 41 20  peration From A 
5450: 43 68 61 6e 67 65 73 65 74 20 49 74 65 72 61 74  Changeset Iterat
5460: 6f 72 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 49 74  or.**.** The pIt
5470: 65 72 20 61 72 67 75 6d 65 6e 74 20 70 61 73 73  er argument pass
5480: 65 64 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74  ed to this funct
5490: 69 6f 6e 20 6d 61 79 20 65 69 74 68 65 72 20 62  ion may either b
54a0: 65 20 61 6e 20 69 74 65 72 61 74 6f 72 0a 2a 2a  e an iterator.**
54b0: 20 70 61 73 73 65 64 20 74 6f 20 61 20 63 6f 6e   passed to a con
54c0: 66 6c 69 63 74 2d 68 61 6e 64 6c 65 72 20 62 79  flict-handler by
54d0: 20 5b 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73   [sqlite3changes
54e0: 65 74 5f 61 70 70 6c 79 28 29 5d 2c 20 6f 72 20  et_apply()], or 
54f0: 61 6e 20 69 74 65 72 61 74 6f 72 0a 2a 2a 20 63  an iterator.** c
5500: 72 65 61 74 65 64 20 62 79 20 5b 73 71 6c 69 74  reated by [sqlit
5510: 65 33 63 68 61 6e 67 65 73 65 74 5f 73 74 61 72  e3changeset_star
5520: 74 28 29 5d 2e 20 49 6e 20 74 68 65 20 6c 61 74  t()]. In the lat
5530: 74 65 72 20 63 61 73 65 2c 20 74 68 65 20 6d 6f  ter case, the mo
5540: 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 63 61 6c  st recent.** cal
5550: 6c 20 74 6f 20 5b 73 71 6c 69 74 65 33 63 68 61  l to [sqlite3cha
5560: 6e 67 65 73 65 74 5f 6e 65 78 74 28 29 5d 20 6d  ngeset_next()] m
5570: 75 73 74 20 68 61 76 65 20 72 65 74 75 72 6e 65  ust have returne
5580: 64 20 5b 53 51 4c 49 54 45 5f 52 4f 57 5d 2e 20  d [SQLITE_ROW]. 
5590: 49 66 20 74 68 69 73 0a 2a 2a 20 69 73 20 6e 6f  If this.** is no
55a0: 74 20 74 68 65 20 63 61 73 65 2c 20 74 68 69 73  t the case, this
55b0: 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e   function return
55c0: 73 20 5b 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  s [SQLITE_MISUSE
55d0: 5d 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 72 67 75  ]..**.** If argu
55e0: 6d 65 6e 74 20 70 7a 54 61 62 20 69 73 20 6e 6f  ment pzTab is no
55f0: 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 2a 70 7a  t NULL, then *pz
5600: 54 61 62 20 69 73 20 73 65 74 20 74 6f 20 70 6f  Tab is set to po
5610: 69 6e 74 20 74 6f 20 61 0a 2a 2a 20 6e 75 6c 2d  int to a.** nul-
5620: 74 65 72 6d 69 6e 61 74 65 64 20 75 74 66 2d 38  terminated utf-8
5630: 20 65 6e 63 6f 64 65 64 20 73 74 72 69 6e 67 20   encoded string 
5640: 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 6e  containing the n
5650: 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65  ame of the table
5660: 0a 2a 2a 20 61 66 66 65 63 74 65 64 20 62 79 20  .** affected by 
5670: 74 68 65 20 63 75 72 72 65 6e 74 20 63 68 61 6e  the current chan
5680: 67 65 2e 20 54 68 65 20 62 75 66 66 65 72 20 72  ge. The buffer r
5690: 65 6d 61 69 6e 73 20 76 61 6c 69 64 20 75 6e 74  emains valid unt
56a0: 69 6c 20 65 69 74 68 65 72 0a 2a 2a 20 73 71 6c  il either.** sql
56b0: 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f 6e 65  ite3changeset_ne
56c0: 78 74 28 29 20 69 73 20 63 61 6c 6c 65 64 20 6f  xt() is called o
56d0: 6e 20 74 68 65 20 69 74 65 72 61 74 6f 72 20 6f  n the iterator o
56e0: 72 20 75 6e 74 69 6c 20 74 68 65 20 0a 2a 2a 20  r until the .** 
56f0: 63 6f 6e 66 6c 69 63 74 2d 68 61 6e 64 6c 65 72  conflict-handler
5700: 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e   function return
5710: 73 2e 20 49 66 20 70 6e 43 6f 6c 20 69 73 20 6e  s. If pnCol is n
5720: 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 2a 70  ot NULL, then *p
5730: 6e 43 6f 6c 20 69 73 20 0a 2a 2a 20 73 65 74 20  nCol is .** set 
5740: 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  to the number of
5750: 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20   columns in the 
5760: 74 61 62 6c 65 20 61 66 66 65 63 74 65 64 20 62  table affected b
5770: 79 20 74 68 65 20 63 68 61 6e 67 65 2e 20 49 66  y the change. If
5780: 0a 2a 2a 20 70 62 49 6e 63 6f 72 72 65 63 74 20  .** pbIncorrect 
5790: 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65  is not NULL, the
57a0: 6e 20 2a 70 62 49 6e 64 69 72 65 63 74 20 69 73  n *pbIndirect is
57b0: 20 73 65 74 20 74 6f 20 74 72 75 65 20 28 31 29   set to true (1)
57c0: 20 69 66 20 74 68 65 20 63 68 61 6e 67 65 0a 2a   if the change.*
57d0: 2a 20 69 73 20 61 6e 20 69 6e 64 69 72 65 63 74  * is an indirect
57e0: 20 63 68 61 6e 67 65 2c 20 6f 72 20 66 61 6c 73   change, or fals
57f0: 65 20 28 30 29 20 6f 74 68 65 72 77 69 73 65 2e  e (0) otherwise.
5800: 20 53 65 65 20 74 68 65 20 64 6f 63 75 6d 65 6e   See the documen
5810: 74 61 74 69 6f 6e 20 66 6f 72 0a 2a 2a 20 5b 73  tation for.** [s
5820: 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 69 6e  qlite3session_in
5830: 64 69 72 65 63 74 28 29 5d 20 66 6f 72 20 61 20  direct()] for a 
5840: 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 64  description of d
5850: 69 72 65 63 74 20 61 6e 64 20 69 6e 64 69 72 65  irect and indire
5860: 63 74 0a 2a 2a 20 63 68 61 6e 67 65 73 2e 20 46  ct.** changes. F
5870: 69 6e 61 6c 6c 79 2c 20 69 66 20 70 4f 70 20 69  inally, if pOp i
5880: 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e  s not NULL, then
5890: 20 2a 70 4f 70 20 69 73 20 73 65 74 20 74 6f 20   *pOp is set to 
58a0: 6f 6e 65 20 6f 66 20 0a 2a 2a 20 5b 53 51 4c 49  one of .** [SQLI
58b0: 54 45 5f 49 4e 53 45 52 54 5d 2c 20 5b 53 51 4c  TE_INSERT], [SQL
58c0: 49 54 45 5f 44 45 4c 45 54 45 5d 20 6f 72 20 5b  ITE_DELETE] or [
58d0: 53 51 4c 49 54 45 5f 55 50 44 41 54 45 5d 2c 20  SQLITE_UPDATE], 
58e0: 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65  depending on the
58f0: 20 0a 2a 2a 20 74 79 70 65 20 6f 66 20 63 68 61   .** type of cha
5900: 6e 67 65 20 74 68 61 74 20 74 68 65 20 69 74 65  nge that the ite
5910: 72 61 74 6f 72 20 63 75 72 72 65 6e 74 6c 79 20  rator currently 
5920: 70 6f 69 6e 74 73 20 74 6f 2e 0a 2a 2a 0a 2a 2a  points to..**.**
5930: 20 49 66 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63   If no error occ
5940: 75 72 73 2c 20 53 51 4c 49 54 45 5f 4f 4b 20 69  urs, SQLITE_OK i
5950: 73 20 72 65 74 75 72 6e 65 64 2e 20 49 66 20 61  s returned. If a
5960: 6e 20 65 72 72 6f 72 20 64 6f 65 73 20 6f 63 63  n error does occ
5970: 75 72 2c 20 61 6e 0a 2a 2a 20 53 51 4c 69 74 65  ur, an.** SQLite
5980: 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72   error code is r
5990: 65 74 75 72 6e 65 64 2e 20 54 68 65 20 76 61 6c  eturned. The val
59a0: 75 65 73 20 6f 66 20 74 68 65 20 6f 75 74 70 75  ues of the outpu
59b0: 74 20 76 61 72 69 61 62 6c 65 73 20 6d 61 79 20  t variables may 
59c0: 6e 6f 74 0a 2a 2a 20 62 65 20 74 72 75 73 74 65  not.** be truste
59d0: 64 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 0a  d in this case..
59e0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 63 68  */.int sqlite3ch
59f0: 61 6e 67 65 73 65 74 5f 6f 70 28 0a 20 20 73 71  angeset_op(.  sq
5a00: 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 65 74 5f  lite3_changeset_
5a10: 69 74 65 72 20 2a 70 49 74 65 72 2c 20 20 2f 2a  iter *pIter,  /*
5a20: 20 49 74 65 72 61 74 6f 72 20 6f 62 6a 65 63 74   Iterator object
5a30: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72   */.  const char
5a40: 20 2a 2a 70 7a 54 61 62 2c 20 20 20 20 20 20 20   **pzTab,       
5a50: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 50 6f        /* OUT: Po
5a60: 69 6e 74 65 72 20 74 6f 20 74 61 62 6c 65 20 6e  inter to table n
5a70: 61 6d 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e  ame */.  int *pn
5a80: 43 6f 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20  Col,            
5a90: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
5aa0: 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d   Number of colum
5ab0: 6e 73 20 69 6e 20 74 61 62 6c 65 20 2a 2f 0a 20  ns in table */. 
5ac0: 20 69 6e 74 20 2a 70 4f 70 2c 20 20 20 20 20 20   int *pOp,      
5ad0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5ae0: 20 2f 2a 20 4f 55 54 3a 20 53 51 4c 49 54 45 5f   /* OUT: SQLITE_
5af0: 49 4e 53 45 52 54 2c 20 44 45 4c 45 54 45 20 6f  INSERT, DELETE o
5b00: 72 20 55 50 44 41 54 45 20 2a 2f 0a 20 20 69 6e  r UPDATE */.  in
5b10: 74 20 2a 70 62 49 6e 64 69 72 65 63 74 20 20 20  t *pbIndirect   
5b20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
5b30: 20 4f 55 54 3a 20 54 72 75 65 20 66 6f 72 20 61   OUT: True for a
5b40: 6e 20 27 69 6e 64 69 72 65 63 74 27 20 63 68 61  n 'indirect' cha
5b50: 6e 67 65 20 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a  nge */.);../*.**
5b60: 20 43 41 50 49 33 52 45 46 3a 20 4f 62 74 61 69   CAPI3REF: Obtai
5b70: 6e 20 54 68 65 20 50 72 69 6d 61 72 79 20 4b 65  n The Primary Ke
5b80: 79 20 44 65 66 69 6e 69 74 69 6f 6e 20 4f 66 20  y Definition Of 
5b90: 41 20 54 61 62 6c 65 0a 2a 2a 0a 2a 2a 20 46 6f  A Table.**.** Fo
5ba0: 72 20 65 61 63 68 20 6d 6f 64 69 66 69 65 64 20  r each modified 
5bb0: 74 61 62 6c 65 2c 20 61 20 63 68 61 6e 67 65 73  table, a changes
5bc0: 65 74 20 69 6e 63 6c 75 64 65 73 20 74 68 65 20  et includes the 
5bd0: 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a  following:.**.**
5be0: 20 3c 75 6c 3e 0a 2a 2a 20 20 20 3c 6c 69 3e 20   <ul>.**   <li> 
5bf0: 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f  The number of co
5c00: 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 74 61 62  lumns in the tab
5c10: 6c 65 2c 20 61 6e 64 0a 2a 2a 20 20 20 3c 6c 69  le, and.**   <li
5c20: 3e 20 57 68 69 63 68 20 6f 66 20 74 68 6f 73 65  > Which of those
5c30: 20 63 6f 6c 75 6d 6e 73 20 6d 61 6b 65 20 75 70   columns make up
5c40: 20 74 68 65 20 74 61 62 6c 65 73 20 50 52 49 4d   the tables PRIM
5c50: 41 52 59 20 4b 45 59 2e 0a 2a 2a 20 3c 2f 75 6c  ARY KEY..** </ul
5c60: 3e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  >.**.** This fun
5c70: 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f  ction is used to
5c80: 20 66 69 6e 64 20 77 68 69 63 68 20 63 6f 6c 75   find which colu
5c90: 6d 6e 73 20 63 6f 6d 70 72 69 73 65 20 74 68 65  mns comprise the
5ca0: 20 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 66 0a   PRIMARY KEY of.
5cb0: 2a 2a 20 74 68 65 20 74 61 62 6c 65 20 6d 6f 64  ** the table mod
5cc0: 69 66 69 65 64 20 62 79 20 74 68 65 20 63 68 61  ified by the cha
5cd0: 6e 67 65 20 74 68 61 74 20 69 74 65 72 61 74 6f  nge that iterato
5ce0: 72 20 70 49 74 65 72 20 63 75 72 72 65 6e 74 6c  r pIter currentl
5cf0: 79 20 70 6f 69 6e 74 73 20 74 6f 2e 0a 2a 2a 20  y points to..** 
5d00: 49 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 2a  If successful, *
5d10: 70 61 62 50 4b 20 69 73 20 73 65 74 20 74 6f 20  pabPK is set to 
5d20: 70 6f 69 6e 74 20 74 6f 20 61 6e 20 61 72 72 61  point to an arra
5d30: 79 20 6f 66 20 6e 43 6f 6c 20 65 6e 74 72 69 65  y of nCol entrie
5d40: 73 2c 20 77 68 65 72 65 0a 2a 2a 20 6e 43 6f 6c  s, where.** nCol
5d50: 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f   is the number o
5d60: 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65  f columns in the
5d70: 20 74 61 62 6c 65 2e 20 45 6c 65 6d 65 6e 74 73   table. Elements
5d80: 20 6f 66 20 2a 70 61 62 50 4b 20 61 72 65 20 73   of *pabPK are s
5d90: 65 74 20 74 6f 0a 2a 2a 20 30 78 30 31 20 69 66  et to.** 0x01 if
5da0: 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69   the correspondi
5db0: 6e 67 20 63 6f 6c 75 6d 6e 20 69 73 20 70 61 72  ng column is par
5dc0: 74 20 6f 66 20 74 68 65 20 74 61 62 6c 65 73 20  t of the tables 
5dd0: 70 72 69 6d 61 72 79 20 6b 65 79 2c 20 6f 72 0a  primary key, or.
5de0: 2a 2a 20 30 78 30 30 20 69 66 20 69 74 20 69 73  ** 0x00 if it is
5df0: 20 6e 6f 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61   not..**.** If a
5e00: 72 67 75 6d 65 6e 74 20 70 6e 43 6f 6c 20 69 73  rgument pnCol is
5e10: 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20   not NULL, then 
5e20: 2a 70 6e 43 6f 6c 20 69 73 20 73 65 74 20 74 6f  *pnCol is set to
5e30: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63   the number of c
5e40: 6f 6c 75 6d 6e 73 0a 2a 2a 20 69 6e 20 74 68 65  olumns.** in the
5e50: 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66   table..**.** If
5e60: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   this function i
5e70: 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 74 68  s called when th
5e80: 65 20 69 74 65 72 61 74 6f 72 20 64 6f 65 73 20  e iterator does 
5e90: 6e 6f 74 20 70 6f 69 6e 74 20 74 6f 20 61 20 76  not point to a v
5ea0: 61 6c 69 64 0a 2a 2a 20 65 6e 74 72 79 2c 20 53  alid.** entry, S
5eb0: 51 4c 49 54 45 5f 4d 49 53 55 53 45 20 69 73 20  QLITE_MISUSE is 
5ec0: 72 65 74 75 72 6e 65 64 20 61 6e 64 20 74 68 65  returned and the
5ed0: 20 6f 75 74 70 75 74 20 76 61 72 69 61 62 6c 65   output variable
5ee0: 73 20 7a 65 72 6f 65 64 2e 20 4f 74 68 65 72 77  s zeroed. Otherw
5ef0: 69 73 65 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f  ise,.** SQLITE_O
5f00: 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e  K is returned an
5f10: 64 20 74 68 65 20 6f 75 74 70 75 74 20 76 61 72  d the output var
5f20: 69 61 62 6c 65 73 20 70 6f 70 75 6c 61 74 65 64  iables populated
5f30: 20 61 73 20 64 65 73 63 72 69 62 65 64 0a 2a 2a   as described.**
5f40: 20 61 62 6f 76 65 2e 0a 2a 2f 0a 69 6e 74 20 73   above..*/.int s
5f50: 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f  qlite3changeset_
5f60: 70 6b 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 68  pk(.  sqlite3_ch
5f70: 61 6e 67 65 73 65 74 5f 69 74 65 72 20 2a 70 49  angeset_iter *pI
5f80: 74 65 72 2c 20 20 2f 2a 20 49 74 65 72 61 74 6f  ter,  /* Iterato
5f90: 72 20 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 75 6e  r object */.  un
5fa0: 73 69 67 6e 65 64 20 63 68 61 72 20 2a 2a 70 61  signed char **pa
5fb0: 62 50 4b 2c 20 20 20 20 20 20 20 20 20 20 2f 2a  bPK,          /*
5fc0: 20 4f 55 54 3a 20 41 72 72 61 79 20 6f 66 20 62   OUT: Array of b
5fd0: 6f 6f 6c 65 61 6e 20 2d 20 74 72 75 65 20 66 6f  oolean - true fo
5fe0: 72 20 50 4b 20 63 6f 6c 73 20 2a 2f 0a 20 20 69  r PK cols */.  i
5ff0: 6e 74 20 2a 70 6e 43 6f 6c 20 20 20 20 20 20 20  nt *pnCol       
6000: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
6010: 2a 20 4f 55 54 3a 20 4e 75 6d 62 65 72 20 6f 66  * OUT: Number of
6020: 20 65 6e 74 72 69 65 73 20 69 6e 20 6f 75 74 70   entries in outp
6030: 75 74 20 61 72 72 61 79 20 2a 2f 0a 29 3b 0a 0a  ut array */.);..
6040: 2f 2a 0a 2a 2a 20 43 41 50 49 33 52 45 46 3a 20  /*.** CAPI3REF: 
6050: 4f 62 74 61 69 6e 20 6f 6c 64 2e 2a 20 56 61 6c  Obtain old.* Val
6060: 75 65 73 20 46 72 6f 6d 20 41 20 43 68 61 6e 67  ues From A Chang
6070: 65 73 65 74 20 49 74 65 72 61 74 6f 72 0a 2a 2a  eset Iterator.**
6080: 0a 2a 2a 20 54 68 65 20 70 49 74 65 72 20 61 72  .** The pIter ar
6090: 67 75 6d 65 6e 74 20 70 61 73 73 65 64 20 74 6f  gument passed to
60a0: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d   this function m
60b0: 61 79 20 65 69 74 68 65 72 20 62 65 20 61 6e 20  ay either be an 
60c0: 69 74 65 72 61 74 6f 72 0a 2a 2a 20 70 61 73 73  iterator.** pass
60d0: 65 64 20 74 6f 20 61 20 63 6f 6e 66 6c 69 63 74  ed to a conflict
60e0: 2d 68 61 6e 64 6c 65 72 20 62 79 20 5b 73 71 6c  -handler by [sql
60f0: 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f 61 70  ite3changeset_ap
6100: 70 6c 79 28 29 5d 2c 20 6f 72 20 61 6e 20 69 74  ply()], or an it
6110: 65 72 61 74 6f 72 0a 2a 2a 20 63 72 65 61 74 65  erator.** create
6120: 64 20 62 79 20 5b 73 71 6c 69 74 65 33 63 68 61  d by [sqlite3cha
6130: 6e 67 65 73 65 74 5f 73 74 61 72 74 28 29 5d 2e  ngeset_start()].
6140: 20 49 6e 20 74 68 65 20 6c 61 74 74 65 72 20 63   In the latter c
6150: 61 73 65 2c 20 74 68 65 20 6d 6f 73 74 20 72 65  ase, the most re
6160: 63 65 6e 74 0a 2a 2a 20 63 61 6c 6c 20 74 6f 20  cent.** call to 
6170: 5b 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65  [sqlite3changese
6180: 74 5f 6e 65 78 74 28 29 5d 20 6d 75 73 74 20 68  t_next()] must h
6190: 61 76 65 20 72 65 74 75 72 6e 65 64 20 53 51 4c  ave returned SQL
61a0: 49 54 45 5f 52 4f 57 2e 20 0a 2a 2a 20 46 75 72  ITE_ROW. .** Fur
61b0: 74 68 65 72 6d 6f 72 65 2c 20 69 74 20 6d 61 79  thermore, it may
61c0: 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64 20   only be called 
61d0: 69 66 20 74 68 65 20 74 79 70 65 20 6f 66 20 63  if the type of c
61e0: 68 61 6e 67 65 20 74 68 61 74 20 74 68 65 20 69  hange that the i
61f0: 74 65 72 61 74 6f 72 0a 2a 2a 20 63 75 72 72 65  terator.** curre
6200: 6e 74 6c 79 20 70 6f 69 6e 74 73 20 74 6f 20 69  ntly points to i
6210: 73 20 65 69 74 68 65 72 20 5b 53 51 4c 49 54 45  s either [SQLITE
6220: 5f 44 45 4c 45 54 45 5d 20 6f 72 20 5b 53 51 4c  _DELETE] or [SQL
6230: 49 54 45 5f 55 50 44 41 54 45 5d 2e 20 4f 74 68  ITE_UPDATE]. Oth
6240: 65 72 77 69 73 65 2c 0a 2a 2a 20 74 68 69 73 20  erwise,.** this 
6250: 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73  function returns
6260: 20 5b 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5d   [SQLITE_MISUSE]
6270: 20 61 6e 64 20 73 65 74 73 20 2a 70 70 56 61 6c   and sets *ppVal
6280: 75 65 20 74 6f 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a  ue to NULL..**.*
6290: 2a 20 41 72 67 75 6d 65 6e 74 20 69 56 61 6c 20  * Argument iVal 
62a0: 6d 75 73 74 20 62 65 20 67 72 65 61 74 65 72 20  must be greater 
62b0: 74 68 61 6e 20 6f 72 20 65 71 75 61 6c 20 74 6f  than or equal to
62c0: 20 30 2c 20 61 6e 64 20 6c 65 73 73 20 74 68 61   0, and less tha
62d0: 6e 20 74 68 65 20 6e 75 6d 62 65 72 0a 2a 2a 20  n the number.** 
62e0: 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68  of columns in th
62f0: 65 20 74 61 62 6c 65 20 61 66 66 65 63 74 65 64  e table affected
6300: 20 62 79 20 74 68 65 20 63 75 72 72 65 6e 74 20   by the current 
6310: 63 68 61 6e 67 65 2e 20 4f 74 68 65 72 77 69 73  change. Otherwis
6320: 65 2c 0a 2a 2a 20 5b 53 51 4c 49 54 45 5f 52 41  e,.** [SQLITE_RA
6330: 4e 47 45 5d 20 69 73 20 72 65 74 75 72 6e 65 64  NGE] is returned
6340: 20 61 6e 64 20 2a 70 70 56 61 6c 75 65 20 69 73   and *ppValue is
6350: 20 73 65 74 20 74 6f 20 4e 55 4c 4c 2e 0a 2a 2a   set to NULL..**
6360: 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 73 66 75  .** If successfu
6370: 6c 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  l, this function
6380: 20 73 65 74 73 20 2a 70 70 56 61 6c 75 65 20 74   sets *ppValue t
6390: 6f 20 70 6f 69 6e 74 20 74 6f 20 61 20 70 72 6f  o point to a pro
63a0: 74 65 63 74 65 64 0a 2a 2a 20 73 71 6c 69 74 65  tected.** sqlite
63b0: 33 5f 76 61 6c 75 65 20 6f 62 6a 65 63 74 20 63  3_value object c
63c0: 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 69 56  ontaining the iV
63d0: 61 6c 27 74 68 20 76 61 6c 75 65 20 66 72 6f 6d  al'th value from
63e0: 20 74 68 65 20 76 65 63 74 6f 72 20 6f 66 20 0a   the vector of .
63f0: 2a 2a 20 6f 72 69 67 69 6e 61 6c 20 72 6f 77 20  ** original row 
6400: 76 61 6c 75 65 73 20 73 74 6f 72 65 64 20 61 73  values stored as
6410: 20 70 61 72 74 20 6f 66 20 74 68 65 20 55 50 44   part of the UPD
6420: 41 54 45 20 6f 72 20 44 45 4c 45 54 45 20 63 68  ATE or DELETE ch
6430: 61 6e 67 65 20 61 6e 64 0a 2a 2a 20 72 65 74 75  ange and.** retu
6440: 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 54  rns SQLITE_OK. T
6450: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66  he name of the f
6460: 75 6e 63 74 69 6f 6e 20 63 6f 6d 65 73 20 66 72  unction comes fr
6470: 6f 6d 20 74 68 65 20 66 61 63 74 20 74 68 61 74  om the fact that
6480: 20 74 68 69 73 20 0a 2a 2a 20 69 73 20 73 69 6d   this .** is sim
6490: 69 6c 61 72 20 74 6f 20 74 68 65 20 22 6f 6c 64  ilar to the "old
64a0: 2e 2a 22 20 63 6f 6c 75 6d 6e 73 20 61 76 61 69  .*" columns avai
64b0: 6c 61 62 6c 65 20 74 6f 20 75 70 64 61 74 65 20  lable to update 
64c0: 6f 72 20 64 65 6c 65 74 65 20 74 72 69 67 67 65  or delete trigge
64d0: 72 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 73 6f 6d  rs..**.** If som
64e0: 65 20 6f 74 68 65 72 20 65 72 72 6f 72 20 6f 63  e other error oc
64f0: 63 75 72 73 20 28 65 2e 67 2e 20 61 6e 20 4f 4f  curs (e.g. an OO
6500: 4d 20 63 6f 6e 64 69 74 69 6f 6e 29 2c 20 61 6e  M condition), an
6510: 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f   SQLite error co
6520: 64 65 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65  de.** is returne
6530: 64 20 61 6e 64 20 2a 70 70 56 61 6c 75 65 20 69  d and *ppValue i
6540: 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c 2e 0a 2a  s set to NULL..*
6550: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 63 68 61  /.int sqlite3cha
6560: 6e 67 65 73 65 74 5f 6f 6c 64 28 0a 20 20 73 71  ngeset_old(.  sq
6570: 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 65 74 5f  lite3_changeset_
6580: 69 74 65 72 20 2a 70 49 74 65 72 2c 20 20 2f 2a  iter *pIter,  /*
6590: 20 43 68 61 6e 67 65 73 65 74 20 69 74 65 72 61   Changeset itera
65a0: 74 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 69 56 61  tor */.  int iVa
65b0: 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  l,              
65c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6c 75           /* Colu
65d0: 6d 6e 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 73  mn number */.  s
65e0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 70  qlite3_value **p
65f0: 70 56 61 6c 75 65 20 20 20 20 20 20 20 20 20 2f  pValue         /
6600: 2a 20 4f 55 54 3a 20 4f 6c 64 20 76 61 6c 75 65  * OUT: Old value
6610: 20 28 6f 72 20 4e 55 4c 4c 20 70 6f 69 6e 74 65   (or NULL pointe
6620: 72 29 20 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20  r) */.);../*.** 
6630: 43 41 50 49 33 52 45 46 3a 20 4f 62 74 61 69 6e  CAPI3REF: Obtain
6640: 20 6e 65 77 2e 2a 20 56 61 6c 75 65 73 20 46 72   new.* Values Fr
6650: 6f 6d 20 41 20 43 68 61 6e 67 65 73 65 74 20 49  om A Changeset I
6660: 74 65 72 61 74 6f 72 0a 2a 2a 0a 2a 2a 20 54 68  terator.**.** Th
6670: 65 20 70 49 74 65 72 20 61 72 67 75 6d 65 6e 74  e pIter argument
6680: 20 70 61 73 73 65 64 20 74 6f 20 74 68 69 73 20   passed to this 
6690: 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 65 69 74  function may eit
66a0: 68 65 72 20 62 65 20 61 6e 20 69 74 65 72 61 74  her be an iterat
66b0: 6f 72 0a 2a 2a 20 70 61 73 73 65 64 20 74 6f 20  or.** passed to 
66c0: 61 20 63 6f 6e 66 6c 69 63 74 2d 68 61 6e 64 6c  a conflict-handl
66d0: 65 72 20 62 79 20 5b 73 71 6c 69 74 65 33 63 68  er by [sqlite3ch
66e0: 61 6e 67 65 73 65 74 5f 61 70 70 6c 79 28 29 5d  angeset_apply()]
66f0: 2c 20 6f 72 20 61 6e 20 69 74 65 72 61 74 6f 72  , or an iterator
6700: 0a 2a 2a 20 63 72 65 61 74 65 64 20 62 79 20 5b  .** created by [
6710: 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74  sqlite3changeset
6720: 5f 73 74 61 72 74 28 29 5d 2e 20 49 6e 20 74 68  _start()]. In th
6730: 65 20 6c 61 74 74 65 72 20 63 61 73 65 2c 20 74  e latter case, t
6740: 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 0a 2a  he most recent.*
6750: 2a 20 63 61 6c 6c 20 74 6f 20 5b 73 71 6c 69 74  * call to [sqlit
6760: 65 33 63 68 61 6e 67 65 73 65 74 5f 6e 65 78 74  e3changeset_next
6770: 28 29 5d 20 6d 75 73 74 20 68 61 76 65 20 72 65  ()] must have re
6780: 74 75 72 6e 65 64 20 53 51 4c 49 54 45 5f 52 4f  turned SQLITE_RO
6790: 57 2e 20 0a 2a 2a 20 46 75 72 74 68 65 72 6d 6f  W. .** Furthermo
67a0: 72 65 2c 20 69 74 20 6d 61 79 20 6f 6e 6c 79 20  re, it may only 
67b0: 62 65 20 63 61 6c 6c 65 64 20 69 66 20 74 68 65  be called if the
67c0: 20 74 79 70 65 20 6f 66 20 63 68 61 6e 67 65 20   type of change 
67d0: 74 68 61 74 20 74 68 65 20 69 74 65 72 61 74 6f  that the iterato
67e0: 72 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 70  r.** currently p
67f0: 6f 69 6e 74 73 20 74 6f 20 69 73 20 65 69 74 68  oints to is eith
6800: 65 72 20 5b 53 51 4c 49 54 45 5f 55 50 44 41 54  er [SQLITE_UPDAT
6810: 45 5d 20 6f 72 20 5b 53 51 4c 49 54 45 5f 49 4e  E] or [SQLITE_IN
6820: 53 45 52 54 5d 2e 20 4f 74 68 65 72 77 69 73 65  SERT]. Otherwise
6830: 2c 0a 2a 2a 20 74 68 69 73 20 66 75 6e 63 74 69  ,.** this functi
6840: 6f 6e 20 72 65 74 75 72 6e 73 20 5b 53 51 4c 49  on returns [SQLI
6850: 54 45 5f 4d 49 53 55 53 45 5d 20 61 6e 64 20 73  TE_MISUSE] and s
6860: 65 74 73 20 2a 70 70 56 61 6c 75 65 20 74 6f 20  ets *ppValue to 
6870: 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 41 72 67 75  NULL..**.** Argu
6880: 6d 65 6e 74 20 69 56 61 6c 20 6d 75 73 74 20 62  ment iVal must b
6890: 65 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 6f  e greater than o
68a0: 72 20 65 71 75 61 6c 20 74 6f 20 30 2c 20 61 6e  r equal to 0, an
68b0: 64 20 6c 65 73 73 20 74 68 61 6e 20 74 68 65 20  d less than the 
68c0: 6e 75 6d 62 65 72 0a 2a 2a 20 6f 66 20 63 6f 6c  number.** of col
68d0: 75 6d 6e 73 20 69 6e 20 74 68 65 20 74 61 62 6c  umns in the tabl
68e0: 65 20 61 66 66 65 63 74 65 64 20 62 79 20 74 68  e affected by th
68f0: 65 20 63 75 72 72 65 6e 74 20 63 68 61 6e 67 65  e current change
6900: 2e 20 4f 74 68 65 72 77 69 73 65 2c 0a 2a 2a 20  . Otherwise,.** 
6910: 5b 53 51 4c 49 54 45 5f 52 41 4e 47 45 5d 20 69  [SQLITE_RANGE] i
6920: 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 2a  s returned and *
6930: 70 70 56 61 6c 75 65 20 69 73 20 73 65 74 20 74  ppValue is set t
6940: 6f 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 49 66  o NULL..**.** If
6950: 20 73 75 63 63 65 73 73 66 75 6c 2c 20 74 68 69   successful, thi
6960: 73 20 66 75 6e 63 74 69 6f 6e 20 73 65 74 73 20  s function sets 
6970: 2a 70 70 56 61 6c 75 65 20 74 6f 20 70 6f 69 6e  *ppValue to poin
6980: 74 20 74 6f 20 61 20 70 72 6f 74 65 63 74 65 64  t to a protected
6990: 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  .** sqlite3_valu
69a0: 65 20 6f 62 6a 65 63 74 20 63 6f 6e 74 61 69 6e  e object contain
69b0: 69 6e 67 20 74 68 65 20 69 56 61 6c 27 74 68 20  ing the iVal'th 
69c0: 76 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 20 76  value from the v
69d0: 65 63 74 6f 72 20 6f 66 20 0a 2a 2a 20 6e 65 77  ector of .** new
69e0: 20 72 6f 77 20 76 61 6c 75 65 73 20 73 74 6f 72   row values stor
69f0: 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 74 68  ed as part of th
6a00: 65 20 55 50 44 41 54 45 20 6f 72 20 49 4e 53 45  e UPDATE or INSE
6a10: 52 54 20 63 68 61 6e 67 65 20 61 6e 64 0a 2a 2a  RT change and.**
6a20: 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f   returns SQLITE_
6a30: 4f 4b 2e 20 49 66 20 74 68 65 20 63 68 61 6e 67  OK. If the chang
6a40: 65 20 69 73 20 61 6e 20 55 50 44 41 54 45 20 61  e is an UPDATE a
6a50: 6e 64 20 64 6f 65 73 20 6e 6f 74 20 69 6e 63 6c  nd does not incl
6a60: 75 64 65 0a 2a 2a 20 61 20 6e 65 77 20 76 61 6c  ude.** a new val
6a70: 75 65 20 66 6f 72 20 74 68 65 20 72 65 71 75 65  ue for the reque
6a80: 73 74 65 64 20 63 6f 6c 75 6d 6e 2c 20 2a 70 70  sted column, *pp
6a90: 56 61 6c 75 65 20 69 73 20 73 65 74 20 74 6f 20  Value is set to 
6aa0: 4e 55 4c 4c 20 61 6e 64 20 0a 2a 2a 20 53 51 4c  NULL and .** SQL
6ab0: 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 2e  ITE_OK returned.
6ac0: 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65   The name of the
6ad0: 20 66 75 6e 63 74 69 6f 6e 20 63 6f 6d 65 73 20   function comes 
6ae0: 66 72 6f 6d 20 74 68 65 20 66 61 63 74 20 74 68  from the fact th
6af0: 61 74 20 0a 2a 2a 20 74 68 69 73 20 69 73 20 73  at .** this is s
6b00: 69 6d 69 6c 61 72 20 74 6f 20 74 68 65 20 22 6e  imilar to the "n
6b10: 65 77 2e 2a 22 20 63 6f 6c 75 6d 6e 73 20 61 76  ew.*" columns av
6b20: 61 69 6c 61 62 6c 65 20 74 6f 20 75 70 64 61 74  ailable to updat
6b30: 65 20 6f 72 20 64 65 6c 65 74 65 20 0a 2a 2a 20  e or delete .** 
6b40: 74 72 69 67 67 65 72 73 2e 0a 2a 2a 0a 2a 2a 20  triggers..**.** 
6b50: 49 66 20 73 6f 6d 65 20 6f 74 68 65 72 20 65 72  If some other er
6b60: 72 6f 72 20 6f 63 63 75 72 73 20 28 65 2e 67 2e  ror occurs (e.g.
6b70: 20 61 6e 20 4f 4f 4d 20 63 6f 6e 64 69 74 69 6f   an OOM conditio
6b80: 6e 29 2c 20 61 6e 20 53 51 4c 69 74 65 20 65 72  n), an SQLite er
6b90: 72 6f 72 20 63 6f 64 65 0a 2a 2a 20 69 73 20 72  ror code.** is r
6ba0: 65 74 75 72 6e 65 64 20 61 6e 64 20 2a 70 70 56  eturned and *ppV
6bb0: 61 6c 75 65 20 69 73 20 73 65 74 20 74 6f 20 4e  alue is set to N
6bc0: 55 4c 4c 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ULL..*/.int sqli
6bd0: 74 65 33 63 68 61 6e 67 65 73 65 74 5f 6e 65 77  te3changeset_new
6be0: 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 68 61 6e  (.  sqlite3_chan
6bf0: 67 65 73 65 74 5f 69 74 65 72 20 2a 70 49 74 65  geset_iter *pIte
6c00: 72 2c 20 20 2f 2a 20 43 68 61 6e 67 65 73 65 74  r,  /* Changeset
6c10: 20 69 74 65 72 61 74 6f 72 20 2a 2f 0a 20 20 69   iterator */.  i
6c20: 6e 74 20 69 56 61 6c 2c 20 20 20 20 20 20 20 20  nt iVal,        
6c30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
6c40: 2a 20 43 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20  * Column number 
6c50: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c  */.  sqlite3_val
6c60: 75 65 20 2a 2a 70 70 56 61 6c 75 65 20 20 20 20  ue **ppValue    
6c70: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 4e 65 77       /* OUT: New
6c80: 20 76 61 6c 75 65 20 28 6f 72 20 4e 55 4c 4c 20   value (or NULL 
6c90: 70 6f 69 6e 74 65 72 29 20 2a 2f 0a 29 3b 0a 0a  pointer) */.);..
6ca0: 2f 2a 0a 2a 2a 20 43 41 50 49 33 52 45 46 3a 20  /*.** CAPI3REF: 
6cb0: 4f 62 74 61 69 6e 20 43 6f 6e 66 6c 69 63 74 69  Obtain Conflicti
6cc0: 6e 67 20 52 6f 77 20 56 61 6c 75 65 73 20 46 72  ng Row Values Fr
6cd0: 6f 6d 20 41 20 43 68 61 6e 67 65 73 65 74 20 49  om A Changeset I
6ce0: 74 65 72 61 74 6f 72 0a 2a 2a 0a 2a 2a 20 54 68  terator.**.** Th
6cf0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75  is function shou
6d00: 6c 64 20 6f 6e 6c 79 20 62 65 20 75 73 65 64 20  ld only be used 
6d10: 77 69 74 68 20 69 74 65 72 61 74 6f 72 20 6f 62  with iterator ob
6d20: 6a 65 63 74 73 20 70 61 73 73 65 64 20 74 6f 20  jects passed to 
6d30: 61 0a 2a 2a 20 63 6f 6e 66 6c 69 63 74 2d 68 61  a.** conflict-ha
6d40: 6e 64 6c 65 72 20 63 61 6c 6c 62 61 63 6b 20 62  ndler callback b
6d50: 79 20 5b 73 71 6c 69 74 65 33 63 68 61 6e 67 65  y [sqlite3change
6d60: 73 65 74 5f 61 70 70 6c 79 28 29 5d 20 77 69 74  set_apply()] wit
6d70: 68 20 65 69 74 68 65 72 0a 2a 2a 20 5b 53 51 4c  h either.** [SQL
6d80: 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 44 41  ITE_CHANGESET_DA
6d90: 54 41 5d 20 6f 72 20 5b 53 51 4c 49 54 45 5f 43  TA] or [SQLITE_C
6da0: 48 41 4e 47 45 53 45 54 5f 43 4f 4e 46 4c 49 43  HANGESET_CONFLIC
6db0: 54 5d 2e 20 49 66 20 74 68 69 73 20 66 75 6e 63  T]. If this func
6dc0: 74 69 6f 6e 0a 2a 2a 20 69 73 20 63 61 6c 6c 65  tion.** is calle
6dd0: 64 20 6f 6e 20 61 6e 79 20 6f 74 68 65 72 20 69  d on any other i
6de0: 74 65 72 61 74 6f 72 2c 20 5b 53 51 4c 49 54 45  terator, [SQLITE
6df0: 5f 4d 49 53 55 53 45 5d 20 69 73 20 72 65 74 75  _MISUSE] is retu
6e00: 72 6e 65 64 20 61 6e 64 20 2a 70 70 56 61 6c 75  rned and *ppValu
6e10: 65 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f 20 4e  e.** is set to N
6e20: 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 41 72 67 75 6d  ULL..**.** Argum
6e30: 65 6e 74 20 69 56 61 6c 20 6d 75 73 74 20 62 65  ent iVal must be
6e40: 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 6f 72   greater than or
6e50: 20 65 71 75 61 6c 20 74 6f 20 30 2c 20 61 6e 64   equal to 0, and
6e60: 20 6c 65 73 73 20 74 68 61 6e 20 74 68 65 20 6e   less than the n
6e70: 75 6d 62 65 72 0a 2a 2a 20 6f 66 20 63 6f 6c 75  umber.** of colu
6e80: 6d 6e 73 20 69 6e 20 74 68 65 20 74 61 62 6c 65  mns in the table
6e90: 20 61 66 66 65 63 74 65 64 20 62 79 20 74 68 65   affected by the
6ea0: 20 63 75 72 72 65 6e 74 20 63 68 61 6e 67 65 2e   current change.
6eb0: 20 4f 74 68 65 72 77 69 73 65 2c 0a 2a 2a 20 5b   Otherwise,.** [
6ec0: 53 51 4c 49 54 45 5f 52 41 4e 47 45 5d 20 69 73  SQLITE_RANGE] is
6ed0: 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 2a 70   returned and *p
6ee0: 70 56 61 6c 75 65 20 69 73 20 73 65 74 20 74 6f  pValue is set to
6ef0: 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 49 66 20   NULL..**.** If 
6f00: 73 75 63 63 65 73 73 66 75 6c 2c 20 74 68 69 73  successful, this
6f10: 20 66 75 6e 63 74 69 6f 6e 20 73 65 74 73 20 2a   function sets *
6f20: 70 70 56 61 6c 75 65 20 74 6f 20 70 6f 69 6e 74  ppValue to point
6f30: 20 74 6f 20 61 20 70 72 6f 74 65 63 74 65 64 0a   to a protected.
6f40: 2a 2a 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  ** sqlite3_value
6f50: 20 6f 62 6a 65 63 74 20 63 6f 6e 74 61 69 6e 69   object containi
6f60: 6e 67 20 74 68 65 20 69 56 61 6c 27 74 68 20 76  ng the iVal'th v
6f70: 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 20 0a 2a  alue from the .*
6f80: 2a 20 22 63 6f 6e 66 6c 69 63 74 69 6e 67 20 72  * "conflicting r
6f90: 6f 77 22 20 61 73 73 6f 63 69 61 74 65 64 20 77  ow" associated w
6fa0: 69 74 68 20 74 68 65 20 63 75 72 72 65 6e 74 20  ith the current 
6fb0: 63 6f 6e 66 6c 69 63 74 2d 68 61 6e 64 6c 65 72  conflict-handler
6fc0: 20 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 61 6e 64   callback.** and
6fd0: 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f   returns SQLITE_
6fe0: 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 73 6f 6d  OK..**.** If som
6ff0: 65 20 6f 74 68 65 72 20 65 72 72 6f 72 20 6f 63  e other error oc
7000: 63 75 72 73 20 28 65 2e 67 2e 20 61 6e 20 4f 4f  curs (e.g. an OO
7010: 4d 20 63 6f 6e 64 69 74 69 6f 6e 29 2c 20 61 6e  M condition), an
7020: 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f   SQLite error co
7030: 64 65 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65  de.** is returne
7040: 64 20 61 6e 64 20 2a 70 70 56 61 6c 75 65 20 69  d and *ppValue i
7050: 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c 2e 0a 2a  s set to NULL..*
7060: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 63 68 61  /.int sqlite3cha
7070: 6e 67 65 73 65 74 5f 63 6f 6e 66 6c 69 63 74 28  ngeset_conflict(
7080: 0a 20 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67  .  sqlite3_chang
7090: 65 73 65 74 5f 69 74 65 72 20 2a 70 49 74 65 72  eset_iter *pIter
70a0: 2c 20 20 2f 2a 20 43 68 61 6e 67 65 73 65 74 20  ,  /* Changeset 
70b0: 69 74 65 72 61 74 6f 72 20 2a 2f 0a 20 20 69 6e  iterator */.  in
70c0: 74 20 69 56 61 6c 2c 20 20 20 20 20 20 20 20 20  t iVal,         
70d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
70e0: 20 43 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 2a   Column number *
70f0: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  /.  sqlite3_valu
7100: 65 20 2a 2a 70 70 56 61 6c 75 65 20 20 20 20 20  e **ppValue     
7110: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 56 61 6c 75      /* OUT: Valu
7120: 65 20 66 72 6f 6d 20 63 6f 6e 66 6c 69 63 74 69  e from conflicti
7130: 6e 67 20 72 6f 77 20 2a 2f 0a 29 3b 0a 0a 2f 2a  ng row */.);../*
7140: 0a 2a 2a 20 43 41 50 49 33 52 45 46 3a 20 44 65  .** CAPI3REF: De
7150: 74 65 72 6d 69 6e 65 20 54 68 65 20 4e 75 6d 62  termine The Numb
7160: 65 72 20 4f 66 20 46 6f 72 65 69 67 6e 20 4b 65  er Of Foreign Ke
7170: 79 20 43 6f 6e 73 74 72 61 69 6e 74 20 56 69 6f  y Constraint Vio
7180: 6c 61 74 69 6f 6e 73 0a 2a 2a 0a 2a 2a 20 54 68  lations.**.** Th
7190: 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20  is function may 
71a0: 6f 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64 20 77  only be called w
71b0: 69 74 68 20 61 6e 20 69 74 65 72 61 74 6f 72 20  ith an iterator 
71c0: 70 61 73 73 65 64 20 74 6f 20 61 6e 0a 2a 2a 20  passed to an.** 
71d0: 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54  SQLITE_CHANGESET
71e0: 5f 46 4f 52 45 49 47 4e 5f 4b 45 59 20 63 6f 6e  _FOREIGN_KEY con
71f0: 66 6c 69 63 74 20 68 61 6e 64 6c 65 72 20 63 61  flict handler ca
7200: 6c 6c 62 61 63 6b 2e 20 49 6e 20 74 68 69 73 20  llback. In this 
7210: 63 61 73 65 0a 2a 2a 20 69 74 20 73 65 74 73 20  case.** it sets 
7220: 74 68 65 20 6f 75 74 70 75 74 20 76 61 72 69 61  the output varia
7230: 62 6c 65 20 74 6f 20 74 68 65 20 74 6f 74 61 6c  ble to the total
7240: 20 6e 75 6d 62 65 72 20 6f 66 20 6b 6e 6f 77 6e   number of known
7250: 20 66 6f 72 65 69 67 6e 20 6b 65 79 0a 2a 2a 20   foreign key.** 
7260: 76 69 6f 6c 61 74 69 6f 6e 73 20 69 6e 20 74 68  violations in th
7270: 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 64 61  e destination da
7280: 74 61 62 61 73 65 20 61 6e 64 20 72 65 74 75 72  tabase and retur
7290: 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a  ns SQLITE_OK..**
72a0: 0a 2a 2a 20 49 6e 20 61 6c 6c 20 6f 74 68 65 72  .** In all other
72b0: 20 63 61 73 65 73 20 74 68 69 73 20 66 75 6e 63   cases this func
72c0: 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 53 51 4c  tion returns SQL
72d0: 49 54 45 5f 4d 49 53 55 53 45 2e 0a 2a 2f 0a 69  ITE_MISUSE..*/.i
72e0: 6e 74 20 73 71 6c 69 74 65 33 63 68 61 6e 67 65  nt sqlite3change
72f0: 73 65 74 5f 66 6b 5f 63 6f 6e 66 6c 69 63 74 73  set_fk_conflicts
7300: 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 68 61 6e  (.  sqlite3_chan
7310: 67 65 73 65 74 5f 69 74 65 72 20 2a 70 49 74 65  geset_iter *pIte
7320: 72 2c 20 20 2f 2a 20 43 68 61 6e 67 65 73 65 74  r,  /* Changeset
7330: 20 69 74 65 72 61 74 6f 72 20 2a 2f 0a 20 20 69   iterator */.  i
7340: 6e 74 20 2a 70 6e 4f 75 74 20 20 20 20 20 20 20  nt *pnOut       
7350: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
7360: 2a 20 4f 55 54 3a 20 4e 75 6d 62 65 72 20 6f 66  * OUT: Number of
7370: 20 46 4b 20 76 69 6f 6c 61 74 69 6f 6e 73 20 2a   FK violations *
7380: 2f 0a 29 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 43 41 50  /.);.../*.** CAP
7390: 49 33 52 45 46 3a 20 46 69 6e 61 6c 69 7a 65 20  I3REF: Finalize 
73a0: 41 20 43 68 61 6e 67 65 73 65 74 20 49 74 65 72  A Changeset Iter
73b0: 61 74 6f 72 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ator.**.** This 
73c0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64  function is used
73d0: 20 74 6f 20 66 69 6e 61 6c 69 7a 65 20 61 6e 20   to finalize an 
73e0: 69 74 65 72 61 74 6f 72 20 61 6c 6c 6f 63 61 74  iterator allocat
73f0: 65 64 20 77 69 74 68 0a 2a 2a 20 5b 73 71 6c 69  ed with.** [sqli
7400: 74 65 33 63 68 61 6e 67 65 73 65 74 5f 73 74 61  te3changeset_sta
7410: 72 74 28 29 5d 2e 0a 2a 2a 0a 2a 2a 20 54 68 69  rt()]..**.** Thi
7420: 73 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c  s function shoul
7430: 64 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64  d only be called
7440: 20 6f 6e 20 69 74 65 72 61 74 6f 72 73 20 63 72   on iterators cr
7450: 65 61 74 65 64 20 75 73 69 6e 67 20 74 68 65 0a  eated using the.
7460: 2a 2a 20 5b 73 71 6c 69 74 65 33 63 68 61 6e 67  ** [sqlite3chang
7470: 65 73 65 74 5f 73 74 61 72 74 28 29 5d 20 66 75  eset_start()] fu
7480: 6e 63 74 69 6f 6e 2e 20 49 66 20 61 6e 20 61 70  nction. If an ap
7490: 70 6c 69 63 61 74 69 6f 6e 20 63 61 6c 6c 73 20  plication calls 
74a0: 74 68 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e  this.** function
74b0: 20 77 69 74 68 20 61 6e 20 69 74 65 72 61 74 6f   with an iterato
74c0: 72 20 70 61 73 73 65 64 20 74 6f 20 61 20 63 6f  r passed to a co
74d0: 6e 66 6c 69 63 74 2d 68 61 6e 64 6c 65 72 20 62  nflict-handler b
74e0: 79 0a 2a 2a 20 5b 73 71 6c 69 74 65 33 63 68 61  y.** [sqlite3cha
74f0: 6e 67 65 73 65 74 5f 61 70 70 6c 79 28 29 5d 2c  ngeset_apply()],
7500: 20 5b 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5d   [SQLITE_MISUSE]
7510: 20 69 73 20 69 6d 6d 65 64 69 61 74 65 6c 79 20   is immediately 
7520: 72 65 74 75 72 6e 65 64 20 61 6e 64 20 74 68 65  returned and the
7530: 0a 2a 2a 20 63 61 6c 6c 20 68 61 73 20 6e 6f 20  .** call has no 
7540: 65 66 66 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 49 66  effect..**.** If
7550: 20 61 6e 20 65 72 72 6f 72 20 77 61 73 20 65 6e   an error was en
7560: 63 6f 75 6e 74 65 72 65 64 20 77 69 74 68 69 6e  countered within
7570: 20 61 20 63 61 6c 6c 20 74 6f 20 61 6e 20 73 71   a call to an sq
7580: 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f 78  lite3changeset_x
7590: 78 78 28 29 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e  xx().** function
75a0: 20 28 66 6f 72 20 65 78 61 6d 70 6c 65 20 61 6e   (for example an
75b0: 20 5b 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54   [SQLITE_CORRUPT
75c0: 5d 20 69 6e 20 5b 73 71 6c 69 74 65 33 63 68 61  ] in [sqlite3cha
75d0: 6e 67 65 73 65 74 5f 6e 65 78 74 28 29 5d 20 6f  ngeset_next()] o
75e0: 72 20 61 6e 20 0a 2a 2a 20 5b 53 51 4c 49 54 45  r an .** [SQLITE
75f0: 5f 4e 4f 4d 45 4d 5d 20 69 6e 20 5b 73 71 6c 69  _NOMEM] in [sqli
7600: 74 65 33 63 68 61 6e 67 65 73 65 74 5f 6e 65 77  te3changeset_new
7610: 28 29 5d 29 20 74 68 65 6e 20 61 6e 20 65 72 72  ()]) then an err
7620: 6f 72 20 63 6f 64 65 20 63 6f 72 72 65 73 70 6f  or code correspo
7630: 6e 64 69 6e 67 0a 2a 2a 20 74 6f 20 74 68 61 74  nding.** to that
7640: 20 65 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e   error is return
7650: 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74  ed by this funct
7660: 69 6f 6e 2e 20 4f 74 68 65 72 77 69 73 65 2c 20  ion. Otherwise, 
7670: 53 51 4c 49 54 45 5f 4f 4b 20 69 73 0a 2a 2a 20  SQLITE_OK is.** 
7680: 72 65 74 75 72 6e 65 64 2e 20 54 68 69 73 20 69  returned. This i
7690: 73 20 74 6f 20 61 6c 6c 6f 77 20 74 68 65 20 66  s to allow the f
76a0: 6f 6c 6c 6f 77 69 6e 67 20 70 61 74 74 65 72 6e  ollowing pattern
76b0: 20 28 70 73 65 75 64 6f 2d 63 6f 64 65 29 3a 0a   (pseudo-code):.
76c0: 2a 2a 0a 2a 2a 20 20 20 73 71 6c 69 74 65 33 63  **.**   sqlite3c
76d0: 68 61 6e 67 65 73 65 74 5f 73 74 61 72 74 28 29  hangeset_start()
76e0: 3b 0a 2a 2a 20 20 20 77 68 69 6c 65 28 20 53 51  ;.**   while( SQ
76f0: 4c 49 54 45 5f 52 4f 57 3d 3d 73 71 6c 69 74 65  LITE_ROW==sqlite
7700: 33 63 68 61 6e 67 65 73 65 74 5f 6e 65 78 74 28  3changeset_next(
7710: 29 20 29 7b 0a 2a 2a 20 20 20 20 20 2f 2f 20 44  ) ){.**     // D
7720: 6f 20 73 6f 6d 65 74 68 69 6e 67 20 77 69 74 68  o something with
7730: 20 63 68 61 6e 67 65 2e 0a 2a 2a 20 20 20 7d 0a   change..**   }.
7740: 2a 2a 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  **   rc = sqlite
7750: 33 63 68 61 6e 67 65 73 65 74 5f 66 69 6e 61 6c  3changeset_final
7760: 69 7a 65 28 29 3b 0a 2a 2a 20 20 20 69 66 28 20  ize();.**   if( 
7770: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
7780: 0a 2a 2a 20 20 20 20 20 2f 2f 20 41 6e 20 65 72  .**     // An er
7790: 72 6f 72 20 68 61 73 20 6f 63 63 75 72 72 65 64  ror has occurred
77a0: 20 0a 2a 2a 20 20 20 7d 0a 2a 2f 0a 69 6e 74 20   .**   }.*/.int 
77b0: 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74  sqlite3changeset
77c0: 5f 66 69 6e 61 6c 69 7a 65 28 73 71 6c 69 74 65  _finalize(sqlite
77d0: 33 5f 63 68 61 6e 67 65 73 65 74 5f 69 74 65 72  3_changeset_iter
77e0: 20 2a 70 49 74 65 72 29 3b 0a 0a 2f 2a 0a 2a 2a   *pIter);../*.**
77f0: 20 43 41 50 49 33 52 45 46 3a 20 49 6e 76 65 72   CAPI3REF: Inver
7800: 74 20 41 20 43 68 61 6e 67 65 73 65 74 0a 2a 2a  t A Changeset.**
7810: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
7820: 6e 20 69 73 20 75 73 65 64 20 74 6f 20 22 69 6e  n is used to "in
7830: 76 65 72 74 22 20 61 20 63 68 61 6e 67 65 73 65  vert" a changese
7840: 74 20 6f 62 6a 65 63 74 2e 20 41 70 70 6c 79 69  t object. Applyi
7850: 6e 67 20 61 6e 20 69 6e 76 65 72 74 65 64 0a 2a  ng an inverted.*
7860: 2a 20 63 68 61 6e 67 65 73 65 74 20 74 6f 20 61  * changeset to a
7870: 20 64 61 74 61 62 61 73 65 20 72 65 76 65 72 73   database revers
7880: 65 73 20 74 68 65 20 65 66 66 65 63 74 73 20 6f  es the effects o
7890: 66 20 61 70 70 6c 79 69 6e 67 20 74 68 65 20 75  f applying the u
78a0: 6e 69 6e 76 65 72 74 65 64 0a 2a 2a 20 63 68 61  ninverted.** cha
78b0: 6e 67 65 73 65 74 2e 20 53 70 65 63 69 66 69 63  ngeset. Specific
78c0: 61 6c 6c 79 3a 0a 2a 2a 0a 2a 2a 20 3c 75 6c 3e  ally:.**.** <ul>
78d0: 0a 2a 2a 20 20 20 3c 6c 69 3e 20 45 61 63 68 20  .**   <li> Each 
78e0: 44 45 4c 45 54 45 20 63 68 61 6e 67 65 20 69 73  DELETE change is
78f0: 20 63 68 61 6e 67 65 64 20 74 6f 20 61 6e 20 49   changed to an I
7900: 4e 53 45 52 54 2c 20 61 6e 64 0a 2a 2a 20 20 20  NSERT, and.**   
7910: 3c 6c 69 3e 20 45 61 63 68 20 49 4e 53 45 52 54  <li> Each INSERT
7920: 20 63 68 61 6e 67 65 20 69 73 20 63 68 61 6e 67   change is chang
7930: 65 64 20 74 6f 20 61 20 44 45 4c 45 54 45 2c 20  ed to a DELETE, 
7940: 61 6e 64 0a 2a 2a 20 20 20 3c 6c 69 3e 20 46 6f  and.**   <li> Fo
7950: 72 20 65 61 63 68 20 55 50 44 41 54 45 20 63 68  r each UPDATE ch
7960: 61 6e 67 65 2c 20 74 68 65 20 6f 6c 64 2e 2a 20  ange, the old.* 
7970: 61 6e 64 20 6e 65 77 2e 2a 20 76 61 6c 75 65 73  and new.* values
7980: 20 61 72 65 20 65 78 63 68 61 6e 67 65 64 2e 0a   are exchanged..
7990: 2a 2a 20 3c 2f 75 6c 3e 0a 2a 2a 0a 2a 2a 20 54  ** </ul>.**.** T
79a0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 64 6f 65  his function doe
79b0: 73 20 6e 6f 74 20 63 68 61 6e 67 65 20 74 68 65  s not change the
79c0: 20 6f 72 64 65 72 20 69 6e 20 77 68 69 63 68 20   order in which 
79d0: 63 68 61 6e 67 65 73 20 61 70 70 65 61 72 20 77  changes appear w
79e0: 69 74 68 69 6e 0a 2a 2a 20 74 68 65 20 63 68 61  ithin.** the cha
79f0: 6e 67 65 73 65 74 2e 20 49 74 20 6d 65 72 65 6c  ngeset. It merel
7a00: 79 20 72 65 76 65 72 73 65 73 20 74 68 65 20 73  y reverses the s
7a10: 65 6e 73 65 20 6f 66 20 65 61 63 68 20 69 6e 64  ense of each ind
7a20: 69 76 69 64 75 61 6c 20 63 68 61 6e 67 65 2e 0a  ividual change..
7a30: 2a 2a 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 73  **.** If success
7a40: 66 75 6c 2c 20 61 20 70 6f 69 6e 74 65 72 20 74  ful, a pointer t
7a50: 6f 20 61 20 62 75 66 66 65 72 20 63 6f 6e 74 61  o a buffer conta
7a60: 69 6e 69 6e 67 20 74 68 65 20 69 6e 76 65 72 74  ining the invert
7a70: 65 64 20 63 68 61 6e 67 65 73 65 74 0a 2a 2a 20  ed changeset.** 
7a80: 69 73 20 73 74 6f 72 65 64 20 69 6e 20 2a 70 70  is stored in *pp
7a90: 4f 75 74 2c 20 74 68 65 20 73 69 7a 65 20 6f 66  Out, the size of
7aa0: 20 74 68 65 20 73 61 6d 65 20 62 75 66 66 65 72   the same buffer
7ab0: 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 2a 70   is stored in *p
7ac0: 6e 4f 75 74 2c 20 61 6e 64 0a 2a 2a 20 53 51 4c  nOut, and.** SQL
7ad0: 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e  ITE_OK is return
7ae0: 65 64 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20  ed. If an error 
7af0: 6f 63 63 75 72 73 2c 20 62 6f 74 68 20 2a 70 6e  occurs, both *pn
7b00: 4f 75 74 20 61 6e 64 20 2a 70 70 4f 75 74 20 61  Out and *ppOut a
7b10: 72 65 0a 2a 2a 20 7a 65 72 6f 65 64 20 61 6e 64  re.** zeroed and
7b20: 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72   an SQLite error
7b30: 20 63 6f 64 65 20 72 65 74 75 72 6e 65 64 2e 0a   code returned..
7b40: 2a 2a 0a 2a 2a 20 49 74 20 69 73 20 74 68 65 20  **.** It is the 
7b50: 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 6f  responsibility o
7b60: 66 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f 20  f the caller to 
7b70: 65 76 65 6e 74 75 61 6c 6c 79 20 63 61 6c 6c 20  eventually call 
7b80: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 29 0a 2a  sqlite3_free().*
7b90: 2a 20 6f 6e 20 74 68 65 20 2a 70 70 4f 75 74 20  * on the *ppOut 
7ba0: 70 6f 69 6e 74 65 72 20 74 6f 20 66 72 65 65 20  pointer to free 
7bb0: 74 68 65 20 62 75 66 66 65 72 20 61 6c 6c 6f 63  the buffer alloc
7bc0: 61 74 69 6f 6e 20 66 6f 6c 6c 6f 77 69 6e 67 20  ation following 
7bd0: 61 20 73 75 63 63 65 73 73 66 75 6c 20 0a 2a 2a  a successful .**
7be0: 20 63 61 6c 6c 20 74 6f 20 74 68 69 73 20 66 75   call to this fu
7bf0: 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 57 41  nction..**.** WA
7c00: 52 4e 49 4e 47 2f 54 4f 44 4f 3a 20 54 68 69 73  RNING/TODO: This
7c10: 20 66 75 6e 63 74 69 6f 6e 20 63 75 72 72 65 6e   function curren
7c20: 74 6c 79 20 61 73 73 75 6d 65 73 20 74 68 61 74  tly assumes that
7c30: 20 74 68 65 20 69 6e 70 75 74 20 69 73 20 61 20   the input is a 
7c40: 76 61 6c 69 64 0a 2a 2a 20 63 68 61 6e 67 65 73  valid.** changes
7c50: 65 74 2e 20 49 66 20 69 74 20 69 73 20 6e 6f 74  et. If it is not
7c60: 2c 20 74 68 65 20 72 65 73 75 6c 74 73 20 61 72  , the results ar
7c70: 65 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a  e undefined..*/.
7c80: 69 6e 74 20 73 71 6c 69 74 65 33 63 68 61 6e 67  int sqlite3chang
7c90: 65 73 65 74 5f 69 6e 76 65 72 74 28 0a 20 20 69  eset_invert(.  i
7ca0: 6e 74 20 6e 49 6e 2c 20 63 6f 6e 73 74 20 76 6f  nt nIn, const vo
7cb0: 69 64 20 2a 70 49 6e 2c 20 20 20 20 20 20 20 2f  id *pIn,       /
7cc0: 2a 20 49 6e 70 75 74 20 63 68 61 6e 67 65 73 65  * Input changese
7cd0: 74 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4f 75  t */.  int *pnOu
7ce0: 74 2c 20 76 6f 69 64 20 2a 2a 70 70 4f 75 74 20  t, void **ppOut 
7cf0: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 49         /* OUT: I
7d00: 6e 76 65 72 73 65 20 6f 66 20 69 6e 70 75 74 20  nverse of input 
7d10: 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 43 41 50  */.);../*.** CAP
7d20: 49 33 52 45 46 3a 20 43 6f 6e 63 61 74 65 6e 61  I3REF: Concatena
7d30: 74 65 20 54 77 6f 20 43 68 61 6e 67 65 73 65 74  te Two Changeset
7d40: 20 4f 62 6a 65 63 74 73 0a 2a 2a 0a 2a 2a 20 54   Objects.**.** T
7d50: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
7d60: 75 73 65 64 20 74 6f 20 63 6f 6e 63 61 74 65 6e  used to concaten
7d70: 61 74 65 20 74 77 6f 20 63 68 61 6e 67 65 73 65  ate two changese
7d80: 74 73 2c 20 41 20 61 6e 64 20 42 2c 20 69 6e 74  ts, A and B, int
7d90: 6f 20 61 20 0a 2a 2a 20 73 69 6e 67 6c 65 20 63  o a .** single c
7da0: 68 61 6e 67 65 73 65 74 2e 20 54 68 65 20 72 65  hangeset. The re
7db0: 73 75 6c 74 20 69 73 20 61 20 63 68 61 6e 67 65  sult is a change
7dc0: 73 65 74 20 65 71 75 69 76 61 6c 65 6e 74 20 74  set equivalent t
7dd0: 6f 20 61 70 70 6c 79 69 6e 67 0a 2a 2a 20 63 68  o applying.** ch
7de0: 61 6e 67 65 73 65 74 20 41 20 66 6f 6c 6c 6f 77  angeset A follow
7df0: 65 64 20 62 79 20 63 68 61 6e 67 65 73 65 74 20  ed by changeset 
7e00: 42 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66  B. .**.** This f
7e10: 75 6e 63 74 69 6f 6e 20 63 6f 6d 62 69 6e 65 73  unction combines
7e20: 20 74 68 65 20 74 77 6f 20 69 6e 70 75 74 20 63   the two input c
7e30: 68 61 6e 67 65 73 65 74 73 20 75 73 69 6e 67 20  hangesets using 
7e40: 61 6e 20 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 63  an .** sqlite3_c
7e50: 68 61 6e 67 65 67 72 6f 75 70 20 6f 62 6a 65 63  hangegroup objec
7e60: 74 2e 20 43 61 6c 6c 69 6e 67 20 69 74 20 70 72  t. Calling it pr
7e70: 6f 64 75 63 65 73 20 73 69 6d 69 6c 61 72 20 72  oduces similar r
7e80: 65 73 75 6c 74 73 20 61 73 20 74 68 65 0a 2a 2a  esults as the.**
7e90: 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 64 65 20   following code 
7ea0: 66 72 61 67 6d 65 6e 74 3a 0a 2a 2a 0a 2a 2a 20  fragment:.**.** 
7eb0: 20 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65    sqlite3_change
7ec0: 67 72 6f 75 70 20 2a 70 47 72 70 3b 0a 2a 2a 20  group *pGrp;.** 
7ed0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 63    rc = sqlite3_c
7ee0: 68 61 6e 67 65 67 72 6f 75 70 5f 6e 65 77 28 26  hangegroup_new(&
7ef0: 70 47 72 70 29 3b 0a 2a 2a 20 20 20 69 66 28 20  pGrp);.**   if( 
7f00: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20  rc==SQLITE_OK ) 
7f10: 72 63 20 3d 20 73 71 6c 69 74 65 33 63 68 61 6e  rc = sqlite3chan
7f20: 67 65 67 72 6f 75 70 5f 61 64 64 28 70 47 72 70  gegroup_add(pGrp
7f30: 2c 20 6e 41 2c 20 70 41 29 3b 0a 2a 2a 20 20 20  , nA, pA);.**   
7f40: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
7f50: 4b 20 29 20 72 63 20 3d 20 73 71 6c 69 74 65 33  K ) rc = sqlite3
7f60: 63 68 61 6e 67 65 67 72 6f 75 70 5f 61 64 64 28  changegroup_add(
7f70: 70 47 72 70 2c 20 6e 42 2c 20 70 42 29 3b 0a 2a  pGrp, nB, pB);.*
7f80: 2a 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49  *   if( rc==SQLI
7f90: 54 45 5f 4f 4b 20 29 7b 0a 2a 2a 20 20 20 20 20  TE_OK ){.**     
7fa0: 72 63 20 3d 20 73 71 6c 69 74 65 33 63 68 61 6e  rc = sqlite3chan
7fb0: 67 65 67 72 6f 75 70 5f 6f 75 74 70 75 74 28 70  gegroup_output(p
7fc0: 47 72 70 2c 20 70 6e 4f 75 74 2c 20 70 70 4f 75  Grp, pnOut, ppOu
7fd0: 74 29 3b 0a 2a 2a 20 20 20 7d 65 6c 73 65 7b 0a  t);.**   }else{.
7fe0: 2a 2a 20 20 20 20 20 2a 70 70 4f 75 74 20 3d 20  **     *ppOut = 
7ff0: 30 3b 0a 2a 2a 20 20 20 20 20 2a 70 6e 4f 75 74  0;.**     *pnOut
8000: 20 3d 20 30 3b 0a 2a 2a 20 20 20 7d 0a 2a 2a 0a   = 0;.**   }.**.
8010: 2a 2a 20 52 65 66 65 72 20 74 6f 20 74 68 65 20  ** Refer to the 
8020: 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 67 72  sqlite3_changegr
8030: 6f 75 70 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f  oup documentatio
8040: 6e 20 62 65 6c 6f 77 20 66 6f 72 20 64 65 74 61  n below for deta
8050: 69 6c 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ils..*/.int sqli
8060: 74 65 33 63 68 61 6e 67 65 73 65 74 5f 63 6f 6e  te3changeset_con
8070: 63 61 74 28 0a 20 20 69 6e 74 20 6e 41 2c 20 20  cat(.  int nA,  
8080: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8090: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
80a0: 20 6f 66 20 62 79 74 65 73 20 69 6e 20 62 75 66   of bytes in buf
80b0: 66 65 72 20 70 41 20 2a 2f 0a 20 20 76 6f 69 64  fer pA */.  void
80c0: 20 2a 70 41 2c 20 20 20 20 20 20 20 20 20 20 20   *pA,           
80d0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50              /* P
80e0: 6f 69 6e 74 65 72 20 74 6f 20 62 75 66 66 65 72  ointer to buffer
80f0: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 63 68 61 6e   containing chan
8100: 67 65 73 65 74 20 41 20 2a 2f 0a 20 20 69 6e 74  geset A */.  int
8110: 20 6e 42 2c 20 20 20 20 20 20 20 20 20 20 20 20   nB,            
8120: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
8130: 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20  Number of bytes 
8140: 69 6e 20 62 75 66 66 65 72 20 70 42 20 2a 2f 0a  in buffer pB */.
8150: 20 20 76 6f 69 64 20 2a 70 42 2c 20 20 20 20 20    void *pB,     
8160: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8170: 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20    /* Pointer to 
8180: 62 75 66 66 65 72 20 63 6f 6e 74 61 69 6e 69 6e  buffer containin
8190: 67 20 63 68 61 6e 67 65 73 65 74 20 42 20 2a 2f  g changeset B */
81a0: 0a 20 20 69 6e 74 20 2a 70 6e 4f 75 74 2c 20 20  .  int *pnOut,  
81b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
81c0: 20 20 20 2f 2a 20 4f 55 54 3a 20 4e 75 6d 62 65     /* OUT: Numbe
81d0: 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 6f 75  r of bytes in ou
81e0: 74 70 75 74 20 63 68 61 6e 67 65 73 65 74 20 2a  tput changeset *
81f0: 2f 0a 20 20 76 6f 69 64 20 2a 2a 70 70 4f 75 74  /.  void **ppOut
8200: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8210: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 42 75 66 66      /* OUT: Buff
8220: 65 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 6f 75  er containing ou
8230: 74 70 75 74 20 63 68 61 6e 67 65 73 65 74 20 2a  tput changeset *
8240: 2f 0a 29 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 43 41 50  /.);.../*.** CAP
8250: 49 33 52 45 46 3a 20 43 68 61 6e 67 65 67 72 6f  I3REF: Changegro
8260: 75 70 20 48 61 6e 64 6c 65 0a 2a 2f 0a 74 79 70  up Handle.*/.typ
8270: 65 64 65 66 20 73 74 72 75 63 74 20 73 71 6c 69  edef struct sqli
8280: 74 65 33 5f 63 68 61 6e 67 65 67 72 6f 75 70 20  te3_changegroup 
8290: 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 67 72  sqlite3_changegr
82a0: 6f 75 70 3b 0a 0a 2f 2a 0a 2a 2a 20 43 41 50 49  oup;../*.** CAPI
82b0: 33 52 45 46 3a 20 43 72 65 61 74 65 20 41 20 4e  3REF: Create A N
82c0: 65 77 20 43 68 61 6e 67 65 67 72 6f 75 70 20 4f  ew Changegroup O
82d0: 62 6a 65 63 74 0a 2a 2a 0a 2a 2a 20 41 6e 20 73  bject.**.** An s
82e0: 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 67 72 6f  qlite3_changegro
82f0: 75 70 20 6f 62 6a 65 63 74 20 69 73 20 75 73 65  up object is use
8300: 64 20 74 6f 20 63 6f 6d 62 69 6e 65 20 74 77 6f  d to combine two
8310: 20 6f 72 20 6d 6f 72 65 20 63 68 61 6e 67 65 73   or more changes
8320: 65 74 73 0a 2a 2a 20 28 6f 72 20 70 61 74 63 68  ets.** (or patch
8330: 73 65 74 73 29 20 69 6e 74 6f 20 61 20 73 69 6e  sets) into a sin
8340: 67 6c 65 20 63 68 61 6e 67 65 73 65 74 20 28 6f  gle changeset (o
8350: 72 20 70 61 74 63 68 73 65 74 29 2e 20 41 20 73  r patchset). A s
8360: 69 6e 67 6c 65 20 63 68 61 6e 67 65 67 72 6f 75  ingle changegrou
8370: 70 0a 2a 2a 20 6f 62 6a 65 63 74 20 6d 61 79 20  p.** object may 
8380: 63 6f 6d 62 69 6e 65 20 63 68 61 6e 67 65 73 65  combine changese
8390: 74 73 20 6f 72 20 70 61 74 63 68 73 65 74 73 2c  ts or patchsets,
83a0: 20 62 75 74 20 6e 6f 74 20 62 6f 74 68 2e 20 54   but not both. T
83b0: 68 65 20 6f 75 74 70 75 74 20 69 73 0a 2a 2a 20  he output is.** 
83c0: 61 6c 77 61 79 73 20 69 6e 20 74 68 65 20 73 61  always in the sa
83d0: 6d 65 20 66 6f 72 6d 61 74 20 61 73 20 74 68 65  me format as the
83e0: 20 69 6e 70 75 74 2e 0a 2a 2a 0a 2a 2a 20 49 66   input..**.** If
83f0: 20 73 75 63 63 65 73 73 66 75 6c 2c 20 74 68 69   successful, thi
8400: 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72  s function retur
8410: 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 20 61 6e 64  ns SQLITE_OK and
8420: 20 70 6f 70 75 6c 61 74 65 73 20 28 2a 70 70 29   populates (*pp)
8430: 20 77 69 74 68 0a 2a 2a 20 61 20 70 6f 69 6e 74   with.** a point
8440: 65 72 20 74 6f 20 61 20 6e 65 77 20 73 71 6c 69  er to a new sqli
8450: 74 65 33 5f 63 68 61 6e 67 65 67 72 6f 75 70 20  te3_changegroup 
8460: 6f 62 6a 65 63 74 20 62 65 66 6f 72 65 20 72 65  object before re
8470: 74 75 72 6e 69 6e 67 2e 20 54 68 65 20 63 61 6c  turning. The cal
8480: 6c 65 72 0a 2a 2a 20 73 68 6f 75 6c 64 20 65 76  ler.** should ev
8490: 65 6e 74 75 61 6c 6c 79 20 66 72 65 65 20 74 68  entually free th
84a0: 65 20 72 65 74 75 72 6e 65 64 20 6f 62 6a 65 63  e returned objec
84b0: 74 20 75 73 69 6e 67 20 61 20 63 61 6c 6c 20 74  t using a call t
84c0: 6f 20 0a 2a 2a 20 73 71 6c 69 74 65 33 63 68 61  o .** sqlite3cha
84d0: 6e 67 65 67 72 6f 75 70 5f 64 65 6c 65 74 65 28  ngegroup_delete(
84e0: 29 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f  ). If an error o
84f0: 63 63 75 72 73 2c 20 61 6e 20 53 51 4c 69 74 65  ccurs, an SQLite
8500: 20 65 72 72 6f 72 20 63 6f 64 65 0a 2a 2a 20 28   error code.** (
8510: 69 2e 65 2e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  i.e. SQLITE_NOME
8520: 4d 29 20 69 73 20 72 65 74 75 72 6e 65 64 20 61  M) is returned a
8530: 6e 64 20 2a 70 70 20 69 73 20 73 65 74 20 74 6f  nd *pp is set to
8540: 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 54 68 65   NULL..**.** The
8550: 20 75 73 75 61 6c 20 75 73 61 67 65 20 70 61 74   usual usage pat
8560: 74 65 72 6e 20 66 6f 72 20 61 6e 20 73 71 6c 69  tern for an sqli
8570: 74 65 33 5f 63 68 61 6e 67 65 67 72 6f 75 70 20  te3_changegroup 
8580: 6f 62 6a 65 63 74 20 69 73 20 61 73 20 66 6f 6c  object is as fol
8590: 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 3c 75 6c 3e  lows:.**.** <ul>
85a0: 0a 2a 2a 20 20 20 3c 6c 69 3e 20 49 74 20 69 73  .**   <li> It is
85b0: 20 63 72 65 61 74 65 64 20 75 73 69 6e 67 20 61   created using a
85c0: 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33   call to sqlite3
85d0: 63 68 61 6e 67 65 67 72 6f 75 70 5f 6e 65 77 28  changegroup_new(
85e0: 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 3c 6c 69 3e 20  )..**.**   <li> 
85f0: 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 63 68 61  Zero or more cha
8600: 6e 67 65 73 65 74 73 20 28 6f 72 20 70 61 74 63  ngesets (or patc
8610: 68 73 65 74 73 29 20 61 72 65 20 61 64 64 65 64  hsets) are added
8620: 20 74 6f 20 74 68 65 20 6f 62 6a 65 63 74 0a 2a   to the object.*
8630: 2a 20 20 20 20 20 20 20 20 62 79 20 63 61 6c 6c  *        by call
8640: 69 6e 67 20 73 71 6c 69 74 65 33 63 68 61 6e 67  ing sqlite3chang
8650: 65 67 72 6f 75 70 5f 61 64 64 28 29 2e 0a 2a 2a  egroup_add()..**
8660: 0a 2a 2a 20 20 20 3c 6c 69 3e 20 54 68 65 20 72  .**   <li> The r
8670: 65 73 75 6c 74 20 6f 66 20 63 6f 6d 62 69 6e 69  esult of combini
8680: 6e 67 20 61 6c 6c 20 69 6e 70 75 74 20 63 68 61  ng all input cha
8690: 6e 67 65 73 65 74 73 20 74 6f 67 65 74 68 65 72  ngesets together
86a0: 20 69 73 20 6f 62 74 61 69 6e 65 64 20 0a 2a 2a   is obtained .**
86b0: 20 20 20 20 20 20 20 20 62 79 20 74 68 65 20 61          by the a
86c0: 70 70 6c 69 63 61 74 69 6f 6e 20 76 69 61 20 61  pplication via a
86d0: 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33   call to sqlite3
86e0: 63 68 61 6e 67 65 67 72 6f 75 70 5f 6f 75 74 70  changegroup_outp
86f0: 75 74 28 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 3c 6c  ut()..**.**   <l
8700: 69 3e 20 54 68 65 20 6f 62 6a 65 63 74 20 69 73  i> The object is
8710: 20 64 65 6c 65 74 65 64 20 75 73 69 6e 67 20 61   deleted using a
8720: 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33   call to sqlite3
8730: 63 68 61 6e 67 65 67 72 6f 75 70 5f 64 65 6c 65  changegroup_dele
8740: 74 65 28 29 2e 0a 2a 2a 20 3c 2f 75 6c 3e 0a 2a  te()..** </ul>.*
8750: 2a 0a 2a 2a 20 41 6e 79 20 6e 75 6d 62 65 72 20  *.** Any number 
8760: 6f 66 20 63 61 6c 6c 73 20 74 6f 20 61 64 64 28  of calls to add(
8770: 29 20 61 6e 64 20 6f 75 74 70 75 74 28 29 20 6d  ) and output() m
8780: 61 79 20 62 65 20 6d 61 64 65 20 62 65 74 77 65  ay be made betwe
8790: 65 6e 20 74 68 65 20 63 61 6c 6c 73 20 74 6f 0a  en the calls to.
87a0: 2a 2a 20 6e 65 77 28 29 20 61 6e 64 20 64 65 6c  ** new() and del
87b0: 65 74 65 28 29 2c 20 61 6e 64 20 69 6e 20 61 6e  ete(), and in an
87c0: 79 20 6f 72 64 65 72 2e 0a 2a 2a 0a 2a 2a 20 41  y order..**.** A
87d0: 73 20 77 65 6c 6c 20 61 73 20 74 68 65 20 72 65  s well as the re
87e0: 67 75 6c 61 72 20 73 71 6c 69 74 65 33 63 68 61  gular sqlite3cha
87f0: 6e 67 65 67 72 6f 75 70 5f 61 64 64 28 29 20 61  ngegroup_add() a
8800: 6e 64 20 0a 2a 2a 20 73 71 6c 69 74 65 33 63 68  nd .** sqlite3ch
8810: 61 6e 67 65 67 72 6f 75 70 5f 6f 75 74 70 75 74  angegroup_output
8820: 28 29 20 66 75 6e 63 74 69 6f 6e 73 2c 20 61 6c  () functions, al
8830: 73 6f 20 61 76 61 69 6c 61 62 6c 65 20 61 72 65  so available are
8840: 20 74 68 65 20 73 74 72 65 61 6d 69 6e 67 0a 2a   the streaming.*
8850: 2a 20 76 65 72 73 69 6f 6e 73 20 73 71 6c 69 74  * versions sqlit
8860: 65 33 63 68 61 6e 67 65 67 72 6f 75 70 5f 61 64  e3changegroup_ad
8870: 64 5f 73 74 72 6d 28 29 20 61 6e 64 20 73 71 6c  d_strm() and sql
8880: 69 74 65 33 63 68 61 6e 67 65 67 72 6f 75 70 5f  ite3changegroup_
8890: 6f 75 74 70 75 74 5f 73 74 72 6d 28 29 2e 0a 2a  output_strm()..*
88a0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 63 68 61  /.int sqlite3cha
88b0: 6e 67 65 67 72 6f 75 70 5f 6e 65 77 28 73 71 6c  ngegroup_new(sql
88c0: 69 74 65 33 5f 63 68 61 6e 67 65 67 72 6f 75 70  ite3_changegroup
88d0: 20 2a 2a 70 70 29 3b 0a 0a 2f 2a 0a 2a 2a 20 43   **pp);../*.** C
88e0: 41 50 49 33 52 45 46 3a 20 41 64 64 20 41 20 43  API3REF: Add A C
88f0: 68 61 6e 67 65 73 65 74 20 54 6f 20 41 20 43 68  hangeset To A Ch
8900: 61 6e 67 65 67 72 6f 75 70 0a 2a 2a 0a 2a 2a 20  angegroup.**.** 
8910: 41 64 64 20 61 6c 6c 20 63 68 61 6e 67 65 73 20  Add all changes 
8920: 77 69 74 68 69 6e 20 74 68 65 20 63 68 61 6e 67  within the chang
8930: 65 73 65 74 20 28 6f 72 20 70 61 74 63 68 73 65  eset (or patchse
8940: 74 29 20 69 6e 20 62 75 66 66 65 72 20 70 44 61  t) in buffer pDa
8950: 74 61 20 28 73 69 7a 65 0a 2a 2a 20 6e 44 61 74  ta (size.** nDat
8960: 61 20 62 79 74 65 73 29 20 74 6f 20 74 68 65 20  a bytes) to the 
8970: 63 68 61 6e 67 65 67 72 6f 75 70 2e 20 0a 2a 2a  changegroup. .**
8980: 0a 2a 2a 20 49 66 20 74 68 65 20 62 75 66 66 65  .** If the buffe
8990: 72 20 63 6f 6e 74 61 69 6e 73 20 61 20 70 61 74  r contains a pat
89a0: 63 68 73 65 74 2c 20 74 68 65 6e 20 61 6c 6c 20  chset, then all 
89b0: 70 72 69 6f 72 20 63 61 6c 6c 73 20 74 6f 20 74  prior calls to t
89c0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20  his function.** 
89d0: 6f 6e 20 74 68 65 20 73 61 6d 65 20 63 68 61 6e  on the same chan
89e0: 67 65 67 72 6f 75 70 20 6f 62 6a 65 63 74 20 6d  gegroup object m
89f0: 75 73 74 20 61 6c 73 6f 20 68 61 76 65 20 73 70  ust also have sp
8a00: 65 63 69 66 69 65 64 20 70 61 74 63 68 73 65 74  ecified patchset
8a10: 73 2e 20 4f 72 2c 20 69 66 0a 2a 2a 20 74 68 65  s. Or, if.** the
8a20: 20 62 75 66 66 65 72 20 63 6f 6e 74 61 69 6e 73   buffer contains
8a30: 20 61 20 63 68 61 6e 67 65 73 65 74 2c 20 73 6f   a changeset, so
8a40: 20 6d 75 73 74 20 68 61 76 65 20 74 68 65 20 65   must have the e
8a50: 61 72 6c 69 65 72 20 63 61 6c 6c 73 20 74 6f 20  arlier calls to 
8a60: 74 68 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e  this.** function
8a70: 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 53 51 4c  . Otherwise, SQL
8a80: 49 54 45 5f 45 52 52 4f 52 20 69 73 20 72 65 74  ITE_ERROR is ret
8a90: 75 72 6e 65 64 20 61 6e 64 20 6e 6f 20 63 68 61  urned and no cha
8aa0: 6e 67 65 73 20 61 72 65 20 61 64 64 65 64 0a 2a  nges are added.*
8ab0: 2a 20 74 6f 20 74 68 65 20 63 68 61 6e 67 65 67  * to the changeg
8ac0: 72 6f 75 70 2e 0a 2a 2a 0a 2a 2a 20 52 6f 77 73  roup..**.** Rows
8ad0: 20 77 69 74 68 69 6e 20 74 68 65 20 63 68 61 6e   within the chan
8ae0: 67 65 73 65 74 20 61 6e 64 20 63 68 61 6e 67 65  geset and change
8af0: 67 72 6f 75 70 20 61 72 65 20 69 64 65 6e 74 69  group are identi
8b00: 66 69 65 64 20 62 79 20 74 68 65 20 76 61 6c 75  fied by the valu
8b10: 65 73 20 69 6e 0a 2a 2a 20 74 68 65 69 72 20 50  es in.** their P
8b20: 52 49 4d 41 52 59 20 4b 45 59 20 63 6f 6c 75 6d  RIMARY KEY colum
8b30: 6e 73 2e 20 41 20 63 68 61 6e 67 65 20 69 6e 20  ns. A change in 
8b40: 74 68 65 20 63 68 61 6e 67 65 73 65 74 20 69 73  the changeset is
8b50: 20 63 6f 6e 73 69 64 65 72 65 64 20 74 6f 0a 2a   considered to.*
8b60: 2a 20 61 70 70 6c 79 20 74 6f 20 74 68 65 20 73  * apply to the s
8b70: 61 6d 65 20 72 6f 77 20 61 73 20 61 20 63 68 61  ame row as a cha
8b80: 6e 67 65 20 61 6c 72 65 61 64 79 20 70 72 65 73  nge already pres
8b90: 65 6e 74 20 69 6e 20 74 68 65 20 63 68 61 6e 67  ent in the chang
8ba0: 65 67 72 6f 75 70 20 69 66 0a 2a 2a 20 74 68 65  egroup if.** the
8bb0: 20 74 77 6f 20 72 6f 77 73 20 68 61 76 65 20 74   two rows have t
8bc0: 68 65 20 73 61 6d 65 20 70 72 69 6d 61 72 79 20  he same primary 
8bd0: 6b 65 79 2e 0a 2a 2a 0a 2a 2a 20 43 68 61 6e 67  key..**.** Chang
8be0: 65 73 20 74 6f 20 72 6f 77 73 20 74 68 61 74 20  es to rows that 
8bf0: 64 6f 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 61  do not already a
8c00: 70 70 65 61 72 20 69 6e 20 74 68 65 20 63 68 61  ppear in the cha
8c10: 6e 67 65 67 72 6f 75 70 20 61 72 65 0a 2a 2a 20  ngegroup are.** 
8c20: 73 69 6d 70 6c 79 20 63 6f 70 69 65 64 20 69 6e  simply copied in
8c30: 74 6f 20 69 74 2e 20 4f 72 2c 20 69 66 20 62 6f  to it. Or, if bo
8c40: 74 68 20 74 68 65 20 6e 65 77 20 63 68 61 6e 67  th the new chang
8c50: 65 73 65 74 20 61 6e 64 20 74 68 65 20 63 68 61  eset and the cha
8c60: 6e 67 65 67 72 6f 75 70 0a 2a 2a 20 63 6f 6e 74  ngegroup.** cont
8c70: 61 69 6e 20 63 68 61 6e 67 65 73 20 74 68 61 74  ain changes that
8c80: 20 61 70 70 6c 79 20 74 6f 20 61 20 73 69 6e 67   apply to a sing
8c90: 6c 65 20 72 6f 77 2c 20 74 68 65 20 66 69 6e 61  le row, the fina
8ca0: 6c 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68  l contents of th
8cb0: 65 0a 2a 2a 20 63 68 61 6e 67 65 67 72 6f 75 70  e.** changegroup
8cc0: 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 20   depends on the 
8cd0: 74 79 70 65 20 6f 66 20 65 61 63 68 20 63 68 61  type of each cha
8ce0: 6e 67 65 2c 20 61 73 20 66 6f 6c 6c 6f 77 73 3a  nge, as follows:
8cf0: 0a 2a 2a 0a 2a 2a 20 3c 74 61 62 6c 65 20 62 6f  .**.** <table bo
8d00: 72 64 65 72 3d 31 20 73 74 79 6c 65 3d 22 6d 61  rder=1 style="ma
8d10: 72 67 69 6e 2d 6c 65 66 74 3a 38 65 78 3b 6d 61  rgin-left:8ex;ma
8d20: 72 67 69 6e 2d 72 69 67 68 74 3a 38 65 78 22 3e  rgin-right:8ex">
8d30: 0a 2a 2a 20 20 20 3c 74 72 3e 3c 74 68 20 73 74  .**   <tr><th st
8d40: 79 6c 65 3d 22 77 68 69 74 65 2d 73 70 61 63 65  yle="white-space
8d50: 3a 70 72 65 22 3e 45 78 69 73 74 69 6e 67 20 43  :pre">Existing C
8d60: 68 61 6e 67 65 20 20 3c 2f 74 68 3e 0a 2a 2a 20  hange  </th>.** 
8d70: 20 20 20 20 20 20 3c 74 68 20 73 74 79 6c 65 3d        <th style=
8d80: 22 77 68 69 74 65 2d 73 70 61 63 65 3a 70 72 65  "white-space:pre
8d90: 22 3e 4e 65 77 20 43 68 61 6e 67 65 20 20 20 20  ">New Change    
8da0: 20 20 20 3c 2f 74 68 3e 0a 2a 2a 20 20 20 20 20     </th>.**     
8db0: 20 20 3c 74 68 3e 4f 75 74 70 75 74 20 43 68 61    <th>Output Cha
8dc0: 6e 67 65 0a 2a 2a 20 20 20 3c 74 72 3e 3c 74 64  nge.**   <tr><td
8dd0: 3e 49 4e 53 45 52 54 20 3c 74 64 3e 49 4e 53 45  >INSERT <td>INSE
8de0: 52 54 20 3c 74 64 3e 0a 2a 2a 20 20 20 20 20 20  RT <td>.**      
8df0: 20 54 68 65 20 6e 65 77 20 63 68 61 6e 67 65 20   The new change 
8e00: 69 73 20 69 67 6e 6f 72 65 64 2e 20 54 68 69 73  is ignored. This
8e10: 20 63 61 73 65 20 64 6f 65 73 20 6e 6f 74 20 6f   case does not o
8e20: 63 63 75 72 20 69 66 20 74 68 65 20 6e 65 77 0a  ccur if the new.
8e30: 2a 2a 20 20 20 20 20 20 20 63 68 61 6e 67 65 73  **       changes
8e40: 65 74 20 77 61 73 20 72 65 63 6f 72 64 65 64 20  et was recorded 
8e50: 69 6d 6d 65 64 69 61 74 65 6c 79 20 61 66 74 65  immediately afte
8e60: 72 20 74 68 65 20 63 68 61 6e 67 65 73 65 74 73  r the changesets
8e70: 20 61 6c 72 65 61 64 79 0a 2a 2a 20 20 20 20 20   already.**     
8e80: 20 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 63    added to the c
8e90: 68 61 6e 67 65 67 72 6f 75 70 2e 0a 2a 2a 20 20  hangegroup..**  
8ea0: 20 3c 74 72 3e 3c 74 64 3e 49 4e 53 45 52 54 20   <tr><td>INSERT 
8eb0: 3c 74 64 3e 55 50 44 41 54 45 20 3c 74 64 3e 0a  <td>UPDATE <td>.
8ec0: 2a 2a 20 20 20 20 20 20 20 54 68 65 20 49 4e 53  **       The INS
8ed0: 45 52 54 20 63 68 61 6e 67 65 20 72 65 6d 61 69  ERT change remai
8ee0: 6e 73 20 69 6e 20 74 68 65 20 63 68 61 6e 67 65  ns in the change
8ef0: 67 72 6f 75 70 2e 20 54 68 65 20 76 61 6c 75 65  group. The value
8f00: 73 20 69 6e 20 74 68 65 20 0a 2a 2a 20 20 20 20  s in the .**    
8f10: 20 20 20 49 4e 53 45 52 54 20 63 68 61 6e 67 65     INSERT change
8f20: 20 61 72 65 20 6d 6f 64 69 66 69 65 64 20 61 73   are modified as
8f30: 20 69 66 20 74 68 65 20 72 6f 77 20 77 61 73 20   if the row was 
8f40: 69 6e 73 65 72 74 65 64 20 62 79 20 74 68 65 0a  inserted by the.
8f50: 2a 2a 20 20 20 20 20 20 20 65 78 69 73 74 69 6e  **       existin
8f60: 67 20 63 68 61 6e 67 65 20 61 6e 64 20 74 68 65  g change and the
8f70: 6e 20 75 70 64 61 74 65 64 20 61 63 63 6f 72 64  n updated accord
8f80: 69 6e 67 20 74 6f 20 74 68 65 20 6e 65 77 20 63  ing to the new c
8f90: 68 61 6e 67 65 2e 0a 2a 2a 20 20 20 3c 74 72 3e  hange..**   <tr>
8fa0: 3c 74 64 3e 49 4e 53 45 52 54 20 3c 74 64 3e 44  <td>INSERT <td>D
8fb0: 45 4c 45 54 45 20 3c 74 64 3e 0a 2a 2a 20 20 20  ELETE <td>.**   
8fc0: 20 20 20 20 54 68 65 20 65 78 69 73 74 69 6e 67      The existing
8fd0: 20 49 4e 53 45 52 54 20 69 73 20 72 65 6d 6f 76   INSERT is remov
8fe0: 65 64 20 66 72 6f 6d 20 74 68 65 20 63 68 61 6e  ed from the chan
8ff0: 67 65 67 72 6f 75 70 2e 20 54 68 65 20 44 45 4c  gegroup. The DEL
9000: 45 54 45 20 69 73 0a 2a 2a 20 20 20 20 20 20 20  ETE is.**       
9010: 6e 6f 74 20 61 64 64 65 64 2e 0a 2a 2a 20 20 20  not added..**   
9020: 3c 74 72 3e 3c 74 64 3e 55 50 44 41 54 45 20 3c  <tr><td>UPDATE <
9030: 74 64 3e 49 4e 53 45 52 54 20 3c 74 64 3e 0a 2a  td>INSERT <td>.*
9040: 2a 20 20 20 20 20 20 20 54 68 65 20 6e 65 77 20  *       The new 
9050: 63 68 61 6e 67 65 20 69 73 20 69 67 6e 6f 72 65  change is ignore
9060: 64 2e 20 54 68 69 73 20 63 61 73 65 20 64 6f 65  d. This case doe
9070: 73 20 6e 6f 74 20 6f 63 63 75 72 20 69 66 20 74  s not occur if t
9080: 68 65 20 6e 65 77 0a 2a 2a 20 20 20 20 20 20 20  he new.**       
9090: 63 68 61 6e 67 65 73 65 74 20 77 61 73 20 72 65  changeset was re
90a0: 63 6f 72 64 65 64 20 69 6d 6d 65 64 69 61 74 65  corded immediate
90b0: 6c 79 20 61 66 74 65 72 20 74 68 65 20 63 68 61  ly after the cha
90c0: 6e 67 65 73 65 74 73 20 61 6c 72 65 61 64 79 0a  ngesets already.
90d0: 2a 2a 20 20 20 20 20 20 20 61 64 64 65 64 20 74  **       added t
90e0: 6f 20 74 68 65 20 63 68 61 6e 67 65 67 72 6f 75  o the changegrou
90f0: 70 2e 0a 2a 2a 20 20 20 3c 74 72 3e 3c 74 64 3e  p..**   <tr><td>
9100: 55 50 44 41 54 45 20 3c 74 64 3e 55 50 44 41 54  UPDATE <td>UPDAT
9110: 45 20 3c 74 64 3e 0a 2a 2a 20 20 20 20 20 20 20  E <td>.**       
9120: 54 68 65 20 65 78 69 73 74 69 6e 67 20 55 50 44  The existing UPD
9130: 41 54 45 20 72 65 6d 61 69 6e 73 20 77 69 74 68  ATE remains with
9140: 69 6e 20 74 68 65 20 63 68 61 6e 67 65 67 72 6f  in the changegro
9150: 75 70 2e 20 49 74 20 69 73 20 61 6d 65 6e 64 65  up. It is amende
9160: 64 20 0a 2a 2a 20 20 20 20 20 20 20 73 6f 20 74  d .**       so t
9170: 68 61 74 20 74 68 65 20 61 63 63 6f 6d 70 61 6e  hat the accompan
9180: 79 69 6e 67 20 76 61 6c 75 65 73 20 61 72 65 20  ying values are 
9190: 61 73 20 69 66 20 74 68 65 20 72 6f 77 20 77 61  as if the row wa
91a0: 73 20 75 70 64 61 74 65 64 20 6f 6e 63 65 20 0a  s updated once .
91b0: 2a 2a 20 20 20 20 20 20 20 62 79 20 74 68 65 20  **       by the 
91c0: 65 78 69 73 74 69 6e 67 20 63 68 61 6e 67 65 20  existing change 
91d0: 61 6e 64 20 74 68 65 6e 20 61 67 61 69 6e 20 62  and then again b
91e0: 79 20 74 68 65 20 6e 65 77 20 63 68 61 6e 67 65  y the new change
91f0: 2e 0a 2a 2a 20 20 20 3c 74 72 3e 3c 74 64 3e 55  ..**   <tr><td>U
9200: 50 44 41 54 45 20 3c 74 64 3e 44 45 4c 45 54 45  PDATE <td>DELETE
9210: 20 3c 74 64 3e 0a 2a 2a 20 20 20 20 20 20 20 54   <td>.**       T
9220: 68 65 20 65 78 69 73 74 69 6e 67 20 55 50 44 41  he existing UPDA
9230: 54 45 20 69 73 20 72 65 70 6c 61 63 65 64 20 62  TE is replaced b
9240: 79 20 74 68 65 20 6e 65 77 20 44 45 4c 45 54 45  y the new DELETE
9250: 20 77 69 74 68 69 6e 20 74 68 65 0a 2a 2a 20 20   within the.**  
9260: 20 20 20 20 20 63 68 61 6e 67 65 67 72 6f 75 70       changegroup
9270: 2e 0a 2a 2a 20 20 20 3c 74 72 3e 3c 74 64 3e 44  ..**   <tr><td>D
9280: 45 4c 45 54 45 20 3c 74 64 3e 49 4e 53 45 52 54  ELETE <td>INSERT
9290: 20 3c 74 64 3e 0a 2a 2a 20 20 20 20 20 20 20 49   <td>.**       I
92a0: 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 66  f one or more of
92b0: 20 74 68 65 20 63 6f 6c 75 6d 6e 20 76 61 6c 75   the column valu
92c0: 65 73 20 69 6e 20 74 68 65 20 72 6f 77 20 69 6e  es in the row in
92d0: 73 65 72 74 65 64 20 62 79 20 74 68 65 0a 2a 2a  serted by the.**
92e0: 20 20 20 20 20 20 20 6e 65 77 20 63 68 61 6e 67         new chang
92f0: 65 20 64 69 66 66 65 72 20 66 72 6f 6d 20 74 68  e differ from th
9300: 6f 73 65 20 69 6e 20 74 68 65 20 72 6f 77 20 64  ose in the row d
9310: 65 6c 65 74 65 64 20 62 79 20 74 68 65 20 65 78  eleted by the ex
9320: 69 73 74 69 6e 67 20 0a 2a 2a 20 20 20 20 20 20  isting .**      
9330: 20 63 68 61 6e 67 65 2c 20 74 68 65 20 65 78 69   change, the exi
9340: 73 74 69 6e 67 20 44 45 4c 45 54 45 20 69 73 20  sting DELETE is 
9350: 72 65 70 6c 61 63 65 64 20 62 79 20 61 6e 20 55  replaced by an U
9360: 50 44 41 54 45 20 77 69 74 68 69 6e 20 74 68 65  PDATE within the
9370: 0a 2a 2a 20 20 20 20 20 20 20 63 68 61 6e 67 65  .**       change
9380: 67 72 6f 75 70 2e 20 4f 74 68 65 72 77 69 73 65  group. Otherwise
9390: 2c 20 69 66 20 74 68 65 20 69 6e 73 65 72 74 65  , if the inserte
93a0: 64 20 72 6f 77 20 69 73 20 65 78 61 63 74 6c 79  d row is exactly
93b0: 20 74 68 65 20 73 61 6d 65 20 0a 2a 2a 20 20 20   the same .**   
93c0: 20 20 20 20 61 73 20 74 68 65 20 64 65 6c 65 74      as the delet
93d0: 65 64 20 72 6f 77 2c 20 74 68 65 20 65 78 69 73  ed row, the exis
93e0: 74 69 6e 67 20 44 45 4c 45 54 45 20 69 73 20 73  ting DELETE is s
93f0: 69 6d 70 6c 79 20 64 69 73 63 61 72 64 65 64 2e  imply discarded.
9400: 0a 2a 2a 20 20 20 3c 74 72 3e 3c 74 64 3e 44 45  .**   <tr><td>DE
9410: 4c 45 54 45 20 3c 74 64 3e 55 50 44 41 54 45 20  LETE <td>UPDATE 
9420: 3c 74 64 3e 0a 2a 2a 20 20 20 20 20 20 20 54 68  <td>.**       Th
9430: 65 20 6e 65 77 20 63 68 61 6e 67 65 20 69 73 20  e new change is 
9440: 69 67 6e 6f 72 65 64 2e 20 54 68 69 73 20 63 61  ignored. This ca
9450: 73 65 20 64 6f 65 73 20 6e 6f 74 20 6f 63 63 75  se does not occu
9460: 72 20 69 66 20 74 68 65 20 6e 65 77 0a 2a 2a 20  r if the new.** 
9470: 20 20 20 20 20 20 63 68 61 6e 67 65 73 65 74 20        changeset 
9480: 77 61 73 20 72 65 63 6f 72 64 65 64 20 69 6d 6d  was recorded imm
9490: 65 64 69 61 74 65 6c 79 20 61 66 74 65 72 20 74  ediately after t
94a0: 68 65 20 63 68 61 6e 67 65 73 65 74 73 20 61 6c  he changesets al
94b0: 72 65 61 64 79 0a 2a 2a 20 20 20 20 20 20 20 61  ready.**       a
94c0: 64 64 65 64 20 74 6f 20 74 68 65 20 63 68 61 6e  dded to the chan
94d0: 67 65 67 72 6f 75 70 2e 0a 2a 2a 20 20 20 3c 74  gegroup..**   <t
94e0: 72 3e 3c 74 64 3e 44 45 4c 45 54 45 20 3c 74 64  r><td>DELETE <td
94f0: 3e 44 45 4c 45 54 45 20 3c 74 64 3e 0a 2a 2a 20  >DELETE <td>.** 
9500: 20 20 20 20 20 20 54 68 65 20 6e 65 77 20 63 68        The new ch
9510: 61 6e 67 65 20 69 73 20 69 67 6e 6f 72 65 64 2e  ange is ignored.
9520: 20 54 68 69 73 20 63 61 73 65 20 64 6f 65 73 20   This case does 
9530: 6e 6f 74 20 6f 63 63 75 72 20 69 66 20 74 68 65  not occur if the
9540: 20 6e 65 77 0a 2a 2a 20 20 20 20 20 20 20 63 68   new.**       ch
9550: 61 6e 67 65 73 65 74 20 77 61 73 20 72 65 63 6f  angeset was reco
9560: 72 64 65 64 20 69 6d 6d 65 64 69 61 74 65 6c 79  rded immediately
9570: 20 61 66 74 65 72 20 74 68 65 20 63 68 61 6e 67   after the chang
9580: 65 73 65 74 73 20 61 6c 72 65 61 64 79 0a 2a 2a  esets already.**
9590: 20 20 20 20 20 20 20 61 64 64 65 64 20 74 6f 20         added to 
95a0: 74 68 65 20 63 68 61 6e 67 65 67 72 6f 75 70 2e  the changegroup.
95b0: 0a 2a 2a 20 3c 2f 74 61 62 6c 65 3e 0a 2a 2a 0a  .** </table>.**.
95c0: 2a 2a 20 49 66 20 74 68 65 20 6e 65 77 20 63 68  ** If the new ch
95d0: 61 6e 67 65 73 65 74 20 63 6f 6e 74 61 69 6e 73  angeset contains
95e0: 20 63 68 61 6e 67 65 73 20 74 6f 20 61 20 74 61   changes to a ta
95f0: 62 6c 65 20 74 68 61 74 20 69 73 20 61 6c 72 65  ble that is alre
9600: 61 64 79 20 70 72 65 73 65 6e 74 0a 2a 2a 20 69  ady present.** i
9610: 6e 20 74 68 65 20 63 68 61 6e 67 65 67 72 6f 75  n the changegrou
9620: 70 2c 20 74 68 65 6e 20 74 68 65 20 6e 75 6d 62  p, then the numb
9630: 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 61 6e  er of columns an
9640: 64 20 74 68 65 20 70 6f 73 69 74 69 6f 6e 20 6f  d the position o
9650: 66 20 74 68 65 0a 2a 2a 20 70 72 69 6d 61 72 79  f the.** primary
9660: 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 66 6f 72   key columns for
9670: 20 74 68 65 20 74 61 62 6c 65 20 6d 75 73 74 20   the table must 
9680: 62 65 20 63 6f 6e 73 69 73 74 65 6e 74 2e 20 49  be consistent. I
9690: 66 20 74 68 69 73 20 69 73 20 6e 6f 74 20 74 68  f this is not th
96a0: 65 0a 2a 2a 20 63 61 73 65 2c 20 74 68 69 73 20  e.** case, this 
96b0: 66 75 6e 63 74 69 6f 6e 20 66 61 69 6c 73 20 77  function fails w
96c0: 69 74 68 20 53 51 4c 49 54 45 5f 53 43 48 45 4d  ith SQLITE_SCHEM
96d0: 41 2e 20 49 66 20 74 68 65 20 69 6e 70 75 74 20  A. If the input 
96e0: 63 68 61 6e 67 65 73 65 74 0a 2a 2a 20 61 70 70  changeset.** app
96f0: 65 61 72 73 20 74 6f 20 62 65 20 63 6f 72 72 75  ears to be corru
9700: 70 74 20 61 6e 64 20 74 68 65 20 63 6f 72 72 75  pt and the corru
9710: 70 74 69 6f 6e 20 69 73 20 64 65 74 65 63 74 65  ption is detecte
9720: 64 2c 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50  d, SQLITE_CORRUP
9730: 54 20 69 73 0a 2a 2a 20 72 65 74 75 72 6e 65 64  T is.** returned
9740: 2e 20 4f 72 2c 20 69 66 20 61 6e 20 6f 75 74 2d  . Or, if an out-
9750: 6f 66 2d 6d 65 6d 6f 72 79 20 63 6f 6e 64 69 74  of-memory condit
9760: 69 6f 6e 20 6f 63 63 75 72 73 20 64 75 72 69 6e  ion occurs durin
9770: 67 20 70 72 6f 63 65 73 73 69 6e 67 2c 20 74 68  g processing, th
9780: 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 72  is.** function r
9790: 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4e 4f  eturns SQLITE_NO
97a0: 4d 45 4d 2e 20 49 6e 20 61 6c 6c 20 63 61 73 65  MEM. In all case
97b0: 73 2c 20 69 66 20 61 6e 20 65 72 72 6f 72 20 6f  s, if an error o
97c0: 63 63 75 72 73 20 74 68 65 0a 2a 2a 20 66 69 6e  ccurs the.** fin
97d0: 61 6c 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74  al contents of t
97e0: 68 65 20 63 68 61 6e 67 65 67 72 6f 75 70 20 69  he changegroup i
97f0: 73 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2a 0a  s undefined..**.
9800: 2a 2a 20 49 66 20 6e 6f 20 65 72 72 6f 72 20 6f  ** If no error o
9810: 63 63 75 72 73 2c 20 53 51 4c 49 54 45 5f 4f 4b  ccurs, SQLITE_OK
9820: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f   is returned..*/
9830: 0a 69 6e 74 20 73 71 6c 69 74 65 33 63 68 61 6e  .int sqlite3chan
9840: 67 65 67 72 6f 75 70 5f 61 64 64 28 73 71 6c 69  gegroup_add(sqli
9850: 74 65 33 5f 63 68 61 6e 67 65 67 72 6f 75 70 2a  te3_changegroup*
9860: 2c 20 69 6e 74 20 6e 44 61 74 61 2c 20 76 6f 69  , int nData, voi
9870: 64 20 2a 70 44 61 74 61 29 3b 0a 0a 2f 2a 0a 2a  d *pData);../*.*
9880: 2a 20 43 41 50 49 33 52 45 46 3a 20 4f 62 74 61  * CAPI3REF: Obta
9890: 69 6e 20 41 20 43 6f 6d 70 6f 73 69 74 65 20 43  in A Composite C
98a0: 68 61 6e 67 65 73 65 74 20 46 72 6f 6d 20 41 20  hangeset From A 
98b0: 43 68 61 6e 67 65 67 72 6f 75 70 0a 2a 2a 0a 2a  Changegroup.**.*
98c0: 2a 20 4f 62 74 61 69 6e 20 61 20 62 75 66 66 65  * Obtain a buffe
98d0: 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 20 63  r containing a c
98e0: 68 61 6e 67 65 73 65 74 20 28 6f 72 20 70 61 74  hangeset (or pat
98f0: 63 68 73 65 74 29 20 72 65 70 72 65 73 65 6e 74  chset) represent
9900: 69 6e 67 20 74 68 65 0a 2a 2a 20 63 75 72 72 65  ing the.** curre
9910: 6e 74 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74  nt contents of t
9920: 68 65 20 63 68 61 6e 67 65 67 72 6f 75 70 2e 20  he changegroup. 
9930: 49 66 20 74 68 65 20 69 6e 70 75 74 73 20 74 6f  If the inputs to
9940: 20 74 68 65 20 63 68 61 6e 67 65 67 72 6f 75 70   the changegroup
9950: 0a 2a 2a 20 77 65 72 65 20 74 68 65 6d 73 65 6c  .** were themsel
9960: 76 65 73 20 63 68 61 6e 67 65 73 65 74 73 2c 20  ves changesets, 
9970: 74 68 65 20 6f 75 74 70 75 74 20 69 73 20 61 20  the output is a 
9980: 63 68 61 6e 67 65 73 65 74 2e 20 4f 72 2c 20 69  changeset. Or, i
9990: 66 20 74 68 65 0a 2a 2a 20 69 6e 70 75 74 73 20  f the.** inputs 
99a0: 77 65 72 65 20 70 61 74 63 68 73 65 74 73 2c 20  were patchsets, 
99b0: 74 68 65 20 6f 75 74 70 75 74 20 69 73 20 61 6c  the output is al
99c0: 73 6f 20 61 20 70 61 74 63 68 73 65 74 2e 0a 2a  so a patchset..*
99d0: 2a 0a 2a 2a 20 41 73 20 77 69 74 68 20 74 68 65  *.** As with the
99e0: 20 6f 75 74 70 75 74 20 6f 66 20 74 68 65 20 73   output of the s
99f0: 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 63 68  qlite3session_ch
9a00: 61 6e 67 65 73 65 74 28 29 20 61 6e 64 0a 2a 2a  angeset() and.**
9a10: 20 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f   sqlite3session_
9a20: 70 61 74 63 68 73 65 74 28 29 20 66 75 6e 63 74  patchset() funct
9a30: 69 6f 6e 73 2c 20 61 6c 6c 20 63 68 61 6e 67 65  ions, all change
9a40: 73 20 72 65 6c 61 74 65 64 20 74 6f 20 61 20 73  s related to a s
9a50: 69 6e 67 6c 65 0a 2a 2a 20 74 61 62 6c 65 20 61  ingle.** table a
9a60: 72 65 20 67 72 6f 75 70 65 64 20 74 6f 67 65 74  re grouped toget
9a70: 68 65 72 20 69 6e 20 74 68 65 20 6f 75 74 70 75  her in the outpu
9a80: 74 20 6f 66 20 74 68 69 73 20 66 75 6e 63 74 69  t of this functi
9a90: 6f 6e 2e 20 54 61 62 6c 65 73 20 61 70 70 65 61  on. Tables appea
9aa0: 72 0a 2a 2a 20 69 6e 20 74 68 65 20 73 61 6d 65  r.** in the same
9ab0: 20 6f 72 64 65 72 20 61 73 20 66 6f 72 20 74 68   order as for th
9ac0: 65 20 76 65 72 79 20 66 69 72 73 74 20 63 68 61  e very first cha
9ad0: 6e 67 65 73 65 74 20 61 64 64 65 64 20 74 6f 20  ngeset added to 
9ae0: 74 68 65 20 63 68 61 6e 67 65 67 72 6f 75 70 2e  the changegroup.
9af0: 0a 2a 2a 20 49 66 20 74 68 65 20 73 65 63 6f 6e  .** If the secon
9b00: 64 20 6f 72 20 73 75 62 73 65 71 75 65 6e 74 20  d or subsequent 
9b10: 63 68 61 6e 67 65 73 65 74 73 20 61 64 64 65 64  changesets added
9b20: 20 74 6f 20 74 68 65 20 63 68 61 6e 67 65 67 72   to the changegr
9b30: 6f 75 70 20 63 6f 6e 74 61 69 6e 0a 2a 2a 20 63  oup contain.** c
9b40: 68 61 6e 67 65 73 20 66 6f 72 20 74 61 62 6c 65  hanges for table
9b50: 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 61 70  s that do not ap
9b60: 70 65 61 72 20 69 6e 20 74 68 65 20 66 69 72 73  pear in the firs
9b70: 74 20 63 68 61 6e 67 65 73 65 74 2c 20 74 68 65  t changeset, the
9b80: 79 20 61 72 65 0a 2a 2a 20 61 70 70 65 6e 64 65  y are.** appende
9b90: 64 20 6f 6e 74 6f 20 74 68 65 20 65 6e 64 20 6f  d onto the end o
9ba0: 66 20 74 68 65 20 6f 75 74 70 75 74 20 63 68 61  f the output cha
9bb0: 6e 67 65 73 65 74 2c 20 61 67 61 69 6e 20 69 6e  ngeset, again in
9bc0: 20 74 68 65 20 6f 72 64 65 72 20 69 6e 0a 2a 2a   the order in.**
9bd0: 20 77 68 69 63 68 20 74 68 65 79 20 61 72 65 20   which they are 
9be0: 66 69 72 73 74 20 65 6e 63 6f 75 6e 74 65 72 65  first encountere
9bf0: 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 65  d..**.** If an e
9c00: 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 61 6e 20  rror occurs, an 
9c10: 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64  SQLite error cod
9c20: 65 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e  e is returned an
9c30: 64 20 74 68 65 20 6f 75 74 70 75 74 0a 2a 2a 20  d the output.** 
9c40: 76 61 72 69 61 62 6c 65 73 20 28 2a 70 6e 44 61  variables (*pnDa
9c50: 74 61 29 20 61 6e 64 20 28 2a 70 70 44 61 74 61  ta) and (*ppData
9c60: 29 20 61 72 65 20 73 65 74 20 74 6f 20 30 2e 20  ) are set to 0. 
9c70: 4f 74 68 65 72 77 69 73 65 2c 20 53 51 4c 49 54  Otherwise, SQLIT
9c80: 45 5f 4f 4b 0a 2a 2a 20 69 73 20 72 65 74 75 72  E_OK.** is retur
9c90: 6e 65 64 20 61 6e 64 20 74 68 65 20 6f 75 74 70  ned and the outp
9ca0: 75 74 20 76 61 72 69 61 62 6c 65 73 20 61 72 65  ut variables are
9cb0: 20 73 65 74 20 74 6f 20 74 68 65 20 73 69 7a 65   set to the size
9cc0: 20 6f 66 20 61 6e 64 20 61 20 0a 2a 2a 20 70 6f   of and a .** po
9cd0: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6f 75 74  inter to the out
9ce0: 70 75 74 20 62 75 66 66 65 72 2c 20 72 65 73 70  put buffer, resp
9cf0: 65 63 74 69 76 65 6c 79 2e 20 49 6e 20 74 68 69  ectively. In thi
9d00: 73 20 63 61 73 65 20 69 74 20 69 73 20 74 68 65  s case it is the
9d10: 0a 2a 2a 20 72 65 73 70 6f 6e 73 69 62 69 6c 69  .** responsibili
9d20: 74 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72  ty of the caller
9d30: 20 74 6f 20 65 76 65 6e 74 75 61 6c 6c 79 20 66   to eventually f
9d40: 72 65 65 20 74 68 65 20 62 75 66 66 65 72 20 75  ree the buffer u
9d50: 73 69 6e 67 20 61 0a 2a 2a 20 63 61 6c 6c 20 74  sing a.** call t
9d60: 6f 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 29  o sqlite3_free()
9d70: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
9d80: 63 68 61 6e 67 65 67 72 6f 75 70 5f 6f 75 74 70  changegroup_outp
9d90: 75 74 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 68  ut(.  sqlite3_ch
9da0: 61 6e 67 65 67 72 6f 75 70 2a 2c 0a 20 20 69 6e  angegroup*,.  in
9db0: 74 20 2a 70 6e 44 61 74 61 2c 20 20 20 20 20 20  t *pnData,      
9dc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
9dd0: 20 4f 55 54 3a 20 53 69 7a 65 20 6f 66 20 6f 75   OUT: Size of ou
9de0: 74 70 75 74 20 62 75 66 66 65 72 20 69 6e 20 62  tput buffer in b
9df0: 79 74 65 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a  ytes */.  void *
9e00: 2a 70 70 44 61 74 61 20 20 20 20 20 20 20 20 20  *ppData         
9e10: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54            /* OUT
9e20: 3a 20 50 6f 69 6e 74 65 72 20 74 6f 20 6f 75 74  : Pointer to out
9e30: 70 75 74 20 62 75 66 66 65 72 20 2a 2f 0a 29 3b  put buffer */.);
9e40: 0a 0a 2f 2a 0a 2a 2a 20 43 41 50 49 33 52 45 46  ../*.** CAPI3REF
9e50: 3a 20 44 65 6c 65 74 65 20 41 20 43 68 61 6e 67  : Delete A Chang
9e60: 65 67 72 6f 75 70 20 4f 62 6a 65 63 74 0a 2a 2f  egroup Object.*/
9e70: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 63 68 61  .void sqlite3cha
9e80: 6e 67 65 67 72 6f 75 70 5f 64 65 6c 65 74 65 28  ngegroup_delete(
9e90: 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 67 72  sqlite3_changegr
9ea0: 6f 75 70 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 43 41  oup*);../*.** CA
9eb0: 50 49 33 52 45 46 3a 20 41 70 70 6c 79 20 41 20  PI3REF: Apply A 
9ec0: 43 68 61 6e 67 65 73 65 74 20 54 6f 20 41 20 44  Changeset To A D
9ed0: 61 74 61 62 61 73 65 0a 2a 2a 0a 2a 2a 20 41 70  atabase.**.** Ap
9ee0: 70 6c 79 20 61 20 63 68 61 6e 67 65 73 65 74 20  ply a changeset 
9ef0: 74 6f 20 61 20 64 61 74 61 62 61 73 65 2e 20 54  to a database. T
9f00: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 74 74  his function att
9f10: 65 6d 70 74 73 20 74 6f 20 75 70 64 61 74 65 20  empts to update 
9f20: 74 68 65 0a 2a 2a 20 22 6d 61 69 6e 22 20 64 61  the.** "main" da
9f30: 74 61 62 61 73 65 20 61 74 74 61 63 68 65 64 20  tabase attached 
9f40: 74 6f 20 68 61 6e 64 6c 65 20 64 62 20 77 69 74  to handle db wit
9f50: 68 20 74 68 65 20 63 68 61 6e 67 65 73 20 66 6f  h the changes fo
9f60: 75 6e 64 20 69 6e 20 74 68 65 0a 2a 2a 20 63 68  und in the.** ch
9f70: 61 6e 67 65 73 65 74 20 70 61 73 73 65 64 20 76  angeset passed v
9f80: 69 61 20 74 68 65 20 73 65 63 6f 6e 64 20 61 6e  ia the second an
9f90: 64 20 74 68 69 72 64 20 61 72 67 75 6d 65 6e 74  d third argument
9fa0: 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 75  s..**.** The fou
9fb0: 72 74 68 20 61 72 67 75 6d 65 6e 74 20 28 78 46  rth argument (xF
9fc0: 69 6c 74 65 72 29 20 70 61 73 73 65 64 20 74 6f  ilter) passed to
9fd0: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   this function i
9fe0: 73 20 74 68 65 20 22 66 69 6c 74 65 72 0a 2a 2a  s the "filter.**
9ff0: 20 63 61 6c 6c 62 61 63 6b 22 2e 20 49 66 20 69   callback". If i
a000: 74 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74  t is not NULL, t
a010: 68 65 6e 20 66 6f 72 20 65 61 63 68 20 74 61 62  hen for each tab
a020: 6c 65 20 61 66 66 65 63 74 65 64 20 62 79 20 61  le affected by a
a030: 74 20 6c 65 61 73 74 20 6f 6e 65 0a 2a 2a 20 63  t least one.** c
a040: 68 61 6e 67 65 20 69 6e 20 74 68 65 20 63 68 61  hange in the cha
a050: 6e 67 65 73 65 74 2c 20 74 68 65 20 66 69 6c 74  ngeset, the filt
a060: 65 72 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 69  er callback is i
a070: 6e 76 6f 6b 65 64 20 77 69 74 68 0a 2a 2a 20 74  nvoked with.** t
a080: 68 65 20 74 61 62 6c 65 20 6e 61 6d 65 20 61 73  he table name as
a090: 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75   the second argu
a0a0: 6d 65 6e 74 2c 20 61 6e 64 20 61 20 63 6f 70 79  ment, and a copy
a0b0: 20 6f 66 20 74 68 65 20 63 6f 6e 74 65 78 74 20   of the context 
a0c0: 70 6f 69 6e 74 65 72 0a 2a 2a 20 70 61 73 73 65  pointer.** passe
a0d0: 64 20 61 73 20 74 68 65 20 73 69 78 74 68 20 61  d as the sixth a
a0e0: 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 20  rgument to this 
a0f0: 66 75 6e 63 74 69 6f 6e 20 61 73 20 74 68 65 20  function as the 
a100: 66 69 72 73 74 2e 20 49 66 20 74 68 65 20 22 66  first. If the "f
a110: 69 6c 74 65 72 0a 2a 2a 20 63 61 6c 6c 62 61 63  ilter.** callbac
a120: 6b 22 20 72 65 74 75 72 6e 73 20 7a 65 72 6f 2c  k" returns zero,
a130: 20 74 68 65 6e 20 6e 6f 20 61 74 74 65 6d 70 74   then no attempt
a140: 20 69 73 20 6d 61 64 65 20 74 6f 20 61 70 70 6c   is made to appl
a150: 79 20 61 6e 79 20 63 68 61 6e 67 65 73 20 74 6f  y any changes to
a160: 20 0a 2a 2a 20 74 68 65 20 74 61 62 6c 65 2e 20   .** the table. 
a170: 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 74 68  Otherwise, if th
a180: 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69  e return value i
a190: 73 20 6e 6f 6e 2d 7a 65 72 6f 20 6f 72 20 74 68  s non-zero or th
a1a0: 65 20 78 46 69 6c 74 65 72 0a 2a 2a 20 61 72 67  e xFilter.** arg
a1b0: 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 66 75  ument to this fu
a1c0: 6e 63 74 69 6f 6e 20 69 73 20 4e 55 4c 4c 2c 20  nction is NULL, 
a1d0: 61 6c 6c 20 63 68 61 6e 67 65 73 20 72 65 6c 61  all changes rela
a1e0: 74 65 64 20 74 6f 20 74 68 65 20 74 61 62 6c 65  ted to the table
a1f0: 20 61 72 65 0a 2a 2a 20 61 74 74 65 6d 70 74 65   are.** attempte
a200: 64 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 65 61 63  d..**.** For eac
a210: 68 20 74 61 62 6c 65 20 74 68 61 74 20 69 73 20  h table that is 
a220: 6e 6f 74 20 65 78 63 6c 75 64 65 64 20 62 79 20  not excluded by 
a230: 74 68 65 20 66 69 6c 74 65 72 20 63 61 6c 6c 62  the filter callb
a240: 61 63 6b 2c 20 74 68 69 73 20 66 75 6e 63 74 69  ack, this functi
a250: 6f 6e 20 0a 2a 2a 20 74 65 73 74 73 20 74 68 61  on .** tests tha
a260: 74 20 74 68 65 20 74 61 72 67 65 74 20 64 61 74  t the target dat
a270: 61 62 61 73 65 20 63 6f 6e 74 61 69 6e 73 20 61  abase contains a
a280: 20 63 6f 6d 70 61 74 69 62 6c 65 20 74 61 62 6c   compatible tabl
a290: 65 2e 20 41 20 74 61 62 6c 65 20 69 73 20 0a 2a  e. A table is .*
a2a0: 2a 20 63 6f 6e 73 69 64 65 72 65 64 20 63 6f 6d  * considered com
a2b0: 70 61 74 69 62 6c 65 20 69 66 20 61 6c 6c 20 6f  patible if all o
a2c0: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  f the following 
a2d0: 61 72 65 20 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20  are true:.**.** 
a2e0: 3c 75 6c 3e 0a 2a 2a 20 20 20 3c 6c 69 3e 20 54  <ul>.**   <li> T
a2f0: 68 65 20 74 61 62 6c 65 20 68 61 73 20 74 68 65  he table has the
a300: 20 73 61 6d 65 20 6e 61 6d 65 20 61 73 20 74 68   same name as th
a310: 65 20 6e 61 6d 65 20 72 65 63 6f 72 64 65 64 20  e name recorded 
a320: 69 6e 20 74 68 65 20 0a 2a 2a 20 20 20 20 20 20  in the .**      
a330: 20 20 63 68 61 6e 67 65 73 65 74 2c 20 61 6e 64    changeset, and
a340: 0a 2a 2a 20 20 20 3c 6c 69 3e 20 54 68 65 20 74  .**   <li> The t
a350: 61 62 6c 65 20 68 61 73 20 74 68 65 20 73 61 6d  able has the sam
a360: 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75  e number of colu
a370: 6d 6e 73 20 61 73 20 72 65 63 6f 72 64 65 64 20  mns as recorded 
a380: 69 6e 20 74 68 65 20 0a 2a 2a 20 20 20 20 20 20  in the .**      
a390: 20 20 63 68 61 6e 67 65 73 65 74 2c 20 61 6e 64    changeset, and
a3a0: 0a 2a 2a 20 20 20 3c 6c 69 3e 20 54 68 65 20 74  .**   <li> The t
a3b0: 61 62 6c 65 20 68 61 73 20 70 72 69 6d 61 72 79  able has primary
a3c0: 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 69 6e 20   key columns in 
a3d0: 74 68 65 20 73 61 6d 65 20 70 6f 73 69 74 69 6f  the same positio
a3e0: 6e 20 61 73 20 0a 2a 2a 20 20 20 20 20 20 20 20  n as .**        
a3f0: 72 65 63 6f 72 64 65 64 20 69 6e 20 74 68 65 20  recorded in the 
a400: 63 68 61 6e 67 65 73 65 74 2e 0a 2a 2a 20 3c 2f  changeset..** </
a410: 75 6c 3e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65  ul>.**.** If the
a420: 72 65 20 69 73 20 6e 6f 20 63 6f 6d 70 61 74 69  re is no compati
a430: 62 6c 65 20 74 61 62 6c 65 2c 20 69 74 20 69 73  ble table, it is
a440: 20 6e 6f 74 20 61 6e 20 65 72 72 6f 72 2c 20 62   not an error, b
a450: 75 74 20 6e 6f 6e 65 20 6f 66 20 74 68 65 0a 2a  ut none of the.*
a460: 2a 20 63 68 61 6e 67 65 73 20 61 73 73 6f 63 69  * changes associ
a470: 61 74 65 64 20 77 69 74 68 20 74 68 65 20 74 61  ated with the ta
a480: 62 6c 65 20 61 72 65 20 61 70 70 6c 69 65 64 2e  ble are applied.
a490: 20 41 20 77 61 72 6e 69 6e 67 20 6d 65 73 73 61   A warning messa
a4a0: 67 65 20 69 73 20 69 73 73 75 65 64 0a 2a 2a 20  ge is issued.** 
a4b0: 76 69 61 20 74 68 65 20 73 71 6c 69 74 65 33 5f  via the sqlite3_
a4c0: 6c 6f 67 28 29 20 6d 65 63 68 61 6e 69 73 6d 20  log() mechanism 
a4d0: 77 69 74 68 20 74 68 65 20 65 72 72 6f 72 20 63  with the error c
a4e0: 6f 64 65 20 53 51 4c 49 54 45 5f 53 43 48 45 4d  ode SQLITE_SCHEM
a4f0: 41 2e 20 41 74 20 6d 6f 73 74 0a 2a 2a 20 6f 6e  A. At most.** on
a500: 65 20 73 75 63 68 20 77 61 72 6e 69 6e 67 20 69  e such warning i
a510: 73 20 69 73 73 75 65 64 20 66 6f 72 20 65 61 63  s issued for eac
a520: 68 20 74 61 62 6c 65 20 69 6e 20 74 68 65 20 63  h table in the c
a530: 68 61 6e 67 65 73 65 74 2e 0a 2a 2a 0a 2a 2a 20  hangeset..**.** 
a540: 46 6f 72 20 65 61 63 68 20 63 68 61 6e 67 65 20  For each change 
a550: 66 6f 72 20 77 68 69 63 68 20 74 68 65 72 65 20  for which there 
a560: 69 73 20 61 20 63 6f 6d 70 61 74 69 62 6c 65 20  is a compatible 
a570: 74 61 62 6c 65 2c 20 61 6e 20 61 74 74 65 6d 70  table, an attemp
a580: 74 20 69 73 20 6d 61 64 65 20 0a 2a 2a 20 74 6f  t is made .** to
a590: 20 6d 6f 64 69 66 79 20 74 68 65 20 74 61 62 6c   modify the tabl
a5a0: 65 20 63 6f 6e 74 65 6e 74 73 20 61 63 63 6f 72  e contents accor
a5b0: 64 69 6e 67 20 74 6f 20 74 68 65 20 55 50 44 41  ding to the UPDA
a5c0: 54 45 2c 20 49 4e 53 45 52 54 20 6f 72 20 44 45  TE, INSERT or DE
a5d0: 4c 45 54 45 20 0a 2a 2a 20 63 68 61 6e 67 65 2e  LETE .** change.
a5e0: 20 49 66 20 61 20 63 68 61 6e 67 65 20 63 61 6e   If a change can
a5f0: 6e 6f 74 20 62 65 20 61 70 70 6c 69 65 64 20 63  not be applied c
a600: 6c 65 61 6e 6c 79 2c 20 74 68 65 20 63 6f 6e 66  leanly, the conf
a610: 6c 69 63 74 20 68 61 6e 64 6c 65 72 20 0a 2a 2a  lict handler .**
a620: 20 66 75 6e 63 74 69 6f 6e 20 70 61 73 73 65 64   function passed
a630: 20 61 73 20 74 68 65 20 66 69 66 74 68 20 61 72   as the fifth ar
a640: 67 75 6d 65 6e 74 20 74 6f 20 73 71 6c 69 74 65  gument to sqlite
a650: 33 63 68 61 6e 67 65 73 65 74 5f 61 70 70 6c 79  3changeset_apply
a660: 28 29 20 6d 61 79 20 62 65 20 0a 2a 2a 20 69 6e  () may be .** in
a670: 76 6f 6b 65 64 2e 20 41 20 64 65 73 63 72 69 70  voked. A descrip
a680: 74 69 6f 6e 20 6f 66 20 65 78 61 63 74 6c 79 20  tion of exactly 
a690: 77 68 65 6e 20 74 68 65 20 63 6f 6e 66 6c 69 63  when the conflic
a6a0: 74 20 68 61 6e 64 6c 65 72 20 69 73 20 69 6e 76  t handler is inv
a6b0: 6f 6b 65 64 20 66 6f 72 20 0a 2a 2a 20 65 61 63  oked for .** eac
a6c0: 68 20 74 79 70 65 20 6f 66 20 63 68 61 6e 67 65  h type of change
a6d0: 20 69 73 20 62 65 6c 6f 77 2e 0a 2a 2a 0a 2a 2a   is below..**.**
a6e0: 20 55 6e 6c 69 6b 65 20 74 68 65 20 78 46 69 6c   Unlike the xFil
a6f0: 74 65 72 20 61 72 67 75 6d 65 6e 74 2c 20 78 43  ter argument, xC
a700: 6f 6e 66 6c 69 63 74 20 6d 61 79 20 6e 6f 74 20  onflict may not 
a710: 62 65 20 70 61 73 73 65 64 20 4e 55 4c 4c 2e 20  be passed NULL. 
a720: 54 68 65 20 72 65 73 75 6c 74 73 0a 2a 2a 20 6f  The results.** o
a730: 66 20 70 61 73 73 69 6e 67 20 61 6e 79 74 68 69  f passing anythi
a740: 6e 67 20 6f 74 68 65 72 20 74 68 61 6e 20 61 20  ng other than a 
a750: 76 61 6c 69 64 20 66 75 6e 63 74 69 6f 6e 20 70  valid function p
a760: 6f 69 6e 74 65 72 20 61 73 20 74 68 65 20 78 43  ointer as the xC
a770: 6f 6e 66 6c 69 63 74 0a 2a 2a 20 61 72 67 75 6d  onflict.** argum
a780: 65 6e 74 20 61 72 65 20 75 6e 64 65 66 69 6e 65  ent are undefine
a790: 64 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 74 69  d..**.** Each ti
a7a0: 6d 65 20 74 68 65 20 63 6f 6e 66 6c 69 63 74 20  me the conflict 
a7b0: 68 61 6e 64 6c 65 72 20 66 75 6e 63 74 69 6f 6e  handler function
a7c0: 20 69 73 20 69 6e 76 6f 6b 65 64 2c 20 69 74 20   is invoked, it 
a7d0: 6d 75 73 74 20 72 65 74 75 72 6e 20 6f 6e 65 0a  must return one.
a7e0: 2a 2a 20 6f 66 20 5b 53 51 4c 49 54 45 5f 43 48  ** of [SQLITE_CH
a7f0: 41 4e 47 45 53 45 54 5f 4f 4d 49 54 5d 2c 20 5b  ANGESET_OMIT], [
a800: 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54  SQLITE_CHANGESET
a810: 5f 41 42 4f 52 54 5d 20 6f 72 20 0a 2a 2a 20 5b  _ABORT] or .** [
a820: 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54  SQLITE_CHANGESET
a830: 5f 52 45 50 4c 41 43 45 5d 2e 20 53 51 4c 49 54  _REPLACE]. SQLIT
a840: 45 5f 43 48 41 4e 47 45 53 45 54 5f 52 45 50 4c  E_CHANGESET_REPL
a850: 41 43 45 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20  ACE may only be 
a860: 72 65 74 75 72 6e 65 64 0a 2a 2a 20 69 66 20 74  returned.** if t
a870: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65  he second argume
a880: 6e 74 20 70 61 73 73 65 64 20 74 6f 20 74 68 65  nt passed to the
a890: 20 63 6f 6e 66 6c 69 63 74 20 68 61 6e 64 6c 65   conflict handle
a8a0: 72 20 69 73 20 65 69 74 68 65 72 0a 2a 2a 20 53  r is either.** S
a8b0: 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f  QLITE_CHANGESET_
a8c0: 44 41 54 41 20 6f 72 20 53 51 4c 49 54 45 5f 43  DATA or SQLITE_C
a8d0: 48 41 4e 47 45 53 45 54 5f 43 4f 4e 46 4c 49 43  HANGESET_CONFLIC
a8e0: 54 2e 20 49 66 20 74 68 65 20 63 6f 6e 66 6c 69  T. If the confli
a8f0: 63 74 2d 68 61 6e 64 6c 65 72 0a 2a 2a 20 72 65  ct-handler.** re
a900: 74 75 72 6e 73 20 61 6e 20 69 6c 6c 65 67 61 6c  turns an illegal
a910: 20 76 61 6c 75 65 2c 20 61 6e 79 20 63 68 61 6e   value, any chan
a920: 67 65 73 20 61 6c 72 65 61 64 79 20 6d 61 64 65  ges already made
a930: 20 61 72 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b   are rolled back
a940: 20 61 6e 64 0a 2a 2a 20 74 68 65 20 63 61 6c 6c   and.** the call
a950: 20 74 6f 20 73 71 6c 69 74 65 33 63 68 61 6e 67   to sqlite3chang
a960: 65 73 65 74 5f 61 70 70 6c 79 28 29 20 72 65 74  eset_apply() ret
a970: 75 72 6e 73 20 53 51 4c 49 54 45 5f 4d 49 53 55  urns SQLITE_MISU
a980: 53 45 2e 20 44 69 66 66 65 72 65 6e 74 20 0a 2a  SE. Different .*
a990: 2a 20 61 63 74 69 6f 6e 73 20 61 72 65 20 74 61  * actions are ta
a9a0: 6b 65 6e 20 62 79 20 73 71 6c 69 74 65 33 63 68  ken by sqlite3ch
a9b0: 61 6e 67 65 73 65 74 5f 61 70 70 6c 79 28 29 20  angeset_apply() 
a9c0: 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65  depending on the
a9d0: 20 76 61 6c 75 65 0a 2a 2a 20 72 65 74 75 72 6e   value.** return
a9e0: 65 64 20 62 79 20 65 61 63 68 20 69 6e 76 6f 63  ed by each invoc
a9f0: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 63 6f 6e  ation of the con
aa00: 66 6c 69 63 74 2d 68 61 6e 64 6c 65 72 20 66 75  flict-handler fu
aa10: 6e 63 74 69 6f 6e 2e 20 52 65 66 65 72 20 74 6f  nction. Refer to
aa20: 0a 2a 2a 20 74 68 65 20 64 6f 63 75 6d 65 6e 74  .** the document
aa30: 61 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 74 68  ation for the th
aa40: 72 65 65 20 0a 2a 2a 20 5b 53 51 4c 49 54 45 5f  ree .** [SQLITE_
aa50: 43 48 41 4e 47 45 53 45 54 5f 4f 4d 49 54 7c 61  CHANGESET_OMIT|a
aa60: 76 61 69 6c 61 62 6c 65 20 72 65 74 75 72 6e 20  vailable return 
aa70: 76 61 6c 75 65 73 5d 20 66 6f 72 20 64 65 74 61  values] for deta
aa80: 69 6c 73 2e 0a 2a 2a 0a 2a 2a 20 3c 64 6c 3e 0a  ils..**.** <dl>.
aa90: 2a 2a 20 3c 64 74 3e 44 45 4c 45 54 45 20 43 68  ** <dt>DELETE Ch
aaa0: 61 6e 67 65 73 3c 64 64 3e 0a 2a 2a 20 20 20 46  anges<dd>.**   F
aab0: 6f 72 20 65 61 63 68 20 44 45 4c 45 54 45 20 63  or each DELETE c
aac0: 68 61 6e 67 65 2c 20 74 68 69 73 20 66 75 6e 63  hange, this func
aad0: 74 69 6f 6e 20 63 68 65 63 6b 73 20 69 66 20 74  tion checks if t
aae0: 68 65 20 74 61 72 67 65 74 20 64 61 74 61 62 61  he target databa
aaf0: 73 65 20 0a 2a 2a 20 20 20 63 6f 6e 74 61 69 6e  se .**   contain
ab00: 73 20 61 20 72 6f 77 20 77 69 74 68 20 74 68 65  s a row with the
ab10: 20 73 61 6d 65 20 70 72 69 6d 61 72 79 20 6b 65   same primary ke
ab20: 79 20 76 61 6c 75 65 20 28 6f 72 20 76 61 6c 75  y value (or valu
ab30: 65 73 29 20 61 73 20 74 68 65 20 0a 2a 2a 20 20  es) as the .**  
ab40: 20 6f 72 69 67 69 6e 61 6c 20 72 6f 77 20 76 61   original row va
ab50: 6c 75 65 73 20 73 74 6f 72 65 64 20 69 6e 20 74  lues stored in t
ab60: 68 65 20 63 68 61 6e 67 65 73 65 74 2e 20 49 66  he changeset. If
ab70: 20 69 74 20 64 6f 65 73 2c 20 61 6e 64 20 74 68   it does, and th
ab80: 65 20 76 61 6c 75 65 73 20 0a 2a 2a 20 20 20 73  e values .**   s
ab90: 74 6f 72 65 64 20 69 6e 20 61 6c 6c 20 6e 6f 6e  tored in all non
aba0: 2d 70 72 69 6d 61 72 79 20 6b 65 79 20 63 6f 6c  -primary key col
abb0: 75 6d 6e 73 20 61 6c 73 6f 20 6d 61 74 63 68 20  umns also match 
abc0: 74 68 65 20 76 61 6c 75 65 73 20 73 74 6f 72 65  the values store
abd0: 64 20 69 6e 20 0a 2a 2a 20 20 20 74 68 65 20 63  d in .**   the c
abe0: 68 61 6e 67 65 73 65 74 20 74 68 65 20 72 6f 77  hangeset the row
abf0: 20 69 73 20 64 65 6c 65 74 65 64 20 66 72 6f 6d   is deleted from
ac00: 20 74 68 65 20 74 61 72 67 65 74 20 64 61 74 61   the target data
ac10: 62 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 49 66  base..**.**   If
ac20: 20 61 20 72 6f 77 20 77 69 74 68 20 6d 61 74 63   a row with matc
ac30: 68 69 6e 67 20 70 72 69 6d 61 72 79 20 6b 65 79  hing primary key
ac40: 20 76 61 6c 75 65 73 20 69 73 20 66 6f 75 6e 64   values is found
ac50: 2c 20 62 75 74 20 6f 6e 65 20 6f 72 20 6d 6f 72  , but one or mor
ac60: 65 20 6f 66 0a 2a 2a 20 20 20 74 68 65 20 6e 6f  e of.**   the no
ac70: 6e 2d 70 72 69 6d 61 72 79 20 6b 65 79 20 66 69  n-primary key fi
ac80: 65 6c 64 73 20 63 6f 6e 74 61 69 6e 73 20 61 20  elds contains a 
ac90: 76 61 6c 75 65 20 64 69 66 66 65 72 65 6e 74 20  value different 
aca0: 66 72 6f 6d 20 74 68 65 20 6f 72 69 67 69 6e 61  from the origina
acb0: 6c 0a 2a 2a 20 20 20 72 6f 77 20 76 61 6c 75 65  l.**   row value
acc0: 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 63   stored in the c
acd0: 68 61 6e 67 65 73 65 74 2c 20 74 68 65 20 63 6f  hangeset, the co
ace0: 6e 66 6c 69 63 74 2d 68 61 6e 64 6c 65 72 20 66  nflict-handler f
acf0: 75 6e 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 20 20  unction is.**   
ad00: 69 6e 76 6f 6b 65 64 20 77 69 74 68 20 5b 53 51  invoked with [SQ
ad10: 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 44  LITE_CHANGESET_D
ad20: 41 54 41 5d 20 61 73 20 74 68 65 20 73 65 63 6f  ATA] as the seco
ad30: 6e 64 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a 0a  nd argument..**.
ad40: 2a 2a 20 20 20 49 66 20 6e 6f 20 72 6f 77 20 77  **   If no row w
ad50: 69 74 68 20 6d 61 74 63 68 69 6e 67 20 70 72 69  ith matching pri
ad60: 6d 61 72 79 20 6b 65 79 20 76 61 6c 75 65 73 20  mary key values 
ad70: 69 73 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20  is found in the 
ad80: 64 61 74 61 62 61 73 65 2c 0a 2a 2a 20 20 20 74  database,.**   t
ad90: 68 65 20 63 6f 6e 66 6c 69 63 74 2d 68 61 6e 64  he conflict-hand
ada0: 6c 65 72 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  ler function is 
adb0: 69 6e 76 6f 6b 65 64 20 77 69 74 68 20 5b 53 51  invoked with [SQ
adc0: 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 4e  LITE_CHANGESET_N
add0: 4f 54 46 4f 55 4e 44 5d 0a 2a 2a 20 20 20 70 61  OTFOUND].**   pa
ade0: 73 73 65 64 20 61 73 20 74 68 65 20 73 65 63 6f  ssed as the seco
adf0: 6e 64 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a 0a  nd argument..**.
ae00: 2a 2a 20 20 20 49 66 20 74 68 65 20 44 45 4c 45  **   If the DELE
ae10: 54 45 20 6f 70 65 72 61 74 69 6f 6e 20 69 73 20  TE operation is 
ae20: 61 74 74 65 6d 70 74 65 64 2c 20 62 75 74 20 53  attempted, but S
ae30: 51 4c 69 74 65 20 72 65 74 75 72 6e 73 20 53 51  QLite returns SQ
ae40: 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 0a  LITE_CONSTRAINT.
ae50: 2a 2a 20 20 20 28 77 68 69 63 68 20 63 61 6e 20  **   (which can 
ae60: 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 66 20 61  only happen if a
ae70: 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e   foreign key con
ae80: 73 74 72 61 69 6e 74 20 69 73 20 76 69 6f 6c 61  straint is viola
ae90: 74 65 64 29 2c 20 74 68 65 0a 2a 2a 20 20 20 63  ted), the.**   c
aea0: 6f 6e 66 6c 69 63 74 2d 68 61 6e 64 6c 65 72 20  onflict-handler 
aeb0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e 76 6f  function is invo
aec0: 6b 65 64 20 77 69 74 68 20 5b 53 51 4c 49 54 45  ked with [SQLITE
aed0: 5f 43 48 41 4e 47 45 53 45 54 5f 43 4f 4e 53 54  _CHANGESET_CONST
aee0: 52 41 49 4e 54 5d 0a 2a 2a 20 20 20 70 61 73 73  RAINT].**   pass
aef0: 65 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64  ed as the second
af00: 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 69 73 20   argument. This 
af10: 69 6e 63 6c 75 64 65 73 20 74 68 65 20 63 61 73  includes the cas
af20: 65 20 77 68 65 72 65 20 74 68 65 20 44 45 4c 45  e where the DELE
af30: 54 45 0a 2a 2a 20 20 20 6f 70 65 72 61 74 69 6f  TE.**   operatio
af40: 6e 20 69 73 20 61 74 74 65 6d 70 74 65 64 20 62  n is attempted b
af50: 65 63 61 75 73 65 20 61 6e 20 65 61 72 6c 69 65  ecause an earlie
af60: 72 20 63 61 6c 6c 20 74 6f 20 74 68 65 20 63 6f  r call to the co
af70: 6e 66 6c 69 63 74 20 68 61 6e 64 6c 65 72 0a 2a  nflict handler.*
af80: 2a 20 20 20 66 75 6e 63 74 69 6f 6e 20 72 65 74  *   function ret
af90: 75 72 6e 65 64 20 5b 53 51 4c 49 54 45 5f 43 48  urned [SQLITE_CH
afa0: 41 4e 47 45 53 45 54 5f 52 45 50 4c 41 43 45 5d  ANGESET_REPLACE]
afb0: 2e 0a 2a 2a 0a 2a 2a 20 3c 64 74 3e 49 4e 53 45  ..**.** <dt>INSE
afc0: 52 54 20 43 68 61 6e 67 65 73 3c 64 64 3e 0a 2a  RT Changes<dd>.*
afd0: 2a 20 20 20 46 6f 72 20 65 61 63 68 20 49 4e 53  *   For each INS
afe0: 45 52 54 20 63 68 61 6e 67 65 2c 20 61 6e 20 61  ERT change, an a
aff0: 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74  ttempt is made t
b000: 6f 20 69 6e 73 65 72 74 20 74 68 65 20 6e 65 77  o insert the new
b010: 20 72 6f 77 20 69 6e 74 6f 0a 2a 2a 20 20 20 74   row into.**   t
b020: 68 65 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a 0a  he database..**.
b030: 2a 2a 20 20 20 49 66 20 74 68 65 20 61 74 74 65  **   If the atte
b040: 6d 70 74 20 74 6f 20 69 6e 73 65 72 74 20 74 68  mpt to insert th
b050: 65 20 72 6f 77 20 66 61 69 6c 73 20 62 65 63 61  e row fails beca
b060: 75 73 65 20 74 68 65 20 64 61 74 61 62 61 73 65  use the database
b070: 20 61 6c 72 65 61 64 79 20 0a 2a 2a 20 20 20 63   already .**   c
b080: 6f 6e 74 61 69 6e 73 20 61 20 72 6f 77 20 77 69  ontains a row wi
b090: 74 68 20 74 68 65 20 73 61 6d 65 20 70 72 69 6d  th the same prim
b0a0: 61 72 79 20 6b 65 79 20 76 61 6c 75 65 73 2c 20  ary key values, 
b0b0: 74 68 65 20 63 6f 6e 66 6c 69 63 74 20 68 61 6e  the conflict han
b0c0: 64 6c 65 72 0a 2a 2a 20 20 20 66 75 6e 63 74 69  dler.**   functi
b0d0: 6f 6e 20 69 73 20 69 6e 76 6f 6b 65 64 20 77 69  on is invoked wi
b0e0: 74 68 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72  th the second ar
b0f0: 67 75 6d 65 6e 74 20 73 65 74 20 74 6f 20 0a 2a  gument set to .*
b100: 2a 20 20 20 5b 53 51 4c 49 54 45 5f 43 48 41 4e  *   [SQLITE_CHAN
b110: 47 45 53 45 54 5f 43 4f 4e 46 4c 49 43 54 5d 2e  GESET_CONFLICT].
b120: 0a 2a 2a 0a 2a 2a 20 20 20 49 66 20 74 68 65 20  .**.**   If the 
b130: 61 74 74 65 6d 70 74 20 74 6f 20 69 6e 73 65 72  attempt to inser
b140: 74 20 74 68 65 20 72 6f 77 20 66 61 69 6c 73 20  t the row fails 
b150: 62 65 63 61 75 73 65 20 6f 66 20 73 6f 6d 65 20  because of some 
b160: 6f 74 68 65 72 20 63 6f 6e 73 74 72 61 69 6e 74  other constraint
b170: 0a 2a 2a 20 20 20 76 69 6f 6c 61 74 69 6f 6e 20  .**   violation 
b180: 28 65 2e 67 2e 20 4e 4f 54 20 4e 55 4c 4c 20 6f  (e.g. NOT NULL o
b190: 72 20 55 4e 49 51 55 45 29 2c 20 74 68 65 20 63  r UNIQUE), the c
b1a0: 6f 6e 66 6c 69 63 74 20 68 61 6e 64 6c 65 72 20  onflict handler 
b1b0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 0a 2a 2a 20  function is .** 
b1c0: 20 20 69 6e 76 6f 6b 65 64 20 77 69 74 68 20 74    invoked with t
b1d0: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65  he second argume
b1e0: 6e 74 20 73 65 74 20 74 6f 20 5b 53 51 4c 49 54  nt set to [SQLIT
b1f0: 45 5f 43 48 41 4e 47 45 53 45 54 5f 43 4f 4e 53  E_CHANGESET_CONS
b200: 54 52 41 49 4e 54 5d 2e 0a 2a 2a 20 20 20 54 68  TRAINT]..**   Th
b210: 69 73 20 69 6e 63 6c 75 64 65 73 20 74 68 65 20  is includes the 
b220: 63 61 73 65 20 77 68 65 72 65 20 74 68 65 20 49  case where the I
b230: 4e 53 45 52 54 20 6f 70 65 72 61 74 69 6f 6e 20  NSERT operation 
b240: 69 73 20 72 65 2d 61 74 74 65 6d 70 74 65 64 20  is re-attempted 
b250: 62 65 63 61 75 73 65 20 0a 2a 2a 20 20 20 61 6e  because .**   an
b260: 20 65 61 72 6c 69 65 72 20 63 61 6c 6c 20 74 6f   earlier call to
b270: 20 74 68 65 20 63 6f 6e 66 6c 69 63 74 20 68 61   the conflict ha
b280: 6e 64 6c 65 72 20 66 75 6e 63 74 69 6f 6e 20 72  ndler function r
b290: 65 74 75 72 6e 65 64 20 0a 2a 2a 20 20 20 5b 53  eturned .**   [S
b2a0: 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f  QLITE_CHANGESET_
b2b0: 52 45 50 4c 41 43 45 5d 2e 0a 2a 2a 0a 2a 2a 20  REPLACE]..**.** 
b2c0: 3c 64 74 3e 55 50 44 41 54 45 20 43 68 61 6e 67  <dt>UPDATE Chang
b2d0: 65 73 3c 64 64 3e 0a 2a 2a 20 20 20 46 6f 72 20  es<dd>.**   For 
b2e0: 65 61 63 68 20 55 50 44 41 54 45 20 63 68 61 6e  each UPDATE chan
b2f0: 67 65 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f  ge, this functio
b300: 6e 20 63 68 65 63 6b 73 20 69 66 20 74 68 65 20  n checks if the 
b310: 74 61 72 67 65 74 20 64 61 74 61 62 61 73 65 20  target database 
b320: 0a 2a 2a 20 20 20 63 6f 6e 74 61 69 6e 73 20 61  .**   contains a
b330: 20 72 6f 77 20 77 69 74 68 20 74 68 65 20 73 61   row with the sa
b340: 6d 65 20 70 72 69 6d 61 72 79 20 6b 65 79 20 76  me primary key v
b350: 61 6c 75 65 20 28 6f 72 20 76 61 6c 75 65 73 29  alue (or values)
b360: 20 61 73 20 74 68 65 20 0a 2a 2a 20 20 20 6f 72   as the .**   or
b370: 69 67 69 6e 61 6c 20 72 6f 77 20 76 61 6c 75 65  iginal row value
b380: 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20  s stored in the 
b390: 63 68 61 6e 67 65 73 65 74 2e 20 49 66 20 69 74  changeset. If it
b3a0: 20 64 6f 65 73 2c 20 61 6e 64 20 74 68 65 20 76   does, and the v
b3b0: 61 6c 75 65 73 20 0a 2a 2a 20 20 20 73 74 6f 72  alues .**   stor
b3c0: 65 64 20 69 6e 20 61 6c 6c 20 6e 6f 6e 2d 70 72  ed in all non-pr
b3d0: 69 6d 61 72 79 20 6b 65 79 20 63 6f 6c 75 6d 6e  imary key column
b3e0: 73 20 61 6c 73 6f 20 6d 61 74 63 68 20 74 68 65  s also match the
b3f0: 20 76 61 6c 75 65 73 20 73 74 6f 72 65 64 20 69   values stored i
b400: 6e 20 0a 2a 2a 20 20 20 74 68 65 20 63 68 61 6e  n .**   the chan
b410: 67 65 73 65 74 20 74 68 65 20 72 6f 77 20 69 73  geset the row is
b420: 20 75 70 64 61 74 65 64 20 77 69 74 68 69 6e 20   updated within 
b430: 74 68 65 20 74 61 72 67 65 74 20 64 61 74 61 62  the target datab
b440: 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 49 66 20  ase..**.**   If 
b450: 61 20 72 6f 77 20 77 69 74 68 20 6d 61 74 63 68  a row with match
b460: 69 6e 67 20 70 72 69 6d 61 72 79 20 6b 65 79 20  ing primary key 
b470: 76 61 6c 75 65 73 20 69 73 20 66 6f 75 6e 64 2c  values is found,
b480: 20 62 75 74 20 6f 6e 65 20 6f 72 20 6d 6f 72 65   but one or more
b490: 20 6f 66 0a 2a 2a 20 20 20 74 68 65 20 6e 6f 6e   of.**   the non
b4a0: 2d 70 72 69 6d 61 72 79 20 6b 65 79 20 66 69 65  -primary key fie
b4b0: 6c 64 73 20 63 6f 6e 74 61 69 6e 73 20 61 20 76  lds contains a v
b4c0: 61 6c 75 65 20 64 69 66 66 65 72 65 6e 74 20 66  alue different f
b4d0: 72 6f 6d 20 61 6e 20 6f 72 69 67 69 6e 61 6c 0a  rom an original.
b4e0: 2a 2a 20 20 20 72 6f 77 20 76 61 6c 75 65 20 73  **   row value s
b4f0: 74 6f 72 65 64 20 69 6e 20 74 68 65 20 63 68 61  tored in the cha
b500: 6e 67 65 73 65 74 2c 20 74 68 65 20 63 6f 6e 66  ngeset, the conf
b510: 6c 69 63 74 2d 68 61 6e 64 6c 65 72 20 66 75 6e  lict-handler fun
b520: 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 20 20 69 6e  ction is.**   in
b530: 76 6f 6b 65 64 20 77 69 74 68 20 5b 53 51 4c 49  voked with [SQLI
b540: 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 44 41 54  TE_CHANGESET_DAT
b550: 41 5d 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64  A] as the second
b560: 20 61 72 67 75 6d 65 6e 74 2e 20 53 69 6e 63 65   argument. Since
b570: 0a 2a 2a 20 20 20 55 50 44 41 54 45 20 63 68 61  .**   UPDATE cha
b580: 6e 67 65 73 20 6f 6e 6c 79 20 63 6f 6e 74 61 69  nges only contai
b590: 6e 20 76 61 6c 75 65 73 20 66 6f 72 20 6e 6f 6e  n values for non
b5a0: 2d 70 72 69 6d 61 72 79 20 6b 65 79 20 66 69 65  -primary key fie
b5b0: 6c 64 73 20 74 68 61 74 20 61 72 65 0a 2a 2a 20  lds that are.** 
b5c0: 20 20 74 6f 20 62 65 20 6d 6f 64 69 66 69 65 64    to be modified
b5d0: 2c 20 6f 6e 6c 79 20 74 68 6f 73 65 20 66 69 65  , only those fie
b5e0: 6c 64 73 20 6e 65 65 64 20 74 6f 20 6d 61 74 63  lds need to matc
b5f0: 68 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 76  h the original v
b600: 61 6c 75 65 73 20 74 6f 0a 2a 2a 20 20 20 61 76  alues to.**   av
b610: 6f 69 64 20 74 68 65 20 53 51 4c 49 54 45 5f 43  oid the SQLITE_C
b620: 48 41 4e 47 45 53 45 54 5f 44 41 54 41 20 63 6f  HANGESET_DATA co
b630: 6e 66 6c 69 63 74 2d 68 61 6e 64 6c 65 72 20 63  nflict-handler c
b640: 61 6c 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 20  allback..**.**  
b650: 20 49 66 20 6e 6f 20 72 6f 77 20 77 69 74 68 20   If no row with 
b660: 6d 61 74 63 68 69 6e 67 20 70 72 69 6d 61 72 79  matching primary
b670: 20 6b 65 79 20 76 61 6c 75 65 73 20 69 73 20 66   key values is f
b680: 6f 75 6e 64 20 69 6e 20 74 68 65 20 64 61 74 61  ound in the data
b690: 62 61 73 65 2c 0a 2a 2a 20 20 20 74 68 65 20 63  base,.**   the c
b6a0: 6f 6e 66 6c 69 63 74 2d 68 61 6e 64 6c 65 72 20  onflict-handler 
b6b0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e 76 6f  function is invo
b6c0: 6b 65 64 20 77 69 74 68 20 5b 53 51 4c 49 54 45  ked with [SQLITE
b6d0: 5f 43 48 41 4e 47 45 53 45 54 5f 4e 4f 54 46 4f  _CHANGESET_NOTFO
b6e0: 55 4e 44 5d 0a 2a 2a 20 20 20 70 61 73 73 65 64  UND].**   passed
b6f0: 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 20 61   as the second a
b700: 72 67 75 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 20  rgument..**.**  
b710: 20 49 66 20 74 68 65 20 55 50 44 41 54 45 20 6f   If the UPDATE o
b720: 70 65 72 61 74 69 6f 6e 20 69 73 20 61 74 74 65  peration is atte
b730: 6d 70 74 65 64 2c 20 62 75 74 20 53 51 4c 69 74  mpted, but SQLit
b740: 65 20 72 65 74 75 72 6e 73 20 0a 2a 2a 20 20 20  e returns .**   
b750: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e  SQLITE_CONSTRAIN
b760: 54 2c 20 74 68 65 20 63 6f 6e 66 6c 69 63 74 2d  T, the conflict-
b770: 68 61 6e 64 6c 65 72 20 66 75 6e 63 74 69 6f 6e  handler function
b780: 20 69 73 20 69 6e 76 6f 6b 65 64 20 77 69 74 68   is invoked with
b790: 20 0a 2a 2a 20 20 20 5b 53 51 4c 49 54 45 5f 43   .**   [SQLITE_C
b7a0: 48 41 4e 47 45 53 45 54 5f 43 4f 4e 53 54 52 41  HANGESET_CONSTRA
b7b0: 49 4e 54 5d 20 70 61 73 73 65 64 20 61 73 20 74  INT] passed as t
b7c0: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65  he second argume
b7d0: 6e 74 2e 0a 2a 2a 20 20 20 54 68 69 73 20 69 6e  nt..**   This in
b7e0: 63 6c 75 64 65 73 20 74 68 65 20 63 61 73 65 20  cludes the case 
b7f0: 77 68 65 72 65 20 74 68 65 20 55 50 44 41 54 45  where the UPDATE
b800: 20 6f 70 65 72 61 74 69 6f 6e 20 69 73 20 61 74   operation is at
b810: 74 65 6d 70 74 65 64 20 61 66 74 65 72 20 0a 2a  tempted after .*
b820: 2a 20 20 20 61 6e 20 65 61 72 6c 69 65 72 20 63  *   an earlier c
b830: 61 6c 6c 20 74 6f 20 74 68 65 20 63 6f 6e 66 6c  all to the confl
b840: 69 63 74 20 68 61 6e 64 6c 65 72 20 66 75 6e 63  ict handler func
b850: 74 69 6f 6e 20 72 65 74 75 72 6e 65 64 0a 2a 2a  tion returned.**
b860: 20 20 20 5b 53 51 4c 49 54 45 5f 43 48 41 4e 47     [SQLITE_CHANG
b870: 45 53 45 54 5f 52 45 50 4c 41 43 45 5d 2e 20 20  ESET_REPLACE].  
b880: 0a 2a 2a 20 3c 2f 64 6c 3e 0a 2a 2a 0a 2a 2a 20  .** </dl>.**.** 
b890: 49 74 20 69 73 20 73 61 66 65 20 74 6f 20 65 78  It is safe to ex
b8a0: 65 63 75 74 65 20 53 51 4c 20 73 74 61 74 65 6d  ecute SQL statem
b8b0: 65 6e 74 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20  ents, including 
b8c0: 74 68 6f 73 65 20 74 68 61 74 20 77 72 69 74 65  those that write
b8d0: 20 74 6f 20 74 68 65 0a 2a 2a 20 74 61 62 6c 65   to the.** table
b8e0: 20 74 68 61 74 20 74 68 65 20 63 61 6c 6c 62 61   that the callba
b8f0: 63 6b 20 72 65 6c 61 74 65 64 20 74 6f 2c 20 66  ck related to, f
b900: 72 6f 6d 20 77 69 74 68 69 6e 20 74 68 65 20 78  rom within the x
b910: 43 6f 6e 66 6c 69 63 74 20 63 61 6c 6c 62 61 63  Conflict callbac
b920: 6b 2e 0a 2a 2a 20 54 68 69 73 20 63 61 6e 20 62  k..** This can b
b930: 65 20 75 73 65 64 20 74 6f 20 66 75 72 74 68 65  e used to furthe
b940: 72 20 63 75 73 74 6f 6d 69 7a 65 20 74 68 65 20  r customize the 
b950: 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 63 6f 6e  applications con
b960: 66 6c 69 63 74 0a 2a 2a 20 72 65 73 6f 6c 75 74  flict.** resolut
b970: 69 6f 6e 20 73 74 72 61 74 65 67 79 2e 0a 2a 2a  ion strategy..**
b980: 0a 2a 2a 20 41 6c 6c 20 63 68 61 6e 67 65 73 20  .** All changes 
b990: 6d 61 64 65 20 62 79 20 74 68 69 73 20 66 75 6e  made by this fun
b9a0: 63 74 69 6f 6e 20 61 72 65 20 65 6e 63 6c 6f 73  ction are enclos
b9b0: 65 64 20 69 6e 20 61 20 73 61 76 65 70 6f 69 6e  ed in a savepoin
b9c0: 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a  t transaction..*
b9d0: 2a 20 49 66 20 61 6e 79 20 6f 74 68 65 72 20 65  * If any other e
b9e0: 72 72 6f 72 20 28 61 73 69 64 65 20 66 72 6f 6d  rror (aside from
b9f0: 20 61 20 63 6f 6e 73 74 72 61 69 6e 74 20 66 61   a constraint fa
ba00: 69 6c 75 72 65 20 77 68 65 6e 20 61 74 74 65 6d  ilure when attem
ba10: 70 74 69 6e 67 20 74 6f 0a 2a 2a 20 77 72 69 74  pting to.** writ
ba20: 65 20 74 6f 20 74 68 65 20 74 61 72 67 65 74 20  e to the target 
ba30: 64 61 74 61 62 61 73 65 29 20 6f 63 63 75 72 73  database) occurs
ba40: 2c 20 74 68 65 6e 20 74 68 65 20 73 61 76 65 70  , then the savep
ba50: 6f 69 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e  oint transaction
ba60: 20 69 73 0a 2a 2a 20 72 6f 6c 6c 65 64 20 62 61   is.** rolled ba
ba70: 63 6b 2c 20 72 65 73 74 6f 72 69 6e 67 20 74 68  ck, restoring th
ba80: 65 20 74 61 72 67 65 74 20 64 61 74 61 62 61 73  e target databas
ba90: 65 20 74 6f 20 69 74 73 20 6f 72 69 67 69 6e 61  e to its origina
baa0: 6c 20 73 74 61 74 65 2c 20 61 6e 64 20 61 6e 20  l state, and an 
bab0: 0a 2a 2a 20 53 51 4c 69 74 65 20 65 72 72 6f 72  .** SQLite error
bac0: 20 63 6f 64 65 20 72 65 74 75 72 6e 65 64 2e 0a   code returned..
bad0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 63 68  */.int sqlite3ch
bae0: 61 6e 67 65 73 65 74 5f 61 70 70 6c 79 28 0a 20  angeset_apply(. 
baf0: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20   sqlite3 *db,   
bb00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
bb10: 20 2f 2a 20 41 70 70 6c 79 20 63 68 61 6e 67 65   /* Apply change
bb20: 20 74 6f 20 22 6d 61 69 6e 22 20 64 62 20 6f 66   to "main" db of
bb30: 20 74 68 69 73 20 68 61 6e 64 6c 65 20 2a 2f 0a   this handle */.
bb40: 20 20 69 6e 74 20 6e 43 68 61 6e 67 65 73 65 74    int nChangeset
bb50: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
bb60: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 63 68 61    /* Size of cha
bb70: 6e 67 65 73 65 74 20 69 6e 20 62 79 74 65 73 20  ngeset in bytes 
bb80: 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 43 68 61 6e  */.  void *pChan
bb90: 67 65 73 65 74 2c 20 20 20 20 20 20 20 20 20 20  geset,          
bba0: 20 20 20 20 20 2f 2a 20 43 68 61 6e 67 65 73 65       /* Changese
bbb0: 74 20 62 6c 6f 62 20 2a 2f 0a 20 20 69 6e 74 28  t blob */.  int(
bbc0: 2a 78 46 69 6c 74 65 72 29 28 0a 20 20 20 20 76  *xFilter)(.    v
bbd0: 6f 69 64 20 2a 70 43 74 78 2c 20 20 20 20 20 20  oid *pCtx,      
bbe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
bbf0: 43 6f 70 79 20 6f 66 20 73 69 78 74 68 20 61 72  Copy of sixth ar
bc00: 67 20 74 6f 20 5f 61 70 70 6c 79 28 29 20 2a 2f  g to _apply() */
bc10: 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20  .    const char 
bc20: 2a 7a 54 61 62 20 20 20 20 20 20 20 20 20 20 20  *zTab           
bc30: 20 20 20 2f 2a 20 54 61 62 6c 65 20 6e 61 6d 65     /* Table name
bc40: 20 2a 2f 0a 20 20 29 2c 0a 20 20 69 6e 74 28 2a   */.  ),.  int(*
bc50: 78 43 6f 6e 66 6c 69 63 74 29 28 0a 20 20 20 20  xConflict)(.    
bc60: 76 6f 69 64 20 2a 70 43 74 78 2c 20 20 20 20 20  void *pCtx,     
bc70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
bc80: 20 43 6f 70 79 20 6f 66 20 73 69 78 74 68 20 61   Copy of sixth a
bc90: 72 67 20 74 6f 20 5f 61 70 70 6c 79 28 29 20 2a  rg to _apply() *
bca0: 2f 0a 20 20 20 20 69 6e 74 20 65 43 6f 6e 66 6c  /.    int eConfl
bcb0: 69 63 74 2c 20 20 20 20 20 20 20 20 20 20 20 20  ict,            
bcc0: 20 20 20 20 2f 2a 20 44 41 54 41 2c 20 4d 49 53      /* DATA, MIS
bcd0: 53 49 4e 47 2c 20 43 4f 4e 46 4c 49 43 54 2c 20  SING, CONFLICT, 
bce0: 43 4f 4e 53 54 52 41 49 4e 54 20 2a 2f 0a 20 20  CONSTRAINT */.  
bcf0: 20 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65    sqlite3_change
bd00: 73 65 74 5f 69 74 65 72 20 2a 70 20 20 20 20 20  set_iter *p     
bd10: 2f 2a 20 48 61 6e 64 6c 65 20 64 65 73 63 72 69  /* Handle descri
bd20: 62 69 6e 67 20 63 68 61 6e 67 65 20 61 6e 64 20  bing change and 
bd30: 63 6f 6e 66 6c 69 63 74 20 2a 2f 0a 20 20 29 2c  conflict */.  ),
bd40: 0a 20 20 76 6f 69 64 20 2a 70 43 74 78 20 20 20  .  void *pCtx   
bd50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
bd60: 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 75     /* First argu
bd70: 6d 65 6e 74 20 70 61 73 73 65 64 20 74 6f 20 78  ment passed to x
bd80: 43 6f 6e 66 6c 69 63 74 20 2a 2f 0a 29 3b 0a 0a  Conflict */.);..
bd90: 2f 2a 20 0a 2a 2a 20 43 41 50 49 33 52 45 46 3a  /* .** CAPI3REF:
bda0: 20 43 6f 6e 73 74 61 6e 74 73 20 50 61 73 73 65   Constants Passe
bdb0: 64 20 54 6f 20 54 68 65 20 43 6f 6e 66 6c 69 63  d To The Conflic
bdc0: 74 20 48 61 6e 64 6c 65 72 0a 2a 2a 0a 2a 2a 20  t Handler.**.** 
bdd0: 56 61 6c 75 65 73 20 74 68 61 74 20 6d 61 79 20  Values that may 
bde0: 62 65 20 70 61 73 73 65 64 20 61 73 20 74 68 65  be passed as the
bdf0: 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74   second argument
be00: 20 74 6f 20 61 20 63 6f 6e 66 6c 69 63 74 2d 68   to a conflict-h
be10: 61 6e 64 6c 65 72 2e 0a 2a 2a 0a 2a 2a 20 3c 64  andler..**.** <d
be20: 6c 3e 0a 2a 2a 20 3c 64 74 3e 53 51 4c 49 54 45  l>.** <dt>SQLITE
be30: 5f 43 48 41 4e 47 45 53 45 54 5f 44 41 54 41 3c  _CHANGESET_DATA<
be40: 64 64 3e 0a 2a 2a 20 20 20 54 68 65 20 63 6f 6e  dd>.**   The con
be50: 66 6c 69 63 74 20 68 61 6e 64 6c 65 72 20 69 73  flict handler is
be60: 20 69 6e 76 6f 6b 65 64 20 77 69 74 68 20 43 48   invoked with CH
be70: 41 4e 47 45 53 45 54 5f 44 41 54 41 20 61 73 20  ANGESET_DATA as 
be80: 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d  the second argum
be90: 65 6e 74 0a 2a 2a 20 20 20 77 68 65 6e 20 70 72  ent.**   when pr
bea0: 6f 63 65 73 73 69 6e 67 20 61 20 44 45 4c 45 54  ocessing a DELET
beb0: 45 20 6f 72 20 55 50 44 41 54 45 20 63 68 61 6e  E or UPDATE chan
bec0: 67 65 20 69 66 20 61 20 72 6f 77 20 77 69 74 68  ge if a row with
bed0: 20 74 68 65 20 72 65 71 75 69 72 65 64 0a 2a 2a   the required.**
bee0: 20 20 20 50 52 49 4d 41 52 59 20 4b 45 59 20 66     PRIMARY KEY f
bef0: 69 65 6c 64 73 20 69 73 20 70 72 65 73 65 6e 74  ields is present
bf00: 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65   in the database
bf10: 2c 20 62 75 74 20 6f 6e 65 20 6f 72 20 6d 6f 72  , but one or mor
bf20: 65 20 6f 74 68 65 72 20 0a 2a 2a 20 20 20 28 6e  e other .**   (n
bf30: 6f 6e 20 70 72 69 6d 61 72 79 2d 6b 65 79 29 20  on primary-key) 
bf40: 66 69 65 6c 64 73 20 6d 6f 64 69 66 69 65 64 20  fields modified 
bf50: 62 79 20 74 68 65 20 75 70 64 61 74 65 20 64 6f  by the update do
bf60: 20 6e 6f 74 20 63 6f 6e 74 61 69 6e 20 74 68 65   not contain the
bf70: 20 0a 2a 2a 20 20 20 65 78 70 65 63 74 65 64 20   .**   expected 
bf80: 22 62 65 66 6f 72 65 22 20 76 61 6c 75 65 73 2e  "before" values.
bf90: 0a 2a 2a 20 0a 2a 2a 20 20 20 54 68 65 20 63 6f  .** .**   The co
bfa0: 6e 66 6c 69 63 74 69 6e 67 20 72 6f 77 2c 20 69  nflicting row, i
bfb0: 6e 20 74 68 69 73 20 63 61 73 65 2c 20 69 73 20  n this case, is 
bfc0: 74 68 65 20 64 61 74 61 62 61 73 65 20 72 6f 77  the database row
bfd0: 20 77 69 74 68 20 74 68 65 20 6d 61 74 63 68 69   with the matchi
bfe0: 6e 67 0a 2a 2a 20 20 20 70 72 69 6d 61 72 79 20  ng.**   primary 
bff0: 6b 65 79 2e 0a 2a 2a 20 0a 2a 2a 20 3c 64 74 3e  key..** .** <dt>
c000: 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54  SQLITE_CHANGESET
c010: 5f 4e 4f 54 46 4f 55 4e 44 3c 64 64 3e 0a 2a 2a  _NOTFOUND<dd>.**
c020: 20 20 20 54 68 65 20 63 6f 6e 66 6c 69 63 74 20     The conflict 
c030: 68 61 6e 64 6c 65 72 20 69 73 20 69 6e 76 6f 6b  handler is invok
c040: 65 64 20 77 69 74 68 20 43 48 41 4e 47 45 53 45  ed with CHANGESE
c050: 54 5f 4e 4f 54 46 4f 55 4e 44 20 61 73 20 74 68  T_NOTFOUND as th
c060: 65 20 73 65 63 6f 6e 64 0a 2a 2a 20 20 20 61 72  e second.**   ar
c070: 67 75 6d 65 6e 74 20 77 68 65 6e 20 70 72 6f 63  gument when proc
c080: 65 73 73 69 6e 67 20 61 20 44 45 4c 45 54 45 20  essing a DELETE 
c090: 6f 72 20 55 50 44 41 54 45 20 63 68 61 6e 67 65  or UPDATE change
c0a0: 20 69 66 20 61 20 72 6f 77 20 77 69 74 68 20 74   if a row with t
c0b0: 68 65 0a 2a 2a 20 20 20 72 65 71 75 69 72 65 64  he.**   required
c0c0: 20 50 52 49 4d 41 52 59 20 4b 45 59 20 66 69 65   PRIMARY KEY fie
c0d0: 6c 64 73 20 69 73 20 6e 6f 74 20 70 72 65 73 65  lds is not prese
c0e0: 6e 74 20 69 6e 20 74 68 65 20 64 61 74 61 62 61  nt in the databa
c0f0: 73 65 2e 0a 2a 2a 20 0a 2a 2a 20 20 20 54 68 65  se..** .**   The
c100: 72 65 20 69 73 20 6e 6f 20 63 6f 6e 66 6c 69 63  re is no conflic
c110: 74 69 6e 67 20 72 6f 77 20 69 6e 20 74 68 69 73  ting row in this
c120: 20 63 61 73 65 2e 20 54 68 65 20 72 65 73 75 6c   case. The resul
c130: 74 73 20 6f 66 20 69 6e 76 6f 6b 69 6e 67 20 74  ts of invoking t
c140: 68 65 0a 2a 2a 20 20 20 73 71 6c 69 74 65 33 63  he.**   sqlite3c
c150: 68 61 6e 67 65 73 65 74 5f 63 6f 6e 66 6c 69 63  hangeset_conflic
c160: 74 28 29 20 41 50 49 20 61 72 65 20 75 6e 64 65  t() API are unde
c170: 66 69 6e 65 64 2e 0a 2a 2a 20 0a 2a 2a 20 3c 64  fined..** .** <d
c180: 74 3e 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53  t>SQLITE_CHANGES
c190: 45 54 5f 43 4f 4e 46 4c 49 43 54 3c 64 64 3e 0a  ET_CONFLICT<dd>.
c1a0: 2a 2a 20 20 20 43 48 41 4e 47 45 53 45 54 5f 43  **   CHANGESET_C
c1b0: 4f 4e 46 4c 49 43 54 20 69 73 20 70 61 73 73 65  ONFLICT is passe
c1c0: 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 20  d as the second 
c1d0: 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20  argument to the 
c1e0: 63 6f 6e 66 6c 69 63 74 0a 2a 2a 20 20 20 68 61  conflict.**   ha
c1f0: 6e 64 6c 65 72 20 77 68 69 6c 65 20 70 72 6f 63  ndler while proc
c200: 65 73 73 69 6e 67 20 61 6e 20 49 4e 53 45 52 54  essing an INSERT
c210: 20 63 68 61 6e 67 65 20 69 66 20 74 68 65 20 6f   change if the o
c220: 70 65 72 61 74 69 6f 6e 20 77 6f 75 6c 64 20 72  peration would r
c230: 65 73 75 6c 74 20 0a 2a 2a 20 20 20 69 6e 20 64  esult .**   in d
c240: 75 70 6c 69 63 61 74 65 20 70 72 69 6d 61 72 79  uplicate primary
c250: 20 6b 65 79 20 76 61 6c 75 65 73 2e 0a 2a 2a 20   key values..** 
c260: 0a 2a 2a 20 20 20 54 68 65 20 63 6f 6e 66 6c 69  .**   The confli
c270: 63 74 69 6e 67 20 72 6f 77 20 69 6e 20 74 68 69  cting row in thi
c280: 73 20 63 61 73 65 20 69 73 20 74 68 65 20 64 61  s case is the da
c290: 74 61 62 61 73 65 20 72 6f 77 20 77 69 74 68 20  tabase row with 
c2a0: 74 68 65 20 6d 61 74 63 68 69 6e 67 0a 2a 2a 20  the matching.** 
c2b0: 20 20 70 72 69 6d 61 72 79 20 6b 65 79 2e 0a 2a    primary key..*
c2c0: 2a 0a 2a 2a 20 3c 64 74 3e 53 51 4c 49 54 45 5f  *.** <dt>SQLITE_
c2d0: 43 48 41 4e 47 45 53 45 54 5f 46 4f 52 45 49 47  CHANGESET_FOREIG
c2e0: 4e 5f 4b 45 59 3c 64 64 3e 0a 2a 2a 20 20 20 49  N_KEY<dd>.**   I
c2f0: 66 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 68 61  f foreign key ha
c300: 6e 64 6c 69 6e 67 20 69 73 20 65 6e 61 62 6c 65  ndling is enable
c310: 64 2c 20 61 6e 64 20 61 70 70 6c 79 69 6e 67 20  d, and applying 
c320: 61 20 63 68 61 6e 67 65 73 65 74 20 6c 65 61 76  a changeset leav
c330: 65 73 20 74 68 65 0a 2a 2a 20 20 20 64 61 74 61  es the.**   data
c340: 62 61 73 65 20 69 6e 20 61 20 73 74 61 74 65 20  base in a state 
c350: 63 6f 6e 74 61 69 6e 69 6e 67 20 66 6f 72 65 69  containing forei
c360: 67 6e 20 6b 65 79 20 76 69 6f 6c 61 74 69 6f 6e  gn key violation
c370: 73 2c 20 74 68 65 20 63 6f 6e 66 6c 69 63 74 20  s, the conflict 
c380: 0a 2a 2a 20 20 20 68 61 6e 64 6c 65 72 20 69 73  .**   handler is
c390: 20 69 6e 76 6f 6b 65 64 20 77 69 74 68 20 43 48   invoked with CH
c3a0: 41 4e 47 45 53 45 54 5f 46 4f 52 45 49 47 4e 5f  ANGESET_FOREIGN_
c3b0: 4b 45 59 20 61 73 20 74 68 65 20 73 65 63 6f 6e  KEY as the secon
c3c0: 64 20 61 72 67 75 6d 65 6e 74 0a 2a 2a 20 20 20  d argument.**   
c3d0: 65 78 61 63 74 6c 79 20 6f 6e 63 65 20 62 65 66  exactly once bef
c3e0: 6f 72 65 20 74 68 65 20 63 68 61 6e 67 65 73 65  ore the changese
c3f0: 74 20 69 73 20 63 6f 6d 6d 69 74 74 65 64 2e 20  t is committed. 
c400: 49 66 20 74 68 65 20 63 6f 6e 66 6c 69 63 74 20  If the conflict 
c410: 68 61 6e 64 6c 65 72 0a 2a 2a 20 20 20 72 65 74  handler.**   ret
c420: 75 72 6e 73 20 43 48 41 4e 47 45 53 45 54 5f 4f  urns CHANGESET_O
c430: 4d 49 54 2c 20 74 68 65 20 63 68 61 6e 67 65 73  MIT, the changes
c440: 2c 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 6f 73  , including thos
c450: 65 20 74 68 61 74 20 63 61 75 73 65 64 20 74 68  e that caused th
c460: 65 0a 2a 2a 20 20 20 66 6f 72 65 69 67 6e 20 6b  e.**   foreign k
c470: 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 76 69  ey constraint vi
c480: 6f 6c 61 74 69 6f 6e 2c 20 61 72 65 20 63 6f 6d  olation, are com
c490: 6d 69 74 74 65 64 2e 20 4f 72 2c 20 69 66 20 69  mitted. Or, if i
c4a0: 74 20 72 65 74 75 72 6e 73 0a 2a 2a 20 20 20 43  t returns.**   C
c4b0: 48 41 4e 47 45 53 45 54 5f 41 42 4f 52 54 2c 20  HANGESET_ABORT, 
c4c0: 74 68 65 20 63 68 61 6e 67 65 73 65 74 20 69 73  the changeset is
c4d0: 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 2a 2a   rolled back..**
c4e0: 0a 2a 2a 20 20 20 4e 6f 20 63 75 72 72 65 6e 74  .**   No current
c4f0: 20 6f 72 20 63 6f 6e 66 6c 69 63 74 69 6e 67 20   or conflicting 
c500: 72 6f 77 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  row information 
c510: 69 73 20 70 72 6f 76 69 64 65 64 2e 20 54 68 65  is provided. The
c520: 20 6f 6e 6c 79 20 66 75 6e 63 74 69 6f 6e 0a 2a   only function.*
c530: 2a 20 20 20 69 74 20 69 73 20 70 6f 73 73 69 62  *   it is possib
c540: 6c 65 20 74 6f 20 63 61 6c 6c 20 6f 6e 20 74 68  le to call on th
c550: 65 20 73 75 70 70 6c 69 65 64 20 73 71 6c 69 74  e supplied sqlit
c560: 65 33 5f 63 68 61 6e 67 65 73 65 74 5f 69 74 65  e3_changeset_ite
c570: 72 20 68 61 6e 64 6c 65 0a 2a 2a 20 20 20 69 73  r handle.**   is
c580: 20 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65   sqlite3changese
c590: 74 5f 66 6b 5f 63 6f 6e 66 6c 69 63 74 73 28 29  t_fk_conflicts()
c5a0: 2e 0a 2a 2a 20 0a 2a 2a 20 3c 64 74 3e 53 51 4c  ..** .** <dt>SQL
c5b0: 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 43 4f  ITE_CHANGESET_CO
c5c0: 4e 53 54 52 41 49 4e 54 3c 64 64 3e 0a 2a 2a 20  NSTRAINT<dd>.** 
c5d0: 20 20 49 66 20 61 6e 79 20 6f 74 68 65 72 20 63    If any other c
c5e0: 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74  onstraint violat
c5f0: 69 6f 6e 20 6f 63 63 75 72 73 20 77 68 69 6c 65  ion occurs while
c600: 20 61 70 70 6c 79 69 6e 67 20 61 20 63 68 61 6e   applying a chan
c610: 67 65 20 28 69 2e 65 2e 20 0a 2a 2a 20 20 20 61  ge (i.e. .**   a
c620: 20 55 4e 49 51 55 45 2c 20 43 48 45 43 4b 20 6f   UNIQUE, CHECK o
c630: 72 20 4e 4f 54 20 4e 55 4c 4c 20 63 6f 6e 73 74  r NOT NULL const
c640: 72 61 69 6e 74 29 2c 20 74 68 65 20 63 6f 6e 66  raint), the conf
c650: 6c 69 63 74 20 68 61 6e 64 6c 65 72 20 69 73 20  lict handler is 
c660: 0a 2a 2a 20 20 20 69 6e 76 6f 6b 65 64 20 77 69  .**   invoked wi
c670: 74 68 20 43 48 41 4e 47 45 53 45 54 5f 43 4f 4e  th CHANGESET_CON
c680: 53 54 52 41 49 4e 54 20 61 73 20 74 68 65 20 73  STRAINT as the s
c690: 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 2e 0a  econd argument..
c6a0: 2a 2a 20 0a 2a 2a 20 20 20 54 68 65 72 65 20 69  ** .**   There i
c6b0: 73 20 6e 6f 20 63 6f 6e 66 6c 69 63 74 69 6e 67  s no conflicting
c6c0: 20 72 6f 77 20 69 6e 20 74 68 69 73 20 63 61 73   row in this cas
c6d0: 65 2e 20 54 68 65 20 72 65 73 75 6c 74 73 20 6f  e. The results o
c6e0: 66 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65 0a 2a  f invoking the.*
c6f0: 2a 20 20 20 73 71 6c 69 74 65 33 63 68 61 6e 67  *   sqlite3chang
c700: 65 73 65 74 5f 63 6f 6e 66 6c 69 63 74 28 29 20  eset_conflict() 
c710: 41 50 49 20 61 72 65 20 75 6e 64 65 66 69 6e 65  API are undefine
c720: 64 2e 0a 2a 2a 0a 2a 2a 20 3c 2f 64 6c 3e 0a 2a  d..**.** </dl>.*
c730: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45  /.#define SQLITE
c740: 5f 43 48 41 4e 47 45 53 45 54 5f 44 41 54 41 20  _CHANGESET_DATA 
c750: 20 20 20 20 20 20 20 31 0a 23 64 65 66 69 6e 65         1.#define
c760: 20 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45   SQLITE_CHANGESE
c770: 54 5f 4e 4f 54 46 4f 55 4e 44 20 20 20 20 32 0a  T_NOTFOUND    2.
c780: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43  #define SQLITE_C
c790: 48 41 4e 47 45 53 45 54 5f 43 4f 4e 46 4c 49 43  HANGESET_CONFLIC
c7a0: 54 20 20 20 20 33 0a 23 64 65 66 69 6e 65 20 53  T    3.#define S
c7b0: 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f  QLITE_CHANGESET_
c7c0: 43 4f 4e 53 54 52 41 49 4e 54 20 20 34 0a 23 64  CONSTRAINT  4.#d
c7d0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 48 41  efine SQLITE_CHA
c7e0: 4e 47 45 53 45 54 5f 46 4f 52 45 49 47 4e 5f 4b  NGESET_FOREIGN_K
c7f0: 45 59 20 35 0a 0a 2f 2a 20 0a 2a 2a 20 43 41 50  EY 5../* .** CAP
c800: 49 33 52 45 46 3a 20 43 6f 6e 73 74 61 6e 74 73  I3REF: Constants
c810: 20 52 65 74 75 72 6e 65 64 20 42 79 20 54 68 65   Returned By The
c820: 20 43 6f 6e 66 6c 69 63 74 20 48 61 6e 64 6c 65   Conflict Handle
c830: 72 0a 2a 2a 0a 2a 2a 20 41 20 63 6f 6e 66 6c 69  r.**.** A confli
c840: 63 74 20 68 61 6e 64 6c 65 72 20 63 61 6c 6c 62  ct handler callb
c850: 61 63 6b 20 6d 75 73 74 20 72 65 74 75 72 6e 20  ack must return 
c860: 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f  one of the follo
c870: 77 69 6e 67 20 74 68 72 65 65 20 76 61 6c 75 65  wing three value
c880: 73 2e 0a 2a 2a 0a 2a 2a 20 3c 64 6c 3e 0a 2a 2a  s..**.** <dl>.**
c890: 20 3c 64 74 3e 53 51 4c 49 54 45 5f 43 48 41 4e   <dt>SQLITE_CHAN
c8a0: 47 45 53 45 54 5f 4f 4d 49 54 3c 64 64 3e 0a 2a  GESET_OMIT<dd>.*
c8b0: 2a 20 20 20 49 66 20 61 20 63 6f 6e 66 6c 69 63  *   If a conflic
c8c0: 74 20 68 61 6e 64 6c 65 72 20 72 65 74 75 72 6e  t handler return
c8d0: 73 20 74 68 69 73 20 76 61 6c 75 65 20 6e 6f 20  s this value no 
c8e0: 73 70 65 63 69 61 6c 20 61 63 74 69 6f 6e 20 69  special action i
c8f0: 73 20 74 61 6b 65 6e 2e 20 54 68 65 0a 2a 2a 20  s taken. The.** 
c900: 20 20 63 68 61 6e 67 65 20 74 68 61 74 20 63 61    change that ca
c910: 75 73 65 64 20 74 68 65 20 63 6f 6e 66 6c 69 63  used the conflic
c920: 74 20 69 73 20 6e 6f 74 20 61 70 70 6c 69 65 64  t is not applied
c930: 2e 20 54 68 65 20 73 65 73 73 69 6f 6e 20 6d 6f  . The session mo
c940: 64 75 6c 65 20 0a 2a 2a 20 20 20 63 6f 6e 74 69  dule .**   conti
c950: 6e 75 65 73 20 74 6f 20 74 68 65 20 6e 65 78 74  nues to the next
c960: 20 63 68 61 6e 67 65 20 69 6e 20 74 68 65 20 63   change in the c
c970: 68 61 6e 67 65 73 65 74 2e 0a 2a 2a 0a 2a 2a 20  hangeset..**.** 
c980: 3c 64 74 3e 53 51 4c 49 54 45 5f 43 48 41 4e 47  <dt>SQLITE_CHANG
c990: 45 53 45 54 5f 52 45 50 4c 41 43 45 3c 64 64 3e  ESET_REPLACE<dd>
c9a0: 0a 2a 2a 20 20 20 54 68 69 73 20 76 61 6c 75 65  .**   This value
c9b0: 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 72 65 74   may only be ret
c9c0: 75 72 6e 65 64 20 69 66 20 74 68 65 20 73 65 63  urned if the sec
c9d0: 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 74 6f 20  ond argument to 
c9e0: 74 68 65 20 63 6f 6e 66 6c 69 63 74 0a 2a 2a 20  the conflict.** 
c9f0: 20 20 68 61 6e 64 6c 65 72 20 77 61 73 20 53 51    handler was SQ
ca00: 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 44  LITE_CHANGESET_D
ca10: 41 54 41 20 6f 72 20 53 51 4c 49 54 45 5f 43 48  ATA or SQLITE_CH
ca20: 41 4e 47 45 53 45 54 5f 43 4f 4e 46 4c 49 43 54  ANGESET_CONFLICT
ca30: 2e 20 49 66 20 74 68 69 73 0a 2a 2a 20 20 20 69  . If this.**   i
ca40: 73 20 6e 6f 74 20 74 68 65 20 63 61 73 65 2c 20  s not the case, 
ca50: 61 6e 79 20 63 68 61 6e 67 65 73 20 61 70 70 6c  any changes appl
ca60: 69 65 64 20 73 6f 20 66 61 72 20 61 72 65 20 72  ied so far are r
ca70: 6f 6c 6c 65 64 20 62 61 63 6b 20 61 6e 64 20 74  olled back and t
ca80: 68 65 20 0a 2a 2a 20 20 20 63 61 6c 6c 20 74 6f  he .**   call to
ca90: 20 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65   sqlite3changese
caa0: 74 5f 61 70 70 6c 79 28 29 20 72 65 74 75 72 6e  t_apply() return
cab0: 73 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2e  s SQLITE_MISUSE.
cac0: 0a 2a 2a 0a 2a 2a 20 20 20 49 66 20 43 48 41 4e  .**.**   If CHAN
cad0: 47 45 53 45 54 5f 52 45 50 4c 41 43 45 20 69 73  GESET_REPLACE is
cae0: 20 72 65 74 75 72 6e 65 64 20 62 79 20 61 6e 20   returned by an 
caf0: 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54  SQLITE_CHANGESET
cb00: 5f 44 41 54 41 20 63 6f 6e 66 6c 69 63 74 0a 2a  _DATA conflict.*
cb10: 2a 20 20 20 68 61 6e 64 6c 65 72 2c 20 74 68 65  *   handler, the
cb20: 6e 20 74 68 65 20 63 6f 6e 66 6c 69 63 74 69 6e  n the conflictin
cb30: 67 20 72 6f 77 20 69 73 20 65 69 74 68 65 72 20  g row is either 
cb40: 75 70 64 61 74 65 64 20 6f 72 20 64 65 6c 65 74  updated or delet
cb50: 65 64 2c 20 64 65 70 65 6e 64 69 6e 67 0a 2a 2a  ed, depending.**
cb60: 20 20 20 6f 6e 20 74 68 65 20 74 79 70 65 20 6f     on the type o
cb70: 66 20 63 68 61 6e 67 65 2e 0a 2a 2a 0a 2a 2a 20  f change..**.** 
cb80: 20 20 49 66 20 43 48 41 4e 47 45 53 45 54 5f 52    If CHANGESET_R
cb90: 45 50 4c 41 43 45 20 69 73 20 72 65 74 75 72 6e  EPLACE is return
cba0: 65 64 20 62 79 20 61 6e 20 53 51 4c 49 54 45 5f  ed by an SQLITE_
cbb0: 43 48 41 4e 47 45 53 45 54 5f 43 4f 4e 46 4c 49  CHANGESET_CONFLI
cbc0: 43 54 20 63 6f 6e 66 6c 69 63 74 0a 2a 2a 20 20  CT conflict.**  
cbd0: 20 68 61 6e 64 6c 65 72 2c 20 74 68 65 6e 20 74   handler, then t
cbe0: 68 65 20 63 6f 6e 66 6c 69 63 74 69 6e 67 20 72  he conflicting r
cbf0: 6f 77 20 69 73 20 72 65 6d 6f 76 65 64 20 66 72  ow is removed fr
cc00: 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 20  om the database 
cc10: 61 6e 64 20 61 0a 2a 2a 20 20 20 73 65 63 6f 6e  and a.**   secon
cc20: 64 20 61 74 74 65 6d 70 74 20 74 6f 20 61 70 70  d attempt to app
cc30: 6c 79 20 74 68 65 20 63 68 61 6e 67 65 20 69 73  ly the change is
cc40: 20 6d 61 64 65 2e 20 49 66 20 74 68 69 73 20 73   made. If this s
cc50: 65 63 6f 6e 64 20 61 74 74 65 6d 70 74 20 66 61  econd attempt fa
cc60: 69 6c 73 2c 0a 2a 2a 20 20 20 74 68 65 20 6f 72  ils,.**   the or
cc70: 69 67 69 6e 61 6c 20 72 6f 77 20 69 73 20 72 65  iginal row is re
cc80: 73 74 6f 72 65 64 20 74 6f 20 74 68 65 20 64 61  stored to the da
cc90: 74 61 62 61 73 65 20 62 65 66 6f 72 65 20 63 6f  tabase before co
cca0: 6e 74 69 6e 75 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20  ntinuing..**.** 
ccb0: 3c 64 74 3e 53 51 4c 49 54 45 5f 43 48 41 4e 47  <dt>SQLITE_CHANG
ccc0: 45 53 45 54 5f 41 42 4f 52 54 3c 64 64 3e 0a 2a  ESET_ABORT<dd>.*
ccd0: 2a 20 20 20 49 66 20 74 68 69 73 20 76 61 6c 75  *   If this valu
cce0: 65 20 69 73 20 72 65 74 75 72 6e 65 64 2c 20 61  e is returned, a
ccf0: 6e 79 20 63 68 61 6e 67 65 73 20 61 70 70 6c 69  ny changes appli
cd00: 65 64 20 73 6f 20 66 61 72 20 61 72 65 20 72 6f  ed so far are ro
cd10: 6c 6c 65 64 20 62 61 63 6b 20 0a 2a 2a 20 20 20  lled back .**   
cd20: 61 6e 64 20 74 68 65 20 63 61 6c 6c 20 74 6f 20  and the call to 
cd30: 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74  sqlite3changeset
cd40: 5f 61 70 70 6c 79 28 29 20 72 65 74 75 72 6e 73  _apply() returns
cd50: 20 53 51 4c 49 54 45 5f 41 42 4f 52 54 2e 0a 2a   SQLITE_ABORT..*
cd60: 2a 20 3c 2f 64 6c 3e 0a 2a 2f 0a 23 64 65 66 69  * </dl>.*/.#defi
cd70: 6e 65 20 53 51 4c 49 54 45 5f 43 48 41 4e 47 45  ne SQLITE_CHANGE
cd80: 53 45 54 5f 4f 4d 49 54 20 20 20 20 20 20 20 30  SET_OMIT       0
cd90: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f  .#define SQLITE_
cda0: 43 48 41 4e 47 45 53 45 54 5f 52 45 50 4c 41 43  CHANGESET_REPLAC
cdb0: 45 20 20 20 20 31 0a 23 64 65 66 69 6e 65 20 53  E    1.#define S
cdc0: 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f  QLITE_CHANGESET_
cdd0: 41 42 4f 52 54 20 20 20 20 20 20 32 0a 0a 2f 2a  ABORT      2../*
cde0: 0a 2a 2a 20 43 41 50 49 33 52 45 46 3a 20 53 74  .** CAPI3REF: St
cdf0: 72 65 61 6d 69 6e 67 20 56 65 72 73 69 6f 6e 73  reaming Versions
ce00: 20 6f 66 20 41 50 49 20 66 75 6e 63 74 69 6f 6e   of API function
ce10: 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 69 78  s..**.** The six
ce20: 20 73 74 72 65 61 6d 69 6e 67 20 41 50 49 20 78   streaming API x
ce30: 78 78 5f 73 74 72 6d 28 29 20 66 75 6e 63 74 69  xx_strm() functi
ce40: 6f 6e 73 20 73 65 72 76 65 20 73 69 6d 69 6c 61  ons serve simila
ce50: 72 20 70 75 72 70 6f 73 65 73 20 74 6f 20 74 68  r purposes to th
ce60: 65 20 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64  e .** correspond
ce70: 69 6e 67 20 6e 6f 6e 2d 73 74 72 65 61 6d 69 6e  ing non-streamin
ce80: 67 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 3a  g API functions:
ce90: 0a 2a 2a 0a 2a 2a 20 3c 74 61 62 6c 65 20 62 6f  .**.** <table bo
cea0: 72 64 65 72 3d 31 20 73 74 79 6c 65 3d 22 6d 61  rder=1 style="ma
ceb0: 72 67 69 6e 2d 6c 65 66 74 3a 38 65 78 3b 6d 61  rgin-left:8ex;ma
cec0: 72 67 69 6e 2d 72 69 67 68 74 3a 38 65 78 22 3e  rgin-right:8ex">
ced0: 0a 2a 2a 20 20 20 3c 74 72 3e 3c 74 68 3e 53 74  .**   <tr><th>St
cee0: 72 65 61 6d 69 6e 67 20 66 75 6e 63 74 69 6f 6e  reaming function
cef0: 3c 74 68 3e 4e 6f 6e 2d 73 74 72 65 61 6d 69 6e  <th>Non-streamin
cf00: 67 20 65 71 75 69 76 61 6c 65 6e 74 3c 2f 74 68  g equivalent</th
cf10: 3e 0a 2a 2a 20 20 20 3c 74 72 3e 3c 74 64 3e 73  >.**   <tr><td>s
cf20: 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f  qlite3changeset_
cf30: 61 70 70 6c 79 5f 73 74 72 3c 74 64 3e 5b 73 71  apply_str<td>[sq
cf40: 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f 61  lite3changeset_a
cf50: 70 70 6c 79 5d 20 0a 2a 2a 20 20 20 3c 74 72 3e  pply] .**   <tr>
cf60: 3c 74 64 3e 73 71 6c 69 74 65 33 63 68 61 6e 67  <td>sqlite3chang
cf70: 65 73 65 74 5f 63 6f 6e 63 61 74 5f 73 74 72 3c  eset_concat_str<
cf80: 74 64 3e 5b 73 71 6c 69 74 65 33 63 68 61 6e 67  td>[sqlite3chang
cf90: 65 73 65 74 5f 63 6f 6e 63 61 74 5d 20 0a 2a 2a  eset_concat] .**
cfa0: 20 20 20 3c 74 72 3e 3c 74 64 3e 73 71 6c 69 74     <tr><td>sqlit
cfb0: 65 33 63 68 61 6e 67 65 73 65 74 5f 69 6e 76 65  e3changeset_inve
cfc0: 72 74 5f 73 74 72 3c 74 64 3e 5b 73 71 6c 69 74  rt_str<td>[sqlit
cfd0: 65 33 63 68 61 6e 67 65 73 65 74 5f 69 6e 76 65  e3changeset_inve
cfe0: 72 74 5d 20 0a 2a 2a 20 20 20 3c 74 72 3e 3c 74  rt] .**   <tr><t
cff0: 64 3e 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73  d>sqlite3changes
d000: 65 74 5f 73 74 61 72 74 5f 73 74 72 3c 74 64 3e  et_start_str<td>
d010: 5b 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65  [sqlite3changese
d020: 74 5f 73 74 61 72 74 5d 20 0a 2a 2a 20 20 20 3c  t_start] .**   <
d030: 74 72 3e 3c 74 64 3e 73 71 6c 69 74 65 33 73 65  tr><td>sqlite3se
d040: 73 73 69 6f 6e 5f 63 68 61 6e 67 65 73 65 74 5f  ssion_changeset_
d050: 73 74 72 3c 74 64 3e 5b 73 71 6c 69 74 65 33 73  str<td>[sqlite3s
d060: 65 73 73 69 6f 6e 5f 63 68 61 6e 67 65 73 65 74  ession_changeset
d070: 5d 20 0a 2a 2a 20 20 20 3c 74 72 3e 3c 74 64 3e  ] .**   <tr><td>
d080: 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 70  sqlite3session_p
d090: 61 74 63 68 73 65 74 5f 73 74 72 3c 74 64 3e 5b  atchset_str<td>[
d0a0: 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 70  sqlite3session_p
d0b0: 61 74 63 68 73 65 74 5d 20 0a 2a 2a 20 3c 2f 74  atchset] .** </t
d0c0: 61 62 6c 65 3e 0a 2a 2a 0a 2a 2a 20 4e 6f 6e 2d  able>.**.** Non-
d0d0: 73 74 72 65 61 6d 69 6e 67 20 66 75 6e 63 74 69  streaming functi
d0e0: 6f 6e 73 20 74 68 61 74 20 61 63 63 65 70 74 20  ons that accept 
d0f0: 63 68 61 6e 67 65 73 65 74 73 20 28 6f 72 20 70  changesets (or p
d100: 61 74 63 68 73 65 74 73 29 20 61 73 20 69 6e 70  atchsets) as inp
d110: 75 74 0a 2a 2a 20 72 65 71 75 69 72 65 20 74 68  ut.** require th
d120: 61 74 20 74 68 65 20 65 6e 74 69 72 65 20 63 68  at the entire ch
d130: 61 6e 67 65 73 65 74 20 62 65 20 73 74 6f 72 65  angeset be store
d140: 64 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 62 75  d in a single bu
d150: 66 66 65 72 20 69 6e 20 6d 65 6d 6f 72 79 2e 20  ffer in memory. 
d160: 0a 2a 2a 20 53 69 6d 69 6c 61 72 6c 79 2c 20 74  .** Similarly, t
d170: 68 6f 73 65 20 74 68 61 74 20 72 65 74 75 72 6e  hose that return
d180: 20 61 20 63 68 61 6e 67 65 73 65 74 20 6f 72 20   a changeset or 
d190: 70 61 74 63 68 73 65 74 20 64 6f 20 73 6f 20 62  patchset do so b
d1a0: 79 20 72 65 74 75 72 6e 69 6e 67 20 0a 2a 2a 20  y returning .** 
d1b0: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 73  a pointer to a s
d1c0: 69 6e 67 6c 65 20 6c 61 72 67 65 20 62 75 66 66  ingle large buff
d1d0: 65 72 20 61 6c 6c 6f 63 61 74 65 64 20 75 73 69  er allocated usi
d1e0: 6e 67 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f  ng sqlite3_mallo
d1f0: 63 28 29 2e 20 0a 2a 2a 20 4e 6f 72 6d 61 6c 6c  c(). .** Normall
d200: 79 20 74 68 69 73 20 69 73 20 63 6f 6e 76 65 6e  y this is conven
d210: 69 65 6e 74 2e 20 48 6f 77 65 76 65 72 2c 20 69  ient. However, i
d220: 66 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e  f an application
d230: 20 72 75 6e 6e 69 6e 67 20 69 6e 20 61 20 0a 2a   running in a .*
d240: 2a 20 6c 6f 77 2d 6d 65 6d 6f 72 79 20 65 6e 76  * low-memory env
d250: 69 72 6f 6e 6d 65 6e 74 20 69 73 20 72 65 71 75  ironment is requ
d260: 69 72 65 64 20 74 6f 20 68 61 6e 64 6c 65 20 76  ired to handle v
d270: 65 72 79 20 6c 61 72 67 65 20 63 68 61 6e 67 65  ery large change
d280: 73 65 74 73 2c 20 74 68 65 0a 2a 2a 20 6c 61 72  sets, the.** lar
d290: 67 65 20 63 6f 6e 74 69 67 75 6f 75 73 20 6d 65  ge contiguous me
d2a0: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73  mory allocations
d2b0: 20 72 65 71 75 69 72 65 64 20 63 61 6e 20 62 65   required can be
d2c0: 63 6f 6d 65 20 6f 6e 65 72 6f 75 73 2e 0a 2a 2a  come onerous..**
d2d0: 0a 2a 2a 20 49 6e 20 6f 72 64 65 72 20 74 6f 20  .** In order to 
d2e0: 61 76 6f 69 64 20 74 68 69 73 20 70 72 6f 62 6c  avoid this probl
d2f0: 65 6d 2c 20 69 6e 73 74 65 61 64 20 6f 66 20 61  em, instead of a
d300: 20 73 69 6e 67 6c 65 20 6c 61 72 67 65 20 62 75   single large bu
d310: 66 66 65 72 2c 20 69 6e 70 75 74 0a 2a 2a 20 69  ffer, input.** i
d320: 73 20 70 61 73 73 65 64 20 74 6f 20 61 20 73 74  s passed to a st
d330: 72 65 61 6d 69 6e 67 20 41 50 49 20 66 75 6e 63  reaming API func
d340: 74 69 6f 6e 73 20 62 79 20 77 61 79 20 6f 66 20  tions by way of 
d350: 61 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74  a callback funct
d360: 69 6f 6e 20 74 68 61 74 0a 2a 2a 20 74 68 65 20  ion that.** the 
d370: 73 65 73 73 69 6f 6e 73 20 6d 6f 64 75 6c 65 20  sessions module 
d380: 69 6e 76 6f 6b 65 73 20 74 6f 20 69 6e 63 72 65  invokes to incre
d390: 6d 65 6e 74 61 6c 6c 79 20 72 65 71 75 65 73 74  mentally request
d3a0: 20 69 6e 70 75 74 20 64 61 74 61 20 61 73 20 69   input data as i
d3b0: 74 20 69 73 0a 2a 2a 20 72 65 71 75 69 72 65 64  t is.** required
d3c0: 2e 20 49 6e 20 61 6c 6c 20 63 61 73 65 73 2c 20  . In all cases, 
d3d0: 61 20 70 61 69 72 20 6f 66 20 41 50 49 20 66 75  a pair of API fu
d3e0: 6e 63 74 69 6f 6e 20 70 61 72 61 6d 65 74 65 72  nction parameter
d3f0: 73 20 73 75 63 68 20 61 73 0a 2a 2a 0a 2a 2a 20  s such as.**.** 
d400: 20 3c 70 72 65 3e 0a 2a 2a 20 20 26 6e 62 73 70   <pre>.**  &nbsp
d410: 3b 20 20 20 20 20 69 6e 74 20 6e 43 68 61 6e 67  ;     int nChang
d420: 65 73 65 74 2c 0a 2a 2a 20 20 26 6e 62 73 70 3b  eset,.**  &nbsp;
d430: 20 20 20 20 20 76 6f 69 64 20 2a 70 43 68 61 6e       void *pChan
d440: 67 65 73 65 74 2c 0a 2a 2a 20 20 3c 2f 70 72 65  geset,.**  </pre
d450: 3e 0a 2a 2a 0a 2a 2a 20 49 73 20 72 65 70 6c 61  >.**.** Is repla
d460: 63 65 64 20 62 79 3a 0a 2a 2a 0a 2a 2a 20 20 3c  ced by:.**.**  <
d470: 70 72 65 3e 0a 2a 2a 20 20 26 6e 62 73 70 3b 20  pre>.**  &nbsp; 
d480: 20 20 20 20 69 6e 74 20 28 2a 78 49 6e 70 75 74      int (*xInput
d490: 29 28 76 6f 69 64 20 2a 70 49 6e 2c 20 76 6f 69  )(void *pIn, voi
d4a0: 64 20 2a 70 44 61 74 61 2c 20 69 6e 74 20 2a 70  d *pData, int *p
d4b0: 6e 44 61 74 61 29 2c 0a 2a 2a 20 20 26 6e 62 73  nData),.**  &nbs
d4c0: 70 3b 20 20 20 20 20 76 6f 69 64 20 2a 70 49 6e  p;     void *pIn
d4d0: 2c 0a 2a 2a 20 20 3c 2f 70 72 65 3e 0a 2a 2a 0a  ,.**  </pre>.**.
d4e0: 2a 2a 20 45 61 63 68 20 74 69 6d 65 20 74 68 65  ** Each time the
d4f0: 20 78 49 6e 70 75 74 20 63 61 6c 6c 62 61 63 6b   xInput callback
d500: 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 79 20 74   is invoked by t
d510: 68 65 20 73 65 73 73 69 6f 6e 73 20 6d 6f 64 75  he sessions modu
d520: 6c 65 2c 20 74 68 65 20 66 69 72 73 74 0a 2a 2a  le, the first.**
d530: 20 61 72 67 75 6d 65 6e 74 20 70 61 73 73 65 64   argument passed
d540: 20 69 73 20 61 20 63 6f 70 79 20 6f 66 20 74 68   is a copy of th
d550: 65 20 73 75 70 70 6c 69 65 64 20 70 49 6e 20 63  e supplied pIn c
d560: 6f 6e 74 65 78 74 20 70 6f 69 6e 74 65 72 2e 20  ontext pointer. 
d570: 54 68 65 20 73 65 63 6f 6e 64 20 0a 2a 2a 20 61  The second .** a
d580: 72 67 75 6d 65 6e 74 2c 20 70 44 61 74 61 2c 20  rgument, pData, 
d590: 70 6f 69 6e 74 73 20 74 6f 20 61 20 62 75 66 66  points to a buff
d5a0: 65 72 20 28 2a 70 6e 44 61 74 61 29 20 62 79 74  er (*pnData) byt
d5b0: 65 73 20 69 6e 20 73 69 7a 65 2e 20 41 73 73 75  es in size. Assu
d5c0: 6d 69 6e 67 20 6e 6f 20 0a 2a 2a 20 65 72 72 6f  ming no .** erro
d5d0: 72 20 6f 63 63 75 72 73 20 74 68 65 20 78 49 6e  r occurs the xIn
d5e0: 70 75 74 20 6d 65 74 68 6f 64 20 73 68 6f 75 6c  put method shoul
d5f0: 64 20 63 6f 70 79 20 75 70 20 74 6f 20 28 2a 70  d copy up to (*p
d600: 6e 44 61 74 61 29 20 62 79 74 65 73 20 6f 66 20  nData) bytes of 
d610: 64 61 74 61 20 0a 2a 2a 20 69 6e 74 6f 20 74 68  data .** into th
d620: 65 20 62 75 66 66 65 72 20 61 6e 64 20 73 65 74  e buffer and set
d630: 20 28 2a 70 6e 44 61 74 61 29 20 74 6f 20 74 68   (*pnData) to th
d640: 65 20 61 63 74 75 61 6c 20 6e 75 6d 62 65 72 20  e actual number 
d650: 6f 66 20 62 79 74 65 73 20 63 6f 70 69 65 64 20  of bytes copied 
d660: 0a 2a 2a 20 62 65 66 6f 72 65 20 72 65 74 75 72  .** before retur
d670: 6e 69 6e 67 20 53 51 4c 49 54 45 5f 4f 4b 2e 20  ning SQLITE_OK. 
d680: 49 66 20 74 68 65 20 69 6e 70 75 74 20 69 73 20  If the input is 
d690: 63 6f 6d 70 6c 65 74 65 6c 79 20 65 78 68 61 75  completely exhau
d6a0: 73 74 65 64 2c 20 28 2a 70 6e 44 61 74 61 29 20  sted, (*pnData) 
d6b0: 0a 2a 2a 20 73 68 6f 75 6c 64 20 62 65 20 73 65  .** should be se
d6c0: 74 20 74 6f 20 7a 65 72 6f 20 74 6f 20 69 6e 64  t to zero to ind
d6d0: 69 63 61 74 65 20 74 68 69 73 2e 20 4f 72 2c 20  icate this. Or, 
d6e0: 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75  if an error occu
d6f0: 72 73 2c 20 61 6e 20 53 51 4c 69 74 65 20 0a 2a  rs, an SQLite .*
d700: 2a 20 65 72 72 6f 72 20 63 6f 64 65 20 73 68 6f  * error code sho
d710: 75 6c 64 20 62 65 20 72 65 74 75 72 6e 65 64 2e  uld be returned.
d720: 20 49 6e 20 61 6c 6c 20 63 61 73 65 73 2c 20 69   In all cases, i
d730: 66 20 61 6e 20 78 49 6e 70 75 74 20 63 61 6c 6c  f an xInput call
d740: 62 61 63 6b 20 72 65 74 75 72 6e 73 0a 2a 2a 20  back returns.** 
d750: 61 6e 20 65 72 72 6f 72 2c 20 61 6c 6c 20 70 72  an error, all pr
d760: 6f 63 65 73 73 69 6e 67 20 69 73 20 61 62 61 6e  ocessing is aban
d770: 64 6f 6e 65 64 20 61 6e 64 20 74 68 65 20 73 74  doned and the st
d780: 72 65 61 6d 69 6e 67 20 41 50 49 20 66 75 6e 63  reaming API func
d790: 74 69 6f 6e 0a 2a 2a 20 72 65 74 75 72 6e 73 20  tion.** returns 
d7a0: 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 65 72  a copy of the er
d7b0: 72 6f 72 20 63 6f 64 65 20 74 6f 20 74 68 65 20  ror code to the 
d7c0: 63 61 6c 6c 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 6e  caller..**.** In
d7d0: 20 74 68 65 20 63 61 73 65 20 6f 66 20 73 71 6c   the case of sql
d7e0: 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f 73 74  ite3changeset_st
d7f0: 61 72 74 5f 73 74 72 6d 28 29 2c 20 74 68 65 20  art_strm(), the 
d800: 78 49 6e 70 75 74 20 63 61 6c 6c 62 61 63 6b 20  xInput callback 
d810: 6d 61 79 20 62 65 0a 2a 2a 20 69 6e 76 6f 6b 65  may be.** invoke
d820: 64 20 62 79 20 74 68 65 20 73 65 73 73 69 6f 6e  d by the session
d830: 73 20 6d 6f 64 75 6c 65 20 61 74 20 61 6e 79 20  s module at any 
d840: 70 6f 69 6e 74 20 64 75 72 69 6e 67 20 74 68 65  point during the
d850: 20 6c 69 66 65 74 69 6d 65 20 6f 66 20 74 68 65   lifetime of the
d860: 0a 2a 2a 20 69 74 65 72 61 74 6f 72 2e 20 49 66  .** iterator. If
d870: 20 73 75 63 68 20 61 6e 20 78 49 6e 70 75 74 20   such an xInput 
d880: 63 61 6c 6c 62 61 63 6b 20 72 65 74 75 72 6e 73  callback returns
d890: 20 61 6e 20 65 72 72 6f 72 2c 20 74 68 65 20 69   an error, the i
d8a0: 74 65 72 61 74 6f 72 20 65 6e 74 65 72 73 0a 2a  terator enters.*
d8b0: 2a 20 61 6e 20 65 72 72 6f 72 20 73 74 61 74 65  * an error state
d8c0: 2c 20 77 68 65 72 65 62 79 20 61 6c 6c 20 73 75  , whereby all su
d8d0: 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 74  bsequent calls t
d8e0: 6f 20 69 74 65 72 61 74 6f 72 20 66 75 6e 63 74  o iterator funct
d8f0: 69 6f 6e 73 20 0a 2a 2a 20 69 6d 6d 65 64 69 61  ions .** immedia
d900: 74 65 6c 79 20 66 61 69 6c 20 77 69 74 68 20 74  tely fail with t
d910: 68 65 20 73 61 6d 65 20 65 72 72 6f 72 20 63 6f  he same error co
d920: 64 65 20 61 73 20 72 65 74 75 72 6e 65 64 20 62  de as returned b
d930: 79 20 78 49 6e 70 75 74 2e 0a 2a 2a 0a 2a 2a 20  y xInput..**.** 
d940: 53 69 6d 69 6c 61 72 6c 79 2c 20 73 74 72 65 61  Similarly, strea
d950: 6d 69 6e 67 20 41 50 49 20 66 75 6e 63 74 69 6f  ming API functio
d960: 6e 73 20 74 68 61 74 20 72 65 74 75 72 6e 20 63  ns that return c
d970: 68 61 6e 67 65 73 65 74 73 20 28 6f 72 20 70 61  hangesets (or pa
d980: 74 63 68 73 65 74 73 29 0a 2a 2a 20 72 65 74 75  tchsets).** retu
d990: 72 6e 20 74 68 65 6d 20 69 6e 20 63 68 75 6e 6b  rn them in chunk
d9a0: 73 20 62 79 20 77 61 79 20 6f 66 20 61 20 63 61  s by way of a ca
d9b0: 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20  llback function 
d9c0: 69 6e 73 74 65 61 64 20 6f 66 20 76 69 61 20 61  instead of via a
d9d0: 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 74 6f 20 61  .** pointer to a
d9e0: 20 73 69 6e 67 6c 65 20 6c 61 72 67 65 20 62 75   single large bu
d9f0: 66 66 65 72 2e 20 49 6e 20 74 68 69 73 20 63 61  ffer. In this ca
da00: 73 65 2c 20 61 20 70 61 69 72 20 6f 66 20 70 61  se, a pair of pa
da10: 72 61 6d 65 74 65 72 73 20 73 75 63 68 0a 2a 2a  rameters such.**
da20: 20 61 73 3a 0a 2a 2a 0a 2a 2a 20 20 3c 70 72 65   as:.**.**  <pre
da30: 3e 0a 2a 2a 20 20 26 6e 62 73 70 3b 20 20 20 20  >.**  &nbsp;    
da40: 20 69 6e 74 20 2a 70 6e 43 68 61 6e 67 65 73 65   int *pnChangese
da50: 74 2c 0a 2a 2a 20 20 26 6e 62 73 70 3b 20 20 20  t,.**  &nbsp;   
da60: 20 20 76 6f 69 64 20 2a 2a 70 70 43 68 61 6e 67    void **ppChang
da70: 65 73 65 74 2c 0a 2a 2a 20 20 3c 2f 70 72 65 3e  eset,.**  </pre>
da80: 0a 2a 2a 0a 2a 2a 20 49 73 20 72 65 70 6c 61 63  .**.** Is replac
da90: 65 64 20 62 79 3a 0a 2a 2a 0a 2a 2a 20 20 3c 70  ed by:.**.**  <p
daa0: 72 65 3e 0a 2a 2a 20 20 26 6e 62 73 70 3b 20 20  re>.**  &nbsp;  
dab0: 20 20 20 69 6e 74 20 28 2a 78 4f 75 74 70 75 74     int (*xOutput
dac0: 29 28 76 6f 69 64 20 2a 70 4f 75 74 2c 20 63 6f  )(void *pOut, co
dad0: 6e 73 74 20 76 6f 69 64 20 2a 70 44 61 74 61 2c  nst void *pData,
dae0: 20 69 6e 74 20 6e 44 61 74 61 29 2c 0a 2a 2a 20   int nData),.** 
daf0: 20 26 6e 62 73 70 3b 20 20 20 20 20 76 6f 69 64   &nbsp;     void
db00: 20 2a 70 4f 75 74 0a 2a 2a 20 20 3c 2f 70 72 65   *pOut.**  </pre
db10: 3e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 78 4f 75 74  >.**.** The xOut
db20: 70 75 74 20 63 61 6c 6c 62 61 63 6b 20 69 73 20  put callback is 
db30: 69 6e 76 6f 6b 65 64 20 7a 65 72 6f 20 6f 72 20  invoked zero or 
db40: 6d 6f 72 65 20 74 69 6d 65 73 20 74 6f 20 72 65  more times to re
db50: 74 75 72 6e 20 64 61 74 61 20 74 6f 0a 2a 2a 20  turn data to.** 
db60: 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 2e  the application.
db70: 20 54 68 65 20 66 69 72 73 74 20 70 61 72 61 6d   The first param
db80: 65 74 65 72 20 70 61 73 73 65 64 20 74 6f 20 65  eter passed to e
db90: 61 63 68 20 63 61 6c 6c 20 69 73 20 61 20 63 6f  ach call is a co
dba0: 70 79 20 6f 66 20 74 68 65 0a 2a 2a 20 70 4f 75  py of the.** pOu
dbb0: 74 20 70 6f 69 6e 74 65 72 20 73 75 70 70 6c 69  t pointer suppli
dbc0: 65 64 20 62 79 20 74 68 65 20 61 70 70 6c 69 63  ed by the applic
dbd0: 61 74 69 6f 6e 2e 20 54 68 65 20 73 65 63 6f 6e  ation. The secon
dbe0: 64 20 70 61 72 61 6d 65 74 65 72 2c 20 70 44 61  d parameter, pDa
dbf0: 74 61 2c 0a 2a 2a 20 70 6f 69 6e 74 73 20 74 6f  ta,.** points to
dc00: 20 61 20 62 75 66 66 65 72 20 6e 44 61 74 61 20   a buffer nData 
dc10: 62 79 74 65 73 20 69 6e 20 73 69 7a 65 20 63 6f  bytes in size co
dc20: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 68 75  ntaining the chu
dc30: 6e 6b 20 6f 66 20 6f 75 74 70 75 74 0a 2a 2a 20  nk of output.** 
dc40: 64 61 74 61 20 62 65 69 6e 67 20 72 65 74 75 72  data being retur
dc50: 6e 65 64 2e 20 49 66 20 74 68 65 20 78 4f 75 74  ned. If the xOut
dc60: 70 75 74 20 63 61 6c 6c 62 61 63 6b 20 73 75 63  put callback suc
dc70: 63 65 73 73 66 75 6c 6c 79 20 70 72 6f 63 65 73  cessfully proces
dc80: 73 65 73 20 74 68 65 0a 2a 2a 20 73 75 70 70 6c  ses the.** suppl
dc90: 69 65 64 20 64 61 74 61 2c 20 69 74 20 73 68 6f  ied data, it sho
dca0: 75 6c 64 20 72 65 74 75 72 6e 20 53 51 4c 49 54  uld return SQLIT
dcb0: 45 5f 4f 4b 20 74 6f 20 69 6e 64 69 63 61 74 65  E_OK to indicate
dcc0: 20 73 75 63 63 65 73 73 2e 20 4f 74 68 65 72 77   success. Otherw
dcd0: 69 73 65 2c 0a 2a 2a 20 69 74 20 73 68 6f 75 6c  ise,.** it shoul
dce0: 64 20 72 65 74 75 72 6e 20 73 6f 6d 65 20 6f 74  d return some ot
dcf0: 68 65 72 20 53 51 4c 69 74 65 20 65 72 72 6f 72  her SQLite error
dd00: 20 63 6f 64 65 2e 20 49 6e 20 74 68 69 73 20 63   code. In this c
dd10: 61 73 65 20 70 72 6f 63 65 73 73 69 6e 67 0a 2a  ase processing.*
dd20: 2a 20 69 73 20 69 6d 6d 65 64 69 61 74 65 6c 79  * is immediately
dd30: 20 61 62 61 6e 64 6f 6e 65 64 20 61 6e 64 20 74   abandoned and t
dd40: 68 65 20 73 74 72 65 61 6d 69 6e 67 20 41 50 49  he streaming API
dd50: 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e   function return
dd60: 73 20 61 20 63 6f 70 79 0a 2a 2a 20 6f 66 20 74  s a copy.** of t
dd70: 68 65 20 78 4f 75 74 70 75 74 20 65 72 72 6f 72  he xOutput error
dd80: 20 63 6f 64 65 20 74 6f 20 74 68 65 20 61 70 70   code to the app
dd90: 6c 69 63 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20  lication..**.** 
dda0: 54 68 65 20 73 65 73 73 69 6f 6e 73 20 6d 6f 64  The sessions mod
ddb0: 75 6c 65 20 6e 65 76 65 72 20 69 6e 76 6f 6b 65  ule never invoke
ddc0: 73 20 61 6e 20 78 4f 75 74 70 75 74 20 63 61 6c  s an xOutput cal
ddd0: 6c 62 61 63 6b 20 77 69 74 68 20 74 68 65 20 74  lback with the t
dde0: 68 69 72 64 20 0a 2a 2a 20 70 61 72 61 6d 65 74  hird .** paramet
ddf0: 65 72 20 73 65 74 20 74 6f 20 61 20 76 61 6c 75  er set to a valu
de00: 65 20 6c 65 73 73 20 74 68 61 6e 20 6f 72 20 65  e less than or e
de10: 71 75 61 6c 20 74 6f 20 7a 65 72 6f 2e 20 4f 74  qual to zero. Ot
de20: 68 65 72 20 74 68 61 6e 20 74 68 69 73 2c 0a 2a  her than this,.*
de30: 2a 20 6e 6f 20 67 75 61 72 61 6e 74 65 65 73 20  * no guarantees 
de40: 61 72 65 20 6d 61 64 65 20 61 73 20 74 6f 20 74  are made as to t
de50: 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 63  he size of the c
de60: 68 75 6e 6b 73 20 6f 66 20 64 61 74 61 20 72 65  hunks of data re
de70: 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73  turned..*/.int s
de80: 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f  qlite3changeset_
de90: 61 70 70 6c 79 5f 73 74 72 6d 28 0a 20 20 73 71  apply_strm(.  sq
dea0: 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20  lite3 *db,      
deb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
dec0: 20 41 70 70 6c 79 20 63 68 61 6e 67 65 20 74 6f   Apply change to
ded0: 20 22 6d 61 69 6e 22 20 64 62 20 6f 66 20 74 68   "main" db of th
dee0: 69 73 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 69  is handle */.  i
def0: 6e 74 20 28 2a 78 49 6e 70 75 74 29 28 76 6f 69  nt (*xInput)(voi
df00: 64 20 2a 70 49 6e 2c 20 76 6f 69 64 20 2a 70 44  d *pIn, void *pD
df10: 61 74 61 2c 20 69 6e 74 20 2a 70 6e 44 61 74 61  ata, int *pnData
df20: 29 2c 20 2f 2a 20 49 6e 70 75 74 20 66 75 6e 63  ), /* Input func
df30: 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a  tion */.  void *
df40: 70 49 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20  pIn,            
df50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
df60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
df70: 20 46 69 72 73 74 20 61 72 67 20 66 6f 72 20 78   First arg for x
df80: 49 6e 70 75 74 20 2a 2f 0a 20 20 69 6e 74 28 2a  Input */.  int(*
df90: 78 46 69 6c 74 65 72 29 28 0a 20 20 20 20 76 6f  xFilter)(.    vo
dfa0: 69 64 20 2a 70 43 74 78 2c 20 20 20 20 20 20 20  id *pCtx,       
dfb0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43              /* C
dfc0: 6f 70 79 20 6f 66 20 73 69 78 74 68 20 61 72 67  opy of sixth arg
dfd0: 20 74 6f 20 5f 61 70 70 6c 79 28 29 20 2a 2f 0a   to _apply() */.
dfe0: 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a      const char *
dff0: 7a 54 61 62 20 20 20 20 20 20 20 20 20 20 20 20  zTab            
e000: 20 20 2f 2a 20 54 61 62 6c 65 20 6e 61 6d 65 20    /* Table name 
e010: 2a 2f 0a 20 20 29 2c 0a 20 20 69 6e 74 28 2a 78  */.  ),.  int(*x
e020: 43 6f 6e 66 6c 69 63 74 29 28 0a 20 20 20 20 76  Conflict)(.    v
e030: 6f 69 64 20 2a 70 43 74 78 2c 20 20 20 20 20 20  oid *pCtx,      
e040: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
e050: 43 6f 70 79 20 6f 66 20 73 69 78 74 68 20 61 72  Copy of sixth ar
e060: 67 20 74 6f 20 5f 61 70 70 6c 79 28 29 20 2a 2f  g to _apply() */
e070: 0a 20 20 20 20 69 6e 74 20 65 43 6f 6e 66 6c 69  .    int eConfli
e080: 63 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  ct,             
e090: 20 20 20 2f 2a 20 44 41 54 41 2c 20 4d 49 53 53     /* DATA, MISS
e0a0: 49 4e 47 2c 20 43 4f 4e 46 4c 49 43 54 2c 20 43  ING, CONFLICT, C
e0b0: 4f 4e 53 54 52 41 49 4e 54 20 2a 2f 0a 20 20 20  ONSTRAINT */.   
e0c0: 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73   sqlite3_changes
e0d0: 65 74 5f 69 74 65 72 20 2a 70 20 20 20 20 20 2f  et_iter *p     /
e0e0: 2a 20 48 61 6e 64 6c 65 20 64 65 73 63 72 69 62  * Handle describ
e0f0: 69 6e 67 20 63 68 61 6e 67 65 20 61 6e 64 20 63  ing change and c
e100: 6f 6e 66 6c 69 63 74 20 2a 2f 0a 20 20 29 2c 0a  onflict */.  ),.
e110: 20 20 76 6f 69 64 20 2a 70 43 74 78 20 20 20 20    void *pCtx    
e120: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
e130: 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 75 6d    /* First argum
e140: 65 6e 74 20 70 61 73 73 65 64 20 74 6f 20 78 43  ent passed to xC
e150: 6f 6e 66 6c 69 63 74 20 2a 2f 0a 29 3b 0a 69 6e  onflict */.);.in
e160: 74 20 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73  t sqlite3changes
e170: 65 74 5f 63 6f 6e 63 61 74 5f 73 74 72 6d 28 0a  et_concat_strm(.
e180: 20 20 69 6e 74 20 28 2a 78 49 6e 70 75 74 41 29    int (*xInputA)
e190: 28 76 6f 69 64 20 2a 70 49 6e 2c 20 76 6f 69 64  (void *pIn, void
e1a0: 20 2a 70 44 61 74 61 2c 20 69 6e 74 20 2a 70 6e   *pData, int *pn
e1b0: 44 61 74 61 29 2c 0a 20 20 76 6f 69 64 20 2a 70  Data),.  void *p
e1c0: 49 6e 41 2c 0a 20 20 69 6e 74 20 28 2a 78 49 6e  InA,.  int (*xIn
e1d0: 70 75 74 42 29 28 76 6f 69 64 20 2a 70 49 6e 2c  putB)(void *pIn,
e1e0: 20 76 6f 69 64 20 2a 70 44 61 74 61 2c 20 69 6e   void *pData, in
e1f0: 74 20 2a 70 6e 44 61 74 61 29 2c 0a 20 20 76 6f  t *pnData),.  vo
e200: 69 64 20 2a 70 49 6e 42 2c 0a 20 20 69 6e 74 20  id *pInB,.  int 
e210: 28 2a 78 4f 75 74 70 75 74 29 28 76 6f 69 64 20  (*xOutput)(void 
e220: 2a 70 4f 75 74 2c 20 63 6f 6e 73 74 20 76 6f 69  *pOut, const voi
e230: 64 20 2a 70 44 61 74 61 2c 20 69 6e 74 20 6e 44  d *pData, int nD
e240: 61 74 61 29 2c 0a 20 20 76 6f 69 64 20 2a 70 4f  ata),.  void *pO
e250: 75 74 0a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  ut.);.int sqlite
e260: 33 63 68 61 6e 67 65 73 65 74 5f 69 6e 76 65 72  3changeset_inver
e270: 74 5f 73 74 72 6d 28 0a 20 20 69 6e 74 20 28 2a  t_strm(.  int (*
e280: 78 49 6e 70 75 74 29 28 76 6f 69 64 20 2a 70 49  xInput)(void *pI
e290: 6e 2c 20 76 6f 69 64 20 2a 70 44 61 74 61 2c 20  n, void *pData, 
e2a0: 69 6e 74 20 2a 70 6e 44 61 74 61 29 2c 0a 20 20  int *pnData),.  
e2b0: 76 6f 69 64 20 2a 70 49 6e 2c 0a 20 20 69 6e 74  void *pIn,.  int
e2c0: 20 28 2a 78 4f 75 74 70 75 74 29 28 76 6f 69 64   (*xOutput)(void
e2d0: 20 2a 70 4f 75 74 2c 20 63 6f 6e 73 74 20 76 6f   *pOut, const vo
e2e0: 69 64 20 2a 70 44 61 74 61 2c 20 69 6e 74 20 6e  id *pData, int n
e2f0: 44 61 74 61 29 2c 0a 20 20 76 6f 69 64 20 2a 70  Data),.  void *p
e300: 4f 75 74 0a 29 3b 0a 69 6e 74 20 73 71 6c 69 74  Out.);.int sqlit
e310: 65 33 63 68 61 6e 67 65 73 65 74 5f 73 74 61 72  e3changeset_star
e320: 74 5f 73 74 72 6d 28 0a 20 20 73 71 6c 69 74 65  t_strm(.  sqlite
e330: 33 5f 63 68 61 6e 67 65 73 65 74 5f 69 74 65 72  3_changeset_iter
e340: 20 2a 2a 70 70 2c 0a 20 20 69 6e 74 20 28 2a 78   **pp,.  int (*x
e350: 49 6e 70 75 74 29 28 76 6f 69 64 20 2a 70 49 6e  Input)(void *pIn
e360: 2c 20 76 6f 69 64 20 2a 70 44 61 74 61 2c 20 69  , void *pData, i
e370: 6e 74 20 2a 70 6e 44 61 74 61 29 2c 0a 20 20 76  nt *pnData),.  v
e380: 6f 69 64 20 2a 70 49 6e 0a 29 3b 0a 69 6e 74 20  oid *pIn.);.int 
e390: 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 63  sqlite3session_c
e3a0: 68 61 6e 67 65 73 65 74 5f 73 74 72 6d 28 0a 20  hangeset_strm(. 
e3b0: 20 73 71 6c 69 74 65 33 5f 73 65 73 73 69 6f 6e   sqlite3_session
e3c0: 20 2a 70 53 65 73 73 69 6f 6e 2c 0a 20 20 69 6e   *pSession,.  in
e3d0: 74 20 28 2a 78 4f 75 74 70 75 74 29 28 76 6f 69  t (*xOutput)(voi
e3e0: 64 20 2a 70 4f 75 74 2c 20 63 6f 6e 73 74 20 76  d *pOut, const v
e3f0: 6f 69 64 20 2a 70 44 61 74 61 2c 20 69 6e 74 20  oid *pData, int 
e400: 6e 44 61 74 61 29 2c 0a 20 20 76 6f 69 64 20 2a  nData),.  void *
e410: 70 4f 75 74 0a 29 3b 0a 69 6e 74 20 73 71 6c 69  pOut.);.int sqli
e420: 74 65 33 73 65 73 73 69 6f 6e 5f 70 61 74 63 68  te3session_patch
e430: 73 65 74 5f 73 74 72 6d 28 0a 20 20 73 71 6c 69  set_strm(.  sqli
e440: 74 65 33 5f 73 65 73 73 69 6f 6e 20 2a 70 53 65  te3_session *pSe
e450: 73 73 69 6f 6e 2c 0a 20 20 69 6e 74 20 28 2a 78  ssion,.  int (*x
e460: 4f 75 74 70 75 74 29 28 76 6f 69 64 20 2a 70 4f  Output)(void *pO
e470: 75 74 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a  ut, const void *
e480: 70 44 61 74 61 2c 20 69 6e 74 20 6e 44 61 74 61  pData, int nData
e490: 29 2c 0a 20 20 76 6f 69 64 20 2a 70 4f 75 74 0a  ),.  void *pOut.
e4a0: 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 63 68  );.int sqlite3ch
e4b0: 61 6e 67 65 67 72 6f 75 70 5f 61 64 64 5f 73 74  angegroup_add_st
e4c0: 72 6d 28 73 71 6c 69 74 65 33 5f 63 68 61 6e 67  rm(sqlite3_chang
e4d0: 65 67 72 6f 75 70 2a 2c 20 0a 20 20 20 20 69 6e  egroup*, .    in
e4e0: 74 20 28 2a 78 49 6e 70 75 74 29 28 76 6f 69 64  t (*xInput)(void
e4f0: 20 2a 70 49 6e 2c 20 76 6f 69 64 20 2a 70 44 61   *pIn, void *pDa
e500: 74 61 2c 20 69 6e 74 20 2a 70 6e 44 61 74 61 29  ta, int *pnData)
e510: 2c 0a 20 20 20 20 76 6f 69 64 20 2a 70 49 6e 0a  ,.    void *pIn.
e520: 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 63 68  );.int sqlite3ch
e530: 61 6e 67 65 67 72 6f 75 70 5f 6f 75 74 70 75 74  angegroup_output
e540: 5f 73 74 72 6d 28 73 71 6c 69 74 65 33 5f 63 68  _strm(sqlite3_ch
e550: 61 6e 67 65 67 72 6f 75 70 2a 2c 0a 20 20 20 20  angegroup*,.    
e560: 69 6e 74 20 28 2a 78 4f 75 74 70 75 74 29 28 76  int (*xOutput)(v
e570: 6f 69 64 20 2a 70 4f 75 74 2c 20 63 6f 6e 73 74  oid *pOut, const
e580: 20 76 6f 69 64 20 2a 70 44 61 74 61 2c 20 69 6e   void *pData, in
e590: 74 20 6e 44 61 74 61 29 2c 20 0a 20 20 20 20 76  t nData), .    v
e5a0: 6f 69 64 20 2a 70 4f 75 74 0a 29 3b 0a 0a 0a 2f  oid *pOut.);.../
e5b0: 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 77  *.** Make sure w
e5c0: 65 20 63 61 6e 20 63 61 6c 6c 20 74 68 69 73 20  e can call this 
e5d0: 73 74 75 66 66 20 66 72 6f 6d 20 43 2b 2b 2e 0a  stuff from C++..
e5e0: 2a 2f 0a 23 69 66 64 65 66 20 5f 5f 63 70 6c 75  */.#ifdef __cplu
e5f0: 73 70 6c 75 73 0a 7d 0a 23 65 6e 64 69 66 0a 0a  splus.}.#endif..
e600: 23 65 6e 64 69 66 20 20 2f 2a 20 21 64 65 66 69  #endif  /* !defi
e610: 6e 65 64 28 5f 5f 53 51 4c 49 54 45 53 45 53 53  ned(__SQLITESESS
e620: 49 4f 4e 5f 48 5f 29 20 26 26 20 64 65 66 69 6e  ION_H_) && defin
e630: 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  ed(SQLITE_ENABLE
e640: 5f 53 45 53 53 49 4f 4e 29 20 2a 2f 0a           _SESSION) */.