.Dd January 24, 2024
.Dt SQLITE_CHANGESETAPPLY_NOSAVEPOINT 3
.Os
.Sh NAME
.Nm SQLITE_CHANGESETAPPLY_NOSAVEPOINT ,
.Nm SQLITE_CHANGESETAPPLY_INVERT ,
.Nm SQLITE_CHANGESETAPPLY_IGNORENOOP ,
.Nm SQLITE_CHANGESETAPPLY_FKNOACTION
.Nd flags for sqlite3changeset_apply_v2
.Sh SYNOPSIS
.In sqlite3.h
.Fd #define SQLITE_CHANGESETAPPLY_NOSAVEPOINT
.Fd #define SQLITE_CHANGESETAPPLY_INVERT
.Fd #define SQLITE_CHANGESETAPPLY_IGNORENOOP
.Fd #define SQLITE_CHANGESETAPPLY_FKNOACTION
.Sh DESCRIPTION
The following flags may passed via the 9th parameter to sqlite3changeset_apply_v2
and sqlite3changeset_apply_v2_strm:
.Bl -tag -width Ds
.It SQLITE_CHANGESETAPPLY_NOSAVEPOINT
Usually, the sessions module encloses all operations performed by a
single call to apply_v2() or apply_v2_strm() in a SAVEPOINT.
The SAVEPOINT is committed if the changeset or patchset is successfully
applied, or rolled back if an error occurs.
Specifying this flag causes the sessions module to omit this savepoint.
In this case, if the caller has an open transaction or savepoint when
apply_v2() is called, it may revert the partially applied changeset
by rolling it back.
.It SQLITE_CHANGESETAPPLY_INVERT
Invert the changeset before applying it.
This is equivalent to inverting a changeset using sqlite3changeset_invert()
before applying it.
It is an error to specify this flag with a patchset.
.It SQLITE_CHANGESETAPPLY_IGNORENOOP
Do not invoke the conflict handler callback for any changes that would
not actually modify the database even if they were applied.
Specifically, this means that the conflict handler is not invoked for:
.Bl -bullet
.It
a delete change if the row being deleted cannot be found,
.It
an update change if the modified fields are already set to their new
values in the conflicting row, or
.It
an insert change if all fields of the conflicting row match the row
being inserted.
.El
.Pp
.It SQLITE_CHANGESETAPPLY_FKNOACTION
If this flag it set, then all foreign key constraints in the target
database behave as if they were declared with "ON UPDATE NO ACTION
ON DELETE NO ACTION", even if they are actually CASCADE, RESTRICT,
SET NULL or SET DEFAULT.
.Sh IMPLEMENTATION NOTES
These declarations were extracted from the
interface documentation at line 12211.
.Bd -literal
#define SQLITE_CHANGESETAPPLY_NOSAVEPOINT   0x0001
#define SQLITE_CHANGESETAPPLY_INVERT        0x0002
#define SQLITE_CHANGESETAPPLY_IGNORENOOP    0x0004
#define SQLITE_CHANGESETAPPLY_FKNOACTION    0x0008
.Ed
.Sh SEE ALSO
.Xr sqlite3changeset_apply 3 ,
.Xr sqlite3changeset_apply_strm 3