0000: 0a 23 69 66 6e 64 65 66 20 5f 5f 53 51 4c 49 54 .#ifndef __SQLIT
0010: 45 53 45 53 53 49 4f 4e 5f 48 5f 0a 23 64 65 66 ESESSION_H_.#def
0020: 69 6e 65 20 5f 5f 53 51 4c 49 54 45 53 45 53 53 ine __SQLITESESS
0030: 49 4f 4e 5f 48 5f 20 31 0a 0a 2f 2a 0a 2a 2a 20 ION_H_ 1../*.**
0040: 4d 61 6b 65 20 73 75 72 65 20 77 65 20 63 61 6e Make sure we can
0050: 20 63 61 6c 6c 20 74 68 69 73 20 73 74 75 66 66 call this stuff
0060: 20 66 72 6f 6d 20 43 2b 2b 2e 0a 2a 2f 0a 23 69 from C++..*/.#i
0070: 66 64 65 66 20 5f 5f 63 70 6c 75 73 70 6c 75 73 fdef __cplusplus
0080: 0a 65 78 74 65 72 6e 20 22 43 22 20 7b 0a 23 65 .extern "C" {.#e
0090: 6e 64 69 66 0a 0a 23 69 6e 63 6c 75 64 65 20 22 ndif..#include "
00a0: 73 71 6c 69 74 65 33 2e 68 22 0a 0a 74 79 70 65 sqlite3.h"..type
00b0: 64 65 66 20 73 74 72 75 63 74 20 73 71 6c 69 74 def struct sqlit
00c0: 65 33 5f 73 65 73 73 69 6f 6e 20 73 71 6c 69 74 e3_session sqlit
00d0: 65 33 5f 73 65 73 73 69 6f 6e 3b 0a 74 79 70 65 e3_session;.type
00e0: 64 65 66 20 73 74 72 75 63 74 20 73 71 6c 69 74 def struct sqlit
00f0: 65 33 5f 63 68 61 6e 67 65 73 65 74 5f 69 74 65 e3_changeset_ite
0100: 72 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 r sqlite3_change
0110: 73 65 74 5f 69 74 65 72 3b 0a 0a 2f 2a 0a 2a 2a set_iter;../*.**
0120: 20 43 72 65 61 74 65 20 61 20 6e 65 77 20 73 65 Create a new se
0130: 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 61 74 74 ssion object att
0140: 61 63 68 65 64 20 74 6f 20 64 61 74 61 62 61 73 ached to databas
0150: 65 20 68 61 6e 64 6c 65 20 64 62 2e 20 49 66 20 e handle db. If
0160: 73 75 63 63 65 73 73 66 75 6c 2c 0a 2a 2a 20 61 successful,.** a
0170: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 pointer to the
0180: 6e 65 77 20 6f 62 6a 65 63 74 20 69 73 20 77 72 new object is wr
0190: 69 74 74 65 6e 20 74 6f 20 2a 70 70 53 65 73 73 itten to *ppSess
01a0: 69 6f 6e 20 61 6e 64 20 53 51 4c 49 54 45 5f 4f ion and SQLITE_O
01b0: 4b 20 69 73 0a 2a 2a 20 72 65 74 75 72 6e 65 64 K is.** returned
01c0: 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 . If an error oc
01d0: 63 75 72 73 2c 20 2a 70 70 53 65 73 73 69 6f 6e curs, *ppSession
01e0: 20 69 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c 20 is set to NULL
01f0: 61 6e 64 20 61 6e 20 53 51 4c 69 74 65 0a 2a 2a and an SQLite.**
0200: 20 65 72 72 6f 72 20 63 6f 64 65 20 28 65 2e 67 error code (e.g
0210: 2e 20 5b 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5d . [SQLITE_NOMEM]
0220: 29 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a ) is returned..*
0230: 2a 0a 2a 2a 20 49 74 20 69 73 20 70 6f 73 73 69 *.** It is possi
0240: 62 6c 65 20 74 6f 20 63 72 65 61 74 65 20 6d 75 ble to create mu
0250: 6c 74 69 70 6c 65 20 73 65 73 73 69 6f 6e 20 6f ltiple session o
0260: 62 6a 65 63 74 73 20 61 74 74 61 63 68 65 64 20 bjects attached
0270: 74 6f 20 61 20 73 69 6e 67 6c 65 0a 2a 2a 20 64 to a single.** d
0280: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 0a atabase handle..
0290: 2a 2a 0a 2a 2a 20 53 65 73 73 69 6f 6e 20 6f 62 **.** Session ob
02a0: 6a 65 63 74 73 20 63 72 65 61 74 65 64 20 75 73 jects created us
02b0: 69 6e 67 20 74 68 69 73 20 66 75 6e 63 74 69 6f ing this functio
02c0: 6e 20 73 68 6f 75 6c 64 20 62 65 20 64 65 6c 65 n should be dele
02d0: 74 65 64 20 75 73 69 6e 67 20 74 68 65 0a 2a 2a ted using the.**
02e0: 20 5b 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e [sqlite3session
02f0: 5f 64 65 6c 65 74 65 28 29 5d 20 66 75 6e 63 74 _delete()] funct
0300: 69 6f 6e 20 62 65 66 6f 72 65 20 74 68 65 20 64 ion before the d
0310: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 74 atabase handle t
0320: 68 61 74 20 74 68 65 79 0a 2a 2a 20 61 72 65 20 hat they.** are
0330: 61 74 74 61 63 68 65 64 20 74 6f 20 69 73 20 69 attached to is i
0340: 74 73 65 6c 66 20 63 6c 6f 73 65 64 2e 20 49 66 tself closed. If
0350: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 the database ha
0360: 6e 64 6c 65 20 69 73 20 63 6c 6f 73 65 64 20 62 ndle is closed b
0370: 65 66 6f 72 65 0a 2a 2a 20 74 68 65 20 73 65 73 efore.** the ses
0380: 73 69 6f 6e 20 6f 62 6a 65 63 74 20 69 73 20 64 sion object is d
0390: 65 6c 65 74 65 64 2c 20 74 68 65 6e 20 74 68 65 eleted, then the
03a0: 20 72 65 73 75 6c 74 73 20 6f 66 20 63 61 6c 6c results of call
03b0: 69 6e 67 20 61 6e 79 20 73 65 73 73 69 6f 6e 0a ing any session.
03c0: 2a 2a 20 6d 6f 64 75 6c 65 20 66 75 6e 63 74 69 ** module functi
03d0: 6f 6e 2c 20 69 6e 63 6c 75 64 69 6e 67 20 5b 73 on, including [s
03e0: 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 64 65 qlite3session_de
03f0: 6c 65 74 65 28 29 5d 20 6f 6e 20 74 68 65 20 73 lete()] on the s
0400: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 0a 2a 2a ession object.**
0410: 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64 2e 0a are undefined..
0420: 2a 2a 0a 2a 2a 20 42 65 63 61 75 73 65 20 74 68 **.** Because th
0430: 65 20 73 65 73 73 69 6f 6e 20 6d 6f 64 75 6c 65 e session module
0440: 20 75 73 65 73 20 74 68 65 20 5b 73 71 6c 69 74 uses the [sqlit
0450: 65 33 5f 70 72 65 75 70 64 61 74 65 5f 68 6f 6f e3_preupdate_hoo
0460: 6b 28 29 5d 20 41 50 49 2c 20 69 74 0a 2a 2a 20 k()] API, it.**
0470: 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 is not possible
0480: 66 6f 72 20 61 6e 20 61 70 70 6c 69 63 61 74 69 for an applicati
0490: 6f 6e 20 74 6f 20 72 65 67 69 73 74 65 72 20 61 on to register a
04a0: 20 70 72 65 2d 75 70 64 61 74 65 20 68 6f 6f 6b pre-update hook
04b0: 20 6f 6e 20 61 0a 2a 2a 20 64 61 74 61 62 61 73 on a.** databas
04c0: 65 20 68 61 6e 64 6c 65 20 74 68 61 74 20 68 61 e handle that ha
04d0: 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 73 65 s one or more se
04e0: 73 73 69 6f 6e 20 6f 62 6a 65 63 74 73 20 61 74 ssion objects at
04f0: 74 61 63 68 65 64 2e 20 4e 6f 72 20 69 73 0a 2a tached. Nor is.*
0500: 2a 20 69 74 20 70 6f 73 73 69 62 6c 65 20 74 6f * it possible to
0510: 20 63 72 65 61 74 65 20 61 20 73 65 73 73 69 6f create a sessio
0520: 6e 20 6f 62 6a 65 63 74 20 61 74 74 61 63 68 65 n object attache
0530: 64 20 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 d to a database
0540: 68 61 6e 64 6c 65 20 66 6f 72 0a 2a 2a 20 77 68 handle for.** wh
0550: 69 63 68 20 61 20 70 72 65 2d 75 70 64 61 74 65 ich a pre-update
0560: 20 68 6f 6f 6b 20 69 73 20 61 6c 72 65 61 64 79 hook is already
0570: 20 64 65 66 69 6e 65 64 2e 20 54 68 65 20 72 65 defined. The re
0580: 73 75 6c 74 73 20 6f 66 20 61 74 74 65 6d 70 74 sults of attempt
0590: 69 6e 67 20 0a 2a 2a 20 65 69 74 68 65 72 20 6f ing .** either o
05a0: 66 20 74 68 65 73 65 20 74 68 69 6e 67 73 20 61 f these things a
05b0: 72 65 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2a re undefined..**
05c0: 0a 2a 2a 20 54 68 65 20 73 65 73 73 69 6f 6e 20 .** The session
05d0: 6f 62 6a 65 63 74 20 77 69 6c 6c 20 62 65 20 75 object will be u
05e0: 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 63 68 sed to create ch
05f0: 61 6e 67 65 73 65 74 73 20 66 6f 72 20 74 61 62 angesets for tab
0600: 6c 65 73 20 69 6e 0a 2a 2a 20 64 61 74 61 62 61 les in.** databa
0610: 73 65 20 7a 44 62 2c 20 77 68 65 72 65 20 7a 44 se zDb, where zD
0620: 62 20 69 73 20 65 69 74 68 65 72 20 22 6d 61 69 b is either "mai
0630: 6e 22 2c 20 6f 72 20 22 74 65 6d 70 22 2c 20 6f n", or "temp", o
0640: 72 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 6e r the name of an
0650: 0a 2a 2a 20 61 74 74 61 63 68 65 64 20 64 61 74 .** attached dat
0660: 61 62 61 73 65 2e 20 49 74 20 69 73 20 6e 6f 74 abase. It is not
0670: 20 61 6e 20 65 72 72 6f 72 20 69 66 20 64 61 74 an error if dat
0680: 61 62 61 73 65 20 7a 44 62 20 64 6f 65 73 20 6e abase zDb does n
0690: 6f 74 20 65 78 69 73 74 0a 2a 2a 20 74 6f 20 74 ot exist.** to t
06a0: 68 65 20 64 61 74 61 62 61 73 65 20 77 68 65 6e he database when
06b0: 20 74 68 65 20 73 65 73 73 69 6f 6e 20 6f 62 6a the session obj
06c0: 65 63 74 20 69 73 20 63 72 65 61 74 65 64 2e 0a ect is created..
06d0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 73 65 */.int sqlite3se
06e0: 73 73 69 6f 6e 5f 63 72 65 61 74 65 28 0a 20 20 ssion_create(.
06f0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 sqlite3 *db,
0700: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0710: 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 /* Database hand
0720: 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 le */. const ch
0730: 61 72 20 2a 7a 44 62 2c 20 20 20 20 20 20 20 20 ar *zDb,
0740: 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 /* Name
0750: 6f 66 20 64 62 20 28 65 2e 67 2e 20 22 6d 61 69 of db (e.g. "mai
0760: 6e 22 29 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 n") */. sqlite3
0770: 5f 73 65 73 73 69 6f 6e 20 2a 2a 70 70 53 65 73 _session **ppSes
0780: 73 69 6f 6e 20 20 20 20 20 2f 2a 20 4f 55 54 3a sion /* OUT:
0790: 20 4e 65 77 20 73 65 73 73 69 6f 6e 20 6f 62 6a New session obj
07a0: 65 63 74 20 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a ect */.);../*.**
07b0: 20 44 65 6c 65 74 65 20 61 20 73 65 73 73 69 6f Delete a sessio
07c0: 6e 20 6f 62 6a 65 63 74 20 70 72 65 76 69 6f 75 n object previou
07d0: 73 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20 75 73 sly allocated us
07e0: 69 6e 67 20 0a 2a 2a 20 5b 73 71 6c 69 74 65 33 ing .** [sqlite3
07f0: 73 65 73 73 69 6f 6e 5f 63 72 65 61 74 65 28 29 session_create()
0800: 5d 2e 20 4f 6e 63 65 20 61 20 73 65 73 73 69 6f ]. Once a sessio
0810: 6e 20 6f 62 6a 65 63 74 20 68 61 73 20 62 65 65 n object has bee
0820: 6e 20 64 65 6c 65 74 65 64 2c 20 74 68 65 0a 2a n deleted, the.*
0830: 2a 20 72 65 73 75 6c 74 73 20 6f 66 20 61 74 74 * results of att
0840: 65 6d 70 74 69 6e 67 20 74 6f 20 75 73 65 20 70 empting to use p
0850: 53 65 73 73 69 6f 6e 20 77 69 74 68 20 61 6e 79 Session with any
0860: 20 6f 74 68 65 72 20 73 65 73 73 69 6f 6e 20 6d other session m
0870: 6f 64 75 6c 65 0a 2a 2a 20 66 75 6e 63 74 69 6f odule.** functio
0880: 6e 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64 2e n are undefined.
0890: 0a 2a 2a 0a 2a 2a 20 53 65 73 73 69 6f 6e 20 6f .**.** Session o
08a0: 62 6a 65 63 74 73 20 6d 75 73 74 20 62 65 20 64 bjects must be d
08b0: 65 6c 65 74 65 64 20 62 65 66 6f 72 65 20 74 68 eleted before th
08c0: 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c e database handl
08d0: 65 20 74 6f 20 77 68 69 63 68 20 74 68 65 79 0a e to which they.
08e0: 2a 2a 20 61 72 65 20 61 74 74 61 63 68 65 64 20 ** are attached
08f0: 69 73 20 63 6c 6f 73 65 64 2e 20 52 65 66 65 72 is closed. Refer
0900: 20 74 6f 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 to the document
0910: 61 74 69 6f 6e 20 66 6f 72 20 0a 2a 2a 20 5b 73 ation for .** [s
0920: 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 63 72 qlite3session_cr
0930: 65 61 74 65 28 29 5d 20 66 6f 72 20 64 65 74 61 eate()] for deta
0940: 69 6c 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c ils..*/.void sql
0950: 69 74 65 33 73 65 73 73 69 6f 6e 5f 64 65 6c 65 ite3session_dele
0960: 74 65 28 73 71 6c 69 74 65 33 5f 73 65 73 73 69 te(sqlite3_sessi
0970: 6f 6e 20 2a 70 53 65 73 73 69 6f 6e 29 3b 0a 0a on *pSession);..
0980: 2f 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 6f 72 20 /*.** Enable or
0990: 64 69 73 61 62 6c 65 20 74 68 65 20 72 65 63 6f disable the reco
09a0: 72 64 69 6e 67 20 6f 66 20 63 68 61 6e 67 65 73 rding of changes
09b0: 20 62 79 20 61 20 73 65 73 73 69 6f 6e 20 6f 62 by a session ob
09c0: 6a 65 63 74 2e 20 57 68 65 6e 0a 2a 2a 20 65 6e ject. When.** en
09d0: 61 62 6c 65 64 2c 20 61 20 73 65 73 73 69 6f 6e abled, a session
09e0: 20 6f 62 6a 65 63 74 20 72 65 63 6f 72 64 73 20 object records
09f0: 63 68 61 6e 67 65 73 20 6d 61 64 65 20 74 6f 20 changes made to
0a00: 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 57 68 the database. Wh
0a10: 65 6e 0a 2a 2a 20 64 69 73 61 62 6c 65 64 20 2d en.** disabled -
0a20: 20 69 74 20 64 6f 65 73 20 6e 6f 74 2e 20 41 20 it does not. A
0a30: 6e 65 77 6c 79 20 63 72 65 61 74 65 64 20 73 65 newly created se
0a40: 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 69 73 20 ssion object is
0a50: 65 6e 61 62 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 50 enabled..**.** P
0a60: 61 73 73 69 6e 67 20 7a 65 72 6f 20 74 6f 20 74 assing zero to t
0a70: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 64 69 73 his function dis
0a80: 61 62 6c 65 73 20 74 68 65 20 73 65 73 73 69 6f ables the sessio
0a90: 6e 2e 20 50 61 73 73 69 6e 67 20 61 20 76 61 6c n. Passing a val
0aa0: 75 65 0a 2a 2a 20 67 72 65 61 74 65 72 20 74 68 ue.** greater th
0ab0: 61 6e 20 7a 65 72 6f 20 65 6e 61 62 6c 65 73 20 an zero enables
0ac0: 69 74 2e 20 50 61 73 73 69 6e 67 20 61 20 76 61 it. Passing a va
0ad0: 6c 75 65 20 6c 65 73 73 20 74 68 61 6e 20 7a 65 lue less than ze
0ae0: 72 6f 20 69 73 20 61 20 0a 2a 2a 20 6e 6f 2d 6f ro is a .** no-o
0af0: 70 2c 20 61 6e 64 20 6d 61 79 20 62 65 20 75 73 p, and may be us
0b00: 65 64 20 74 6f 20 71 75 65 72 79 20 74 68 65 20 ed to query the
0b10: 63 75 72 72 65 6e 74 20 73 74 61 74 65 20 6f 66 current state of
0b20: 20 74 68 65 20 73 65 73 73 69 6f 6e 2e 0a 2a 2a the session..**
0b30: 0a 2a 2a 20 54 68 65 20 72 65 74 75 72 6e 20 76 .** The return v
0b40: 61 6c 75 65 20 69 6e 64 69 63 61 74 65 73 20 74 alue indicates t
0b50: 68 65 20 66 69 6e 61 6c 20 73 74 61 74 65 20 6f he final state o
0b60: 66 20 74 68 65 20 73 65 73 73 69 6f 6e 20 6f 62 f the session ob
0b70: 6a 65 63 74 3a 20 30 20 69 66 20 0a 2a 2a 20 74 ject: 0 if .** t
0b80: 68 65 20 73 65 73 73 69 6f 6e 20 69 73 20 64 69 he session is di
0b90: 73 61 62 6c 65 64 2c 20 6f 72 20 31 20 69 66 20 sabled, or 1 if
0ba0: 69 74 20 69 73 20 65 6e 61 62 6c 65 64 2e 0a 2a it is enabled..*
0bb0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 73 65 73 /.int sqlite3ses
0bc0: 73 69 6f 6e 5f 65 6e 61 62 6c 65 28 73 71 6c 69 sion_enable(sqli
0bd0: 74 65 33 5f 73 65 73 73 69 6f 6e 20 2a 70 53 65 te3_session *pSe
0be0: 73 73 69 6f 6e 2c 20 69 6e 74 20 62 45 6e 61 62 ssion, int bEnab
0bf0: 6c 65 29 3b 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 61 le);../*.** Atta
0c00: 63 68 20 61 20 74 61 62 6c 65 20 74 6f 20 61 20 ch a table to a
0c10: 73 65 73 73 69 6f 6e 2e 20 41 6c 6c 20 73 75 62 session. All sub
0c20: 73 65 71 75 65 6e 74 20 63 68 61 6e 67 65 73 20 sequent changes
0c30: 6d 61 64 65 20 74 6f 20 74 68 65 20 74 61 62 6c made to the tabl
0c40: 65 0a 2a 2a 20 77 68 69 6c 65 20 74 68 65 20 73 e.** while the s
0c50: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 69 73 ession object is
0c60: 20 65 6e 61 62 6c 65 64 20 77 69 6c 6c 20 62 65 enabled will be
0c70: 20 72 65 63 6f 72 64 65 64 2e 0a 2a 2a 0a 2a 2a recorded..**.**
0c80: 20 4f 6e 6c 79 20 74 61 62 6c 65 73 20 74 68 61 Only tables tha
0c90: 74 20 68 61 76 65 20 61 20 50 52 49 4d 41 52 59 t have a PRIMARY
0ca0: 20 4b 45 59 20 64 65 66 69 6e 65 64 20 6d 61 79 KEY defined may
0cb0: 20 62 65 20 61 74 74 61 63 68 65 64 2e 20 49 74 be attached. It
0cc0: 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 6d 61 74 does.** not mat
0cd0: 74 65 72 20 69 66 20 74 68 65 20 50 52 49 4d 41 ter if the PRIMA
0ce0: 52 59 20 4b 45 59 20 69 73 20 61 6e 20 22 49 4e RY KEY is an "IN
0cf0: 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 TEGER PRIMARY KE
0d00: 59 22 20 28 72 6f 77 69 64 20 61 6c 69 61 73 29 Y" (rowid alias)
0d10: 0a 2a 2a 20 6f 72 20 6e 6f 74 2e 0a 2a 2f 0a 69 .** or not..*/.i
0d20: 6e 74 20 73 71 6c 69 74 65 33 73 65 73 73 69 6f nt sqlite3sessio
0d30: 6e 5f 61 74 74 61 63 68 28 0a 20 20 73 71 6c 69 n_attach(. sqli
0d40: 74 65 33 5f 73 65 73 73 69 6f 6e 20 2a 70 53 65 te3_session *pSe
0d50: 73 73 69 6f 6e 2c 20 20 20 20 20 20 2f 2a 20 53 ssion, /* S
0d60: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 2a 2f ession object */
0d70: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
0d80: 54 61 62 20 20 20 20 20 20 20 20 20 20 20 20 20 Tab
0d90: 20 20 20 2f 2a 20 54 61 62 6c 65 20 6e 61 6d 65 /* Table name
0da0: 20 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 4f 62 */.);../*.** Ob
0db0: 74 61 69 6e 20 61 20 63 68 61 6e 67 65 73 65 74 tain a changeset
0dc0: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 63 68 61 6e containing chan
0dd0: 67 65 73 20 74 6f 20 74 68 65 20 74 61 62 6c 65 ges to the table
0de0: 73 20 61 74 74 61 63 68 65 64 20 74 6f 20 74 68 s attached to th
0df0: 65 20 0a 2a 2a 20 73 65 73 73 69 6f 6e 20 6f 62 e .** session ob
0e00: 6a 65 63 74 20 70 61 73 73 65 64 20 61 73 20 74 ject passed as t
0e10: 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e he first argumen
0e20: 74 2e 20 49 66 20 73 75 63 63 65 73 73 66 75 6c t. If successful
0e30: 2c 20 0a 2a 2a 20 73 65 74 20 2a 70 70 43 68 61 , .** set *ppCha
0e40: 6e 67 65 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 ngeset to point
0e50: 74 6f 20 61 20 62 75 66 66 65 72 20 63 6f 6e 74 to a buffer cont
0e60: 61 69 6e 69 6e 67 20 74 68 65 20 63 68 61 6e 67 aining the chang
0e70: 65 73 65 74 20 0a 2a 2a 20 61 6e 64 20 2a 70 6e eset .** and *pn
0e80: 43 68 61 6e 67 65 73 65 74 20 74 6f 20 74 68 65 Changeset to the
0e90: 20 73 69 7a 65 20 6f 66 20 74 68 65 20 63 68 61 size of the cha
0ea0: 6e 67 65 73 65 74 20 69 6e 20 62 79 74 65 73 20 ngeset in bytes
0eb0: 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 before returning
0ec0: 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 49 .** SQLITE_OK. I
0ed0: 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 f an error occur
0ee0: 73 2c 20 73 65 74 20 62 6f 74 68 20 2a 70 70 43 s, set both *ppC
0ef0: 68 61 6e 67 65 73 65 74 20 61 6e 64 20 2a 70 6e hangeset and *pn
0f00: 43 68 61 6e 67 65 73 65 74 20 74 6f 0a 2a 2a 20 Changeset to.**
0f10: 7a 65 72 6f 20 61 6e 64 20 72 65 74 75 72 6e 20 zero and return
0f20: 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 an SQLite error
0f30: 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 6c 6c code..**.** Foll
0f40: 6f 77 69 6e 67 20 61 20 73 75 63 63 65 73 73 66 owing a successf
0f50: 75 6c 20 63 61 6c 6c 20 74 6f 20 74 68 69 73 20 ul call to this
0f60: 66 75 6e 63 74 69 6f 6e 2c 20 69 74 20 69 73 20 function, it is
0f70: 74 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 the responsibili
0f80: 74 79 20 6f 66 0a 2a 2a 20 74 68 65 20 63 61 6c ty of.** the cal
0f90: 6c 65 72 20 74 6f 20 65 76 65 6e 74 75 61 6c 6c ler to eventuall
0fa0: 79 20 66 72 65 65 20 74 68 65 20 62 75 66 66 65 y free the buffe
0fb0: 72 20 74 68 61 74 20 2a 70 70 43 68 61 6e 67 65 r that *ppChange
0fc0: 73 65 74 20 70 6f 69 6e 74 73 20 74 6f 20 75 73 set points to us
0fd0: 69 6e 67 0a 2a 2a 20 5b 73 71 6c 69 74 65 33 5f ing.** [sqlite3_
0fe0: 66 72 65 65 28 29 5d 2e 0a 2a 2f 0a 69 6e 74 20 free()]..*/.int
0ff0: 73 71 6c 69 74 65 33 73 65 73 73 69 6f 6e 5f 63 sqlite3session_c
1000: 68 61 6e 67 65 73 65 74 28 0a 20 20 73 71 6c 69 hangeset(. sqli
1010: 74 65 33 5f 73 65 73 73 69 6f 6e 20 2a 70 53 65 te3_session *pSe
1020: 73 73 69 6f 6e 2c 20 20 20 20 20 20 2f 2a 20 53 ssion, /* S
1030: 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 2a 2f ession object */
1040: 0a 20 20 69 6e 74 20 2a 70 6e 43 68 61 6e 67 65 . int *pnChange
1050: 73 65 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 set,
1060: 20 20 20 2f 2a 20 4f 55 54 3a 20 53 69 7a 65 20 /* OUT: Size
1070: 6f 66 20 62 75 66 66 65 72 20 61 74 20 2a 70 70 of buffer at *pp
1080: 43 68 61 6e 67 65 73 65 74 20 2a 2f 0a 20 20 76 Changeset */. v
1090: 6f 69 64 20 2a 2a 70 70 43 68 61 6e 67 65 73 65 oid **ppChangese
10a0: 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f t /
10b0: 2a 20 4f 55 54 3a 20 42 75 66 66 65 72 20 63 6f * OUT: Buffer co
10c0: 6e 74 61 69 6e 69 6e 67 20 63 68 61 6e 67 65 73 ntaining changes
10d0: 65 74 20 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 et */.);../*.**
10e0: 43 72 65 61 74 65 20 61 6e 20 69 74 65 72 61 74 Create an iterat
10f0: 6f 72 20 75 73 65 64 20 74 6f 20 69 74 65 72 61 or used to itera
1100: 74 65 20 74 68 72 6f 75 67 68 20 74 68 65 20 63 te through the c
1110: 6f 6e 74 65 6e 74 73 20 6f 66 20 61 20 63 68 61 ontents of a cha
1120: 6e 67 65 73 65 74 2e 0a 2a 2f 0a 69 6e 74 20 73 ngeset..*/.int s
1130: 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f qlite3changeset_
1140: 73 74 61 72 74 28 0a 20 20 73 71 6c 69 74 65 33 start(. sqlite3
1150: 5f 63 68 61 6e 67 65 73 65 74 5f 69 74 65 72 20 _changeset_iter
1160: 2a 2a 70 70 49 74 65 72 2c 0a 20 20 69 6e 74 20 **ppIter,. int
1170: 6e 43 68 61 6e 67 65 73 65 74 2c 20 0a 20 20 76 nChangeset, . v
1180: 6f 69 64 20 2a 70 43 68 61 6e 67 65 73 65 74 0a oid *pChangeset.
1190: 29 3b 0a 0a 2f 2a 0a 2a 2a 20 41 64 76 61 6e 63 );../*.** Advanc
11a0: 65 20 61 6e 20 69 74 65 72 61 74 6f 72 20 63 72 e an iterator cr
11b0: 65 61 74 65 64 20 62 79 20 73 71 6c 69 74 65 33 eated by sqlite3
11c0: 63 68 61 6e 67 65 73 65 74 5f 73 74 61 72 74 28 changeset_start(
11d0: 29 20 74 6f 20 74 68 65 20 6e 65 78 74 0a 2a 2a ) to the next.**
11e0: 20 63 68 61 6e 67 65 20 69 6e 20 74 68 65 20 63 change in the c
11f0: 68 61 6e 67 65 73 65 74 2e 20 54 68 69 73 20 66 hangeset. This f
1200: 75 6e 63 74 69 6f 6e 20 6d 61 79 20 72 65 74 75 unction may retu
1210: 72 6e 20 53 51 4c 49 54 45 5f 52 4f 57 2c 20 53 rn SQLITE_ROW, S
1220: 51 4c 49 54 45 5f 44 4f 4e 45 0a 2a 2a 20 6f 72 QLITE_DONE.** or
1230: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 2e SQLITE_CORRUPT.
1240: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 .**.** This func
1250: 74 69 6f 6e 20 6d 61 79 20 6e 6f 74 20 62 65 20 tion may not be
1260: 63 61 6c 6c 65 64 20 6f 6e 20 69 74 65 72 61 74 called on iterat
1270: 6f 72 73 20 70 61 73 73 65 64 20 74 6f 20 61 20 ors passed to a
1280: 63 6f 6e 66 6c 69 63 74 20 68 61 6e 64 6c 65 72 conflict handler
1290: 0a 2a 2a 20 63 61 6c 6c 62 61 63 6b 20 62 79 20 .** callback by
12a0: 63 68 61 6e 67 65 73 65 74 5f 61 70 70 6c 79 28 changeset_apply(
12b0: 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 )..*/.int sqlite
12c0: 33 63 68 61 6e 67 65 73 65 74 5f 6e 65 78 74 28 3changeset_next(
12d0: 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 65 sqlite3_changese
12e0: 74 5f 69 74 65 72 20 2a 70 49 74 65 72 29 3b 0a t_iter *pIter);.
12f0: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f ./*.** The follo
1300: 77 69 6e 67 20 74 68 72 65 65 20 66 75 6e 63 74 wing three funct
1310: 69 6f 6e 73 20 65 78 74 72 61 63 74 20 69 6e 66 ions extract inf
1320: 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 ormation on the
1330: 63 75 72 72 65 6e 74 20 63 68 61 6e 67 65 0a 2a current change.*
1340: 2a 20 66 72 6f 6d 20 61 20 63 68 61 6e 67 65 73 * from a changes
1350: 65 74 20 69 74 65 72 61 74 6f 72 2e 20 54 68 65 et iterator. The
1360: 79 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 63 61 y may only be ca
1370: 6c 6c 65 64 20 61 66 74 65 72 20 63 68 61 6e 67 lled after chang
1380: 65 73 65 74 5f 6e 65 78 74 28 29 0a 2a 2a 20 68 eset_next().** h
1390: 61 73 20 72 65 74 75 72 6e 65 64 20 53 51 4c 49 as returned SQLI
13a0: 54 45 5f 52 4f 57 2e 0a 2a 2f 0a 69 6e 74 20 73 TE_ROW..*/.int s
13b0: 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f qlite3changeset_
13c0: 6f 70 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 68 op(. sqlite3_ch
13d0: 61 6e 67 65 73 65 74 5f 69 74 65 72 20 2a 70 49 angeset_iter *pI
13e0: 74 65 72 2c 20 20 2f 2a 20 49 74 65 72 61 74 6f ter, /* Iterato
13f0: 72 20 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 63 6f r object */. co
1400: 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 61 62 nst char **pzTab
1410: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a , /*
1420: 20 4f 55 54 3a 20 50 6f 69 6e 74 65 72 20 74 6f OUT: Pointer to
1430: 20 74 61 62 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 table name */.
1440: 20 69 6e 74 20 2a 70 6e 43 6f 6c 2c 20 20 20 20 int *pnCol,
1450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1460: 20 2f 2a 20 4f 55 54 3a 20 4e 75 6d 62 65 72 20 /* OUT: Number
1470: 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 61 of columns in ta
1480: 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 4f ble */. int *pO
1490: 70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 p
14a0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a /* OUT:
14b0: 20 53 51 4c 49 54 45 5f 49 4e 53 45 52 54 2c 20 SQLITE_INSERT,
14c0: 44 45 4c 45 54 45 20 6f 72 20 55 50 44 41 54 45 DELETE or UPDATE
14d0: 20 2a 2f 0a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 */.);.int sqlit
14e0: 65 33 63 68 61 6e 67 65 73 65 74 5f 6f 6c 64 28 e3changeset_old(
14f0: 0a 20 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 . sqlite3_chang
1500: 65 73 65 74 5f 69 74 65 72 20 2a 70 49 74 65 72 eset_iter *pIter
1510: 2c 20 20 2f 2a 20 43 68 61 6e 67 65 73 65 74 20 , /* Changeset
1520: 69 74 65 72 61 74 6f 72 20 2a 2f 0a 20 20 69 6e iterator */. in
1530: 74 20 69 56 61 6c 2c 20 20 20 20 20 20 20 20 20 t iVal,
1540: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1550: 20 43 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 2a Column number *
1560: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 /. sqlite3_valu
1570: 65 20 2a 2a 70 70 56 61 6c 75 65 20 20 20 20 20 e **ppValue
1580: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 4f 6c 64 20 /* OUT: Old
1590: 76 61 6c 75 65 20 28 6f 72 20 4e 55 4c 4c 20 70 value (or NULL p
15a0: 6f 69 6e 74 65 72 29 20 2a 2f 0a 29 3b 0a 69 6e ointer) */.);.in
15b0: 74 20 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 t sqlite3changes
15c0: 65 74 5f 6e 65 77 28 0a 20 20 73 71 6c 69 74 65 et_new(. sqlite
15d0: 33 5f 63 68 61 6e 67 65 73 65 74 5f 69 74 65 72 3_changeset_iter
15e0: 20 2a 70 49 74 65 72 2c 20 20 2f 2a 20 43 68 61 *pIter, /* Cha
15f0: 6e 67 65 73 65 74 20 69 74 65 72 61 74 6f 72 20 ngeset iterator
1600: 2a 2f 0a 20 20 69 6e 74 20 69 56 61 6c 2c 20 20 */. int iVal,
1610: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1620: 20 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e /* Column n
1630: 75 6d 62 65 72 20 2a 2f 0a 20 20 73 71 6c 69 74 umber */. sqlit
1640: 65 33 5f 76 61 6c 75 65 20 2a 2a 70 70 56 61 6c e3_value **ppVal
1650: 75 65 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 ue /* OU
1660: 54 3a 20 4e 65 77 20 76 61 6c 75 65 20 28 6f 72 T: New value (or
1670: 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 29 20 2a NULL pointer) *
1680: 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 /.);../*.** This
1690: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c function is onl
16a0: 79 20 75 73 61 62 6c 65 20 77 69 74 68 20 73 71 y usable with sq
16b0: 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 65 74 5f lite3_changeset_
16c0: 69 74 65 72 20 6f 62 6a 65 63 74 73 20 70 61 73 iter objects pas
16d0: 73 65 64 0a 2a 2a 20 74 6f 20 74 68 65 20 78 43 sed.** to the xC
16e0: 6f 6e 66 6c 69 63 74 20 63 61 6c 6c 62 61 63 6b onflict callback
16f0: 20 62 79 20 73 71 6c 69 74 65 33 63 68 61 6e 67 by sqlite3chang
1700: 65 73 65 74 5f 61 70 70 6c 79 28 29 2e 20 49 74 eset_apply(). It
1710: 20 63 61 6e 6e 6f 74 20 62 65 20 75 73 65 64 0a cannot be used.
1720: 2a 2a 20 77 69 74 68 20 69 74 65 72 61 74 6f 72 ** with iterator
1730: 73 20 63 72 65 61 74 65 64 20 75 73 69 6e 67 20 s created using
1740: 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 sqlite3changeset
1750: 5f 73 74 61 72 74 28 29 2e 0a 2a 2a 0a 2a 2a 20 _start()..**.**
1760: 49 74 20 69 73 20 75 73 65 64 20 74 6f 20 61 63 It is used to ac
1770: 63 65 73 73 20 74 68 65 20 22 63 6f 6e 66 6c 69 cess the "confli
1780: 63 74 69 6e 67 20 72 6f 77 22 20 69 6e 66 6f 72 cting row" infor
1790: 6d 61 74 69 6f 6e 20 61 76 61 69 6c 61 62 6c 65 mation available
17a0: 20 74 6f 20 74 68 65 0a 2a 2a 20 63 6f 6e 66 6c to the.** confl
17b0: 69 63 74 20 68 61 6e 64 6c 65 72 20 69 66 20 74 ict handler if t
17c0: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 he second argume
17d0: 6e 74 20 69 73 20 65 69 74 68 65 72 20 53 51 4c nt is either SQL
17e0: 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 44 41 ITE_CHANGESET_DA
17f0: 54 41 0a 2a 2a 20 6f 72 20 53 51 4c 49 54 45 5f TA.** or SQLITE_
1800: 43 48 41 4e 47 45 53 45 54 5f 43 4f 4e 46 4c 49 CHANGESET_CONFLI
1810: 43 54 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 CT..*/.int sqlit
1820: 65 33 63 68 61 6e 67 65 73 65 74 5f 63 6f 6e 66 e3changeset_conf
1830: 6c 69 63 74 28 0a 20 20 73 71 6c 69 74 65 33 5f lict(. sqlite3_
1840: 63 68 61 6e 67 65 73 65 74 5f 69 74 65 72 20 2a changeset_iter *
1850: 70 49 74 65 72 2c 20 20 2f 2a 20 43 68 61 6e 67 pIter, /* Chang
1860: 65 73 65 74 20 69 74 65 72 61 74 6f 72 20 2a 2f eset iterator */
1870: 0a 20 20 69 6e 74 20 69 56 61 6c 2c 20 20 20 20 . int iVal,
1880: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1890: 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 75 6d /* Column num
18a0: 62 65 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 ber */. sqlite3
18b0: 5f 76 61 6c 75 65 20 2a 2a 70 70 56 61 6c 75 65 _value **ppValue
18c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a /* OUT:
18d0: 20 56 61 6c 75 65 20 66 72 6f 6d 20 63 6f 6e 66 Value from conf
18e0: 6c 69 63 74 69 6e 67 20 72 6f 77 20 2a 2f 0a 29 licting row */.)
18f0: 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e 61 6c 69 ;.../*.** Finali
1900: 7a 65 20 61 6e 20 69 74 65 72 61 74 6f 72 20 61 ze an iterator a
1910: 6c 6c 6f 63 61 74 65 64 20 77 69 74 68 20 73 71 llocated with sq
1920: 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f 73 lite3changeset_s
1930: 74 61 72 74 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 tart()..**.** Th
1940: 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 is function may
1950: 6e 6f 74 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e not be called on
1960: 20 69 74 65 72 61 74 6f 72 73 20 70 61 73 73 65 iterators passe
1970: 64 20 74 6f 20 61 20 63 6f 6e 66 6c 69 63 74 20 d to a conflict
1980: 68 61 6e 64 6c 65 72 0a 2a 2a 20 63 61 6c 6c 62 handler.** callb
1990: 61 63 6b 20 62 79 20 63 68 61 6e 67 65 73 65 74 ack by changeset
19a0: 5f 61 70 70 6c 79 28 29 2e 0a 2a 2f 0a 69 6e 74 _apply()..*/.int
19b0: 20 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 sqlite3changese
19c0: 74 5f 66 69 6e 61 6c 69 7a 65 28 73 71 6c 69 74 t_finalize(sqlit
19d0: 65 33 5f 63 68 61 6e 67 65 73 65 74 5f 69 74 65 e3_changeset_ite
19e0: 72 20 2a 70 49 74 65 72 29 3b 0a 0a 2f 2a 0a 2a r *pIter);../*.*
19f0: 2a 20 49 6e 76 65 72 74 20 61 20 63 68 61 6e 67 * Invert a chang
1a00: 65 73 65 74 20 6f 62 6a 65 63 74 2e 0a 2a 2f 0a eset object..*/.
1a10: 69 6e 74 20 73 71 6c 69 74 65 33 63 68 61 6e 67 int sqlite3chang
1a20: 65 73 65 74 5f 69 6e 76 65 72 74 28 0a 20 20 69 eset_invert(. i
1a30: 6e 74 20 6e 49 6e 2c 20 76 6f 69 64 20 2a 70 49 nt nIn, void *pI
1a40: 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f n, /
1a50: 2a 20 49 6e 70 75 74 20 63 68 61 6e 67 65 73 65 * Input changese
1a60: 74 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4f 75 t */. int *pnOu
1a70: 74 2c 20 76 6f 69 64 20 2a 2a 70 70 4f 75 74 20 t, void **ppOut
1a80: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 49 /* OUT: I
1a90: 6e 76 65 72 73 65 20 6f 66 20 69 6e 70 75 74 20 nverse of input
1aa0: 2a 2f 0a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 41 70 70 */.);../*.** App
1ab0: 6c 79 20 61 20 63 68 61 6e 67 65 73 65 74 20 74 ly a changeset t
1ac0: 6f 20 61 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a o a database..**
1ad0: 0a 2a 2a 20 49 74 20 69 73 20 73 61 66 65 20 74 .** It is safe t
1ae0: 6f 20 65 78 65 63 75 74 65 20 53 51 4c 20 73 74 o execute SQL st
1af0: 61 74 65 6d 65 6e 74 73 2c 20 69 6e 63 6c 75 64 atements, includ
1b00: 69 6e 67 20 74 68 6f 73 65 20 74 68 61 74 20 77 ing those that w
1b10: 72 69 74 65 20 74 6f 20 74 68 65 0a 2a 2a 20 74 rite to the.** t
1b20: 61 62 6c 65 20 74 68 61 74 20 74 68 65 20 63 61 able that the ca
1b30: 6c 6c 62 61 63 6b 20 72 65 6c 61 74 65 64 20 74 llback related t
1b40: 6f 2c 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 74 o, from within t
1b50: 68 65 20 78 43 6f 6e 66 6c 69 63 74 20 63 61 6c he xConflict cal
1b60: 6c 62 61 63 6b 2e 0a 2a 2a 20 54 68 69 73 20 63 lback..** This c
1b70: 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 66 75 an be used to fu
1b80: 72 74 68 65 72 20 63 75 73 74 6f 6d 69 7a 65 20 rther customize
1b90: 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 the applications
1ba0: 20 63 6f 6e 66 6c 69 63 74 0a 2a 2a 20 72 65 73 conflict.** res
1bb0: 6f 6c 75 74 69 6f 6e 20 73 74 72 61 74 65 67 79 olution strategy
1bc0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
1bd0: 63 68 61 6e 67 65 73 65 74 5f 61 70 70 6c 79 28 changeset_apply(
1be0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 . sqlite3 *db,
1bf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c00: 20 20 20 2f 2a 20 41 70 70 6c 79 20 63 68 61 6e /* Apply chan
1c10: 67 65 20 74 6f 20 22 6d 61 69 6e 22 20 64 62 20 ge to "main" db
1c20: 6f 66 20 74 68 69 73 20 68 61 6e 64 6c 65 20 2a of this handle *
1c30: 2f 0a 20 20 69 6e 74 20 6e 43 68 61 6e 67 65 73 /. int nChanges
1c40: 65 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 et,
1c50: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 63 /* Size of c
1c60: 68 61 6e 67 65 73 65 74 20 69 6e 20 62 79 74 65 hangeset in byte
1c70: 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 43 68 s */. void *pCh
1c80: 61 6e 67 65 73 65 74 2c 20 20 20 20 20 20 20 20 angeset,
1c90: 20 20 20 20 20 20 20 2f 2a 20 43 68 61 6e 67 65 /* Change
1ca0: 73 65 74 20 62 6c 6f 62 20 2a 2f 0a 20 20 69 6e set blob */. in
1cb0: 74 28 2a 78 43 6f 6e 66 6c 69 63 74 29 28 0a 20 t(*xConflict)(.
1cc0: 20 20 20 76 6f 69 64 20 2a 70 43 74 78 2c 20 20 void *pCtx,
1cd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ce0: 20 2f 2a 20 43 6f 70 79 20 6f 66 20 66 69 66 74 /* Copy of fift
1cf0: 68 20 61 72 67 20 74 6f 20 5f 61 70 70 6c 79 28 h arg to _apply(
1d00: 29 20 2a 2f 0a 20 20 20 20 69 6e 74 20 65 43 6f ) */. int eCo
1d10: 6e 66 6c 69 63 74 2c 20 20 20 20 20 20 20 20 20 nflict,
1d20: 20 20 20 20 20 20 20 2f 2a 20 44 41 54 41 2c 20 /* DATA,
1d30: 4d 49 53 53 49 4e 47 2c 20 43 4f 4e 46 4c 49 43 MISSING, CONFLIC
1d40: 54 2c 20 43 4f 4e 53 54 52 41 49 4e 54 20 2a 2f T, CONSTRAINT */
1d50: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 63 68 61 . sqlite3_cha
1d60: 6e 67 65 73 65 74 5f 69 74 65 72 20 2a 70 20 20 ngeset_iter *p
1d70: 20 20 20 2f 2a 20 48 61 6e 64 6c 65 20 64 65 73 /* Handle des
1d80: 63 72 69 62 69 6e 67 20 63 68 61 6e 67 65 20 61 cribing change a
1d90: 6e 64 20 63 6f 6e 66 6c 69 63 74 20 2a 2f 0a 20 nd conflict */.
1da0: 20 29 2c 0a 20 20 76 6f 69 64 20 2a 70 43 74 78 ),. void *pCtx
1db0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1dc0: 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 /* First a
1dd0: 72 67 75 6d 65 6e 74 20 70 61 73 73 65 64 20 74 rgument passed t
1de0: 6f 20 78 43 6f 6e 66 6c 69 63 74 20 2a 2f 0a 29 o xConflict */.)
1df0: 3b 0a 0a 2f 2a 20 0a 2a 2a 20 56 61 6c 75 65 73 ;../* .** Values
1e00: 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20 73 passed as the s
1e10: 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 74 econd argument t
1e20: 6f 20 61 20 63 6f 6e 66 6c 69 63 74 2d 68 61 6e o a conflict-han
1e30: 64 6c 65 72 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 dler..**.** SQLI
1e40: 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 44 41 54 TE_CHANGESET_DAT
1e50: 41 3a 0a 2a 2a 20 20 20 54 68 65 20 63 6f 6e 66 A:.** The conf
1e60: 6c 69 63 74 20 68 61 6e 64 6c 65 72 20 69 73 20 lict handler is
1e70: 69 6e 76 6f 6b 65 64 20 77 69 74 68 20 43 48 41 invoked with CHA
1e80: 4e 47 45 53 45 54 5f 44 41 54 41 20 61 73 20 74 NGESET_DATA as t
1e90: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 he second argume
1ea0: 6e 74 0a 2a 2a 20 20 20 77 68 65 6e 20 70 72 6f nt.** when pro
1eb0: 63 65 73 73 69 6e 67 20 61 20 44 45 4c 45 54 45 cessing a DELETE
1ec0: 20 6f 72 20 55 50 44 41 54 45 20 63 68 61 6e 67 or UPDATE chang
1ed0: 65 20 69 66 20 61 20 72 6f 77 20 77 69 74 68 20 e if a row with
1ee0: 74 68 65 20 72 65 71 75 69 72 65 64 0a 2a 2a 20 the required.**
1ef0: 20 20 50 52 49 4d 41 52 59 20 4b 45 59 20 66 69 PRIMARY KEY fi
1f00: 65 6c 64 73 20 69 73 20 70 72 65 73 65 6e 74 20 elds is present
1f10: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2c in the database,
1f20: 20 62 75 74 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 but one or more
1f30: 20 6f 74 68 65 72 20 0a 2a 2a 20 20 20 28 6e 6f other .** (no
1f40: 6e 20 70 72 69 6d 61 72 79 2d 6b 65 79 29 20 66 n primary-key) f
1f50: 69 65 6c 64 73 20 6d 6f 64 69 66 69 65 64 20 62 ields modified b
1f60: 79 20 74 68 65 20 75 70 64 61 74 65 20 64 6f 20 y the update do
1f70: 6e 6f 74 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 not contain the
1f80: 0a 2a 2a 20 20 20 65 78 70 65 63 74 65 64 20 22 .** expected "
1f90: 62 65 66 6f 72 65 22 20 76 61 6c 75 65 73 2e 0a before" values..
1fa0: 2a 2a 20 0a 2a 2a 20 20 20 54 68 65 20 63 6f 6e ** .** The con
1fb0: 66 6c 69 63 74 69 6e 67 20 72 6f 77 2c 20 69 6e flicting row, in
1fc0: 20 74 68 69 73 20 63 61 73 65 2c 20 69 73 20 74 this case, is t
1fd0: 68 65 20 64 61 74 61 62 61 73 65 20 72 6f 77 20 he database row
1fe0: 77 69 74 68 20 74 68 65 20 6d 61 74 63 68 69 6e with the matchin
1ff0: 67 0a 2a 2a 20 20 20 70 72 69 6d 61 72 79 20 6b g.** primary k
2000: 65 79 2e 0a 2a 2a 20 0a 2a 2a 20 53 51 4c 49 54 ey..** .** SQLIT
2010: 45 5f 43 48 41 4e 47 45 53 45 54 5f 4e 4f 54 46 E_CHANGESET_NOTF
2020: 4f 55 4e 44 3a 0a 2a 2a 20 20 20 54 68 65 20 63 OUND:.** The c
2030: 6f 6e 66 6c 69 63 74 20 68 61 6e 64 6c 65 72 20 onflict handler
2040: 69 73 20 69 6e 76 6f 6b 65 64 20 77 69 74 68 20 is invoked with
2050: 43 48 41 4e 47 45 53 45 54 5f 4e 4f 54 46 4f 55 CHANGESET_NOTFOU
2060: 4e 44 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 ND as the second
2070: 0a 2a 2a 20 20 20 61 72 67 75 6d 65 6e 74 20 77 .** argument w
2080: 68 65 6e 20 70 72 6f 63 65 73 73 69 6e 67 20 61 hen processing a
2090: 20 44 45 4c 45 54 45 20 6f 72 20 55 50 44 41 54 DELETE or UPDAT
20a0: 45 20 63 68 61 6e 67 65 20 69 66 20 61 20 72 6f E change if a ro
20b0: 77 20 77 69 74 68 20 74 68 65 0a 2a 2a 20 20 20 w with the.**
20c0: 72 65 71 75 69 72 65 64 20 50 52 49 4d 41 52 59 required PRIMARY
20d0: 20 4b 45 59 20 66 69 65 6c 64 73 20 69 73 20 6e KEY fields is n
20e0: 6f 74 20 70 72 65 73 65 6e 74 20 69 6e 20 74 68 ot present in th
20f0: 65 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a 20 0a e database..** .
2100: 2a 2a 20 20 20 54 68 65 72 65 20 69 73 20 6e 6f ** There is no
2110: 20 63 6f 6e 66 6c 69 63 74 69 6e 67 20 72 6f 77 conflicting row
2120: 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 20 54 in this case. T
2130: 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20 69 6e he results of in
2140: 76 6f 6b 69 6e 67 20 74 68 65 0a 2a 2a 20 20 20 voking the.**
2150: 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 65 74 sqlite3changeset
2160: 5f 63 6f 6e 66 6c 69 63 74 28 29 20 41 50 49 20 _conflict() API
2170: 61 72 65 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a are undefined..*
2180: 2a 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 48 41 * .** SQLITE_CHA
2190: 4e 47 45 53 45 54 5f 43 4f 4e 46 4c 49 43 54 3a NGESET_CONFLICT:
21a0: 0a 2a 2a 20 20 20 43 48 41 4e 47 45 53 45 54 5f .** CHANGESET_
21b0: 43 4f 4e 46 4c 49 43 54 20 69 73 20 70 61 73 73 CONFLICT is pass
21c0: 65 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 ed as the second
21d0: 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 argument to the
21e0: 20 63 6f 6e 66 6c 69 63 74 0a 2a 2a 20 20 20 68 conflict.** h
21f0: 61 6e 64 6c 65 72 20 77 68 69 6c 65 20 70 72 6f andler while pro
2200: 63 65 73 73 69 6e 67 20 61 6e 20 55 50 44 41 54 cessing an UPDAT
2210: 45 20 6f 72 20 61 6e 20 49 4e 53 45 52 54 20 69 E or an INSERT i
2220: 66 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 f the operation
2230: 77 6f 75 6c 64 0a 2a 2a 20 20 20 72 65 73 75 6c would.** resul
2240: 74 20 69 6e 20 64 75 70 6c 69 63 61 74 65 20 70 t in duplicate p
2250: 72 69 6d 61 72 79 20 6b 65 79 20 76 61 6c 75 65 rimary key value
2260: 73 2e 0a 2a 2a 20 0a 2a 2a 20 20 20 54 68 65 20 s..** .** The
2270: 63 6f 6e 66 6c 69 63 74 69 6e 67 20 72 6f 77 20 conflicting row
2280: 69 6e 20 74 68 69 73 20 63 61 73 65 20 69 73 20 in this case is
2290: 74 68 65 20 64 61 74 61 62 61 73 65 20 72 6f 77 the database row
22a0: 20 77 69 74 68 20 74 68 65 20 6d 61 74 63 68 69 with the matchi
22b0: 6e 67 0a 2a 2a 20 20 20 70 72 69 6d 61 72 79 20 ng.** primary
22c0: 6b 65 79 2e 0a 2a 2a 20 0a 2a 2a 20 53 51 4c 49 key..** .** SQLI
22d0: 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 43 4f 4e TE_CHANGESET_CON
22e0: 53 54 52 41 49 4e 54 3a 0a 2a 2a 20 20 20 49 66 STRAINT:.** If
22f0: 20 61 6e 79 20 6f 74 68 65 72 20 63 6f 6e 73 74 any other const
2300: 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20 raint violation
2310: 6f 63 63 75 72 73 20 77 68 69 6c 65 20 61 70 70 occurs while app
2320: 6c 79 69 6e 67 20 61 20 63 68 61 6e 67 65 20 28 lying a change (
2330: 69 2e 65 2e 20 0a 2a 2a 20 20 20 61 20 46 4f 52 i.e. .** a FOR
2340: 45 49 47 4e 20 4b 45 59 2c 20 55 4e 49 51 55 45 EIGN KEY, UNIQUE
2350: 2c 20 43 48 45 43 4b 20 6f 72 20 4e 4f 54 20 4e , CHECK or NOT N
2360: 55 4c 4c 20 63 6f 6e 73 74 72 61 69 6e 74 29 2c ULL constraint),
2370: 20 74 68 65 20 63 6f 6e 66 6c 69 63 74 20 0a 2a the conflict .*
2380: 2a 20 20 20 68 61 6e 64 6c 65 72 20 69 73 20 69 * handler is i
2390: 6e 76 6f 6b 65 64 20 77 69 74 68 20 43 48 41 4e nvoked with CHAN
23a0: 47 45 53 45 54 5f 43 4f 4e 53 54 52 41 49 4e 54 GESET_CONSTRAINT
23b0: 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 20 61 as the second a
23c0: 72 67 75 6d 65 6e 74 2e 0a 2a 2a 20 0a 2a 2a 20 rgument..** .**
23d0: 20 20 54 68 65 72 65 20 69 73 20 6e 6f 20 63 6f There is no co
23e0: 6e 66 6c 69 63 74 69 6e 67 20 72 6f 77 20 69 6e nflicting row in
23f0: 20 74 68 69 73 20 63 61 73 65 2e 20 54 68 65 20 this case. The
2400: 72 65 73 75 6c 74 73 20 6f 66 20 69 6e 76 6f 6b results of invok
2410: 69 6e 67 20 74 68 65 0a 2a 2a 20 20 20 73 71 6c ing the.** sql
2420: 69 74 65 33 63 68 61 6e 67 65 73 65 74 5f 63 6f ite3changeset_co
2430: 6e 66 6c 69 63 74 28 29 20 41 50 49 20 61 72 65 nflict() API are
2440: 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 23 undefined..*/.#
2450: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 48 define SQLITE_CH
2460: 41 4e 47 45 53 45 54 5f 44 41 54 41 20 20 20 20 ANGESET_DATA
2470: 20 20 20 31 0a 23 64 65 66 69 6e 65 20 53 51 4c 1.#define SQL
2480: 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 4e 4f ITE_CHANGESET_NO
2490: 54 46 4f 55 4e 44 20 20 20 32 0a 23 64 65 66 69 TFOUND 2.#defi
24a0: 6e 65 20 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 ne SQLITE_CHANGE
24b0: 53 45 54 5f 43 4f 4e 46 4c 49 43 54 20 20 20 33 SET_CONFLICT 3
24c0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
24d0: 43 48 41 4e 47 45 53 45 54 5f 43 4f 4e 53 54 52 CHANGESET_CONSTR
24e0: 41 49 4e 54 20 34 0a 0a 2f 2a 20 0a 2a 2a 20 56 AINT 4../* .** V
24f0: 61 6c 69 64 20 72 65 74 75 72 6e 20 76 61 6c 75 alid return valu
2500: 65 73 20 66 72 6f 6d 20 61 20 63 6f 6e 66 6c 69 es from a confli
2510: 63 74 2d 68 61 6e 64 6c 65 72 2e 0a 2a 2a 0a 2a ct-handler..**.*
2520: 2a 20 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 * SQLITE_CHANGES
2530: 45 54 5f 4f 4d 49 54 3a 0a 2a 2a 20 20 20 49 66 ET_OMIT:.** If
2540: 20 61 20 63 6f 6e 66 6c 69 63 74 20 68 61 6e 64 a conflict hand
2550: 6c 65 72 20 72 65 74 75 72 6e 73 20 74 68 69 73 ler returns this
2560: 20 76 61 6c 75 65 20 6e 6f 20 73 70 65 63 69 61 value no specia
2570: 6c 20 61 63 74 69 6f 6e 20 69 73 20 74 61 6b 65 l action is take
2580: 6e 2e 20 54 68 65 0a 2a 2a 20 20 20 63 68 61 6e n. The.** chan
2590: 67 65 20 69 73 20 6e 6f 74 20 61 70 70 6c 69 65 ge is not applie
25a0: 64 2e 20 54 68 65 20 73 65 73 73 69 6f 6e 20 6d d. The session m
25b0: 6f 64 75 6c 65 20 63 6f 6e 74 69 6e 75 65 73 20 odule continues
25c0: 74 6f 20 74 68 65 20 6e 65 78 74 20 63 68 61 6e to the next chan
25d0: 67 65 0a 2a 2a 20 20 20 69 6e 20 74 68 65 20 63 ge.** in the c
25e0: 68 61 6e 67 65 73 65 74 2e 0a 2a 2a 0a 2a 2a 20 hangeset..**.**
25f0: 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54 SQLITE_CHANGESET
2600: 5f 52 45 50 4c 41 43 45 3a 0a 2a 2a 20 20 20 54 _REPLACE:.** T
2610: 68 69 73 20 76 61 6c 75 65 20 6d 61 79 20 6f 6e his value may on
2620: 6c 79 20 62 65 20 72 65 74 75 72 6e 65 64 20 69 ly be returned i
2630: 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 f the second arg
2640: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 63 6f 6e ument to the con
2650: 66 6c 69 63 74 0a 2a 2a 20 20 20 68 61 6e 64 6c flict.** handl
2660: 65 72 20 77 61 73 20 53 51 4c 49 54 45 5f 43 48 er was SQLITE_CH
2670: 41 4e 47 45 53 45 54 5f 44 41 54 41 20 6f 72 20 ANGESET_DATA or
2680: 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 45 54 SQLITE_CHANGESET
2690: 5f 43 4f 4e 46 4c 49 43 54 2e 20 49 66 20 74 68 _CONFLICT. If th
26a0: 69 73 0a 2a 2a 20 20 20 69 73 20 6e 6f 74 20 74 is.** is not t
26b0: 68 65 20 63 61 73 65 2c 20 61 6e 79 20 63 68 61 he case, any cha
26c0: 6e 67 65 73 20 61 70 70 6c 69 65 64 20 73 6f 20 nges applied so
26d0: 66 61 72 20 61 72 65 20 72 6f 6c 6c 65 64 20 62 far are rolled b
26e0: 61 63 6b 20 61 6e 64 20 74 68 65 20 0a 2a 2a 20 ack and the .**
26f0: 20 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 call to sqlite
2700: 33 63 68 61 6e 67 65 73 65 74 5f 61 70 70 6c 79 3changeset_apply
2710: 28 29 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 () returns SQLIT
2720: 45 5f 4d 49 53 55 53 45 2e 0a 2a 2a 0a 2a 2a 20 E_MISUSE..**.**
2730: 20 20 49 66 20 43 48 41 4e 47 45 53 45 54 5f 52 If CHANGESET_R
2740: 45 50 4c 41 43 45 20 69 73 20 72 65 74 75 72 6e EPLACE is return
2750: 65 64 20 62 79 20 61 6e 20 53 51 4c 49 54 45 5f ed by an SQLITE_
2760: 43 48 41 4e 47 45 53 45 54 5f 44 41 54 41 20 63 CHANGESET_DATA c
2770: 6f 6e 66 6c 69 63 74 0a 2a 2a 20 20 20 68 61 6e onflict.** han
2780: 64 6c 65 72 2c 20 74 68 65 6e 20 74 68 65 20 63 dler, then the c
2790: 6f 6e 66 6c 69 63 74 69 6e 67 20 72 6f 77 20 69 onflicting row i
27a0: 73 20 65 69 74 68 65 72 20 75 70 64 61 74 65 64 s either updated
27b0: 20 6f 72 20 64 65 6c 65 74 65 64 2c 20 64 65 70 or deleted, dep
27c0: 65 6e 64 69 6e 67 0a 2a 2a 20 20 20 6f 6e 20 74 ending.** on t
27d0: 68 65 20 74 79 70 65 20 6f 66 20 63 68 61 6e 67 he type of chang
27e0: 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 49 66 20 43 48 e..**.** If CH
27f0: 41 4e 47 45 53 45 54 5f 52 45 50 4c 41 43 45 20 ANGESET_REPLACE
2800: 69 73 20 72 65 74 75 72 6e 65 64 20 62 79 20 61 is returned by a
2810: 6e 20 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 53 n SQLITE_CHANGES
2820: 45 54 5f 43 4f 4e 46 4c 49 43 54 20 63 6f 6e 66 ET_CONFLICT conf
2830: 6c 69 63 74 0a 2a 2a 20 20 20 68 61 6e 64 6c 65 lict.** handle
2840: 72 2c 20 74 68 65 6e 20 74 68 65 20 63 6f 6e 66 r, then the conf
2850: 6c 69 63 74 69 6e 67 20 72 6f 77 20 69 73 20 72 licting row is r
2860: 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 emoved from the
2870: 64 61 74 61 62 61 73 65 20 61 6e 64 20 61 0a 2a database and a.*
2880: 2a 20 20 20 73 65 63 6f 6e 64 20 61 74 74 65 6d * second attem
2890: 70 74 20 74 6f 20 61 70 70 6c 79 20 74 68 65 20 pt to apply the
28a0: 63 68 61 6e 67 65 20 69 73 20 6d 61 64 65 2e 20 change is made.
28b0: 49 66 20 74 68 69 73 20 73 65 63 6f 6e 64 20 61 If this second a
28c0: 74 74 65 6d 70 74 20 66 61 69 6c 73 2c 0a 2a 2a ttempt fails,.**
28d0: 20 20 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 the original
28e0: 72 6f 77 20 69 73 20 72 65 73 74 6f 72 65 64 20 row is restored
28f0: 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 to the database
2900: 62 65 66 6f 72 65 20 63 6f 6e 74 69 6e 75 69 6e before continuin
2910: 67 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f g..**.** SQLITE_
2920: 43 48 41 4e 47 45 53 45 54 5f 41 42 4f 52 54 3a CHANGESET_ABORT:
2930: 0a 2a 2a 20 20 20 49 66 20 74 68 69 73 20 76 61 .** If this va
2940: 6c 75 65 20 69 73 20 72 65 74 75 72 6e 65 64 2c lue is returned,
2950: 20 61 6e 79 20 63 68 61 6e 67 65 73 20 61 70 70 any changes app
2960: 6c 69 65 64 20 73 6f 20 66 61 72 20 61 72 65 20 lied so far are
2970: 72 6f 6c 6c 65 64 20 62 61 63 6b 20 0a 2a 2a 20 rolled back .**
2980: 20 20 61 6e 64 20 74 68 65 20 63 61 6c 6c 20 74 and the call t
2990: 6f 20 73 71 6c 69 74 65 33 63 68 61 6e 67 65 73 o sqlite3changes
29a0: 65 74 5f 61 70 70 6c 79 28 29 20 72 65 74 75 72 et_apply() retur
29b0: 6e 73 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 ns SQLITE_MISUSE
29c0: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c ..*/.#define SQL
29d0: 49 54 45 5f 43 48 41 4e 47 45 53 45 54 5f 4f 4d ITE_CHANGESET_OM
29e0: 49 54 20 20 20 20 20 20 20 30 0a 23 64 65 66 69 IT 0.#defi
29f0: 6e 65 20 53 51 4c 49 54 45 5f 43 48 41 4e 47 45 ne SQLITE_CHANGE
2a00: 53 45 54 5f 52 45 50 4c 41 43 45 20 20 20 20 31 SET_REPLACE 1
2a10: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
2a20: 43 48 41 4e 47 45 53 45 54 5f 41 42 4f 52 54 20 CHANGESET_ABORT
2a30: 20 20 20 20 20 32 0a 0a 23 65 6e 64 69 66 0a 0a 2..#endif..