database/sqlite
1
0
Fork 0
mirror of https://github.com/sqlite/sqlite.git synced 2025-07-30 19:03:16 +03:00
Code Activity

Update the documentation for the new transaction method on the TCL interface. (CVS 2575)

Browse Source 
FossilOrigin-Name: 3dc823a0ac12f640a3c54fe1eb7be878d2738529
This commit is contained in:
drh
2005-08-02 17:38:19 +00:00
parent b5555e7e34
commit 586e4b2f30
3 changed files with 47 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
www/tclsqlite.tcl
View File

@ -1,7 +1,7 @@
#
# Run this Tcl script to generate the tclsqlite.html file.
#
set rcsid {$Id: tclsqlite.tcl,v 1.13 2005/04/03 23:54:45 danielk1977 Exp $}
set rcsid {$Id: tclsqlite.tcl,v 1.14 2005/08/02 17:38:19 drh Exp $}
source common.tcl
header {The Tcl interface to the SQLite library}
proc METHOD {name text} {
@ -72,6 +72,7 @@ foreach m [lsort {
timeout
total_changes
trace
transaction
}] {
puts "<li><a href=\"#$m\">$m</a></li>"
}
@ -230,6 +231,44 @@ since it avoids making a copy of the content of $bigblob.
}
##############################################################################
METHOD transaction {
<p>
The "transaction" method is used to execute a TCL script inside an SQLite
database transaction. The transaction is committed when the script completes,
or it rolls back if the script fails. If the transaction occurs within
another transaction (even one that is started manually using BEGIN) it
is a no-op.
</p>
<p>
The transaction command can be used to group together several SQLite
commands in a safe way. You can always start transactions manually using
BEGIN, of
course. But if an error occurs so that the COMMIT or ROLLBACK are never
run, then the database will remain locked indefinitely. Also, BEGIN
does not nest, so you have to make sure no other transactions are active
before starting a new one. The "transaction" method takes care of
all of these details automatically.
</p>
<p>
The syntax looks like this:
</p>
<blockquote>
<i>dbcmd</i>&nbsp;&nbsp;<b>transaction</b>&nbsp;&nbsp;<i>?transaction-type?</i>
&nbsp;&nbsp;<i>SCRIPT,</i>
</blockquote>
<p>
The <i>transaction-type</i> can be one of <b>deferred</b>,
<b>exclusive</b> or <b>immediate</b>. The default is deferred.
</p>
}
##############################################################################
METHOD complete {