]> git.ipfire.org Git - thirdparty/sqlite.git/commitdiff
Updates to the shared_schema.md notes document.
authordrh <drh@noemail.net>
Mon, 3 Jun 2019 14:02:58 +0000 (14:02 +0000)
committerdrh <drh@noemail.net>
Mon, 3 Jun 2019 14:02:58 +0000 (14:02 +0000)
FossilOrigin-Name: 51af2ade8eddae16a7290ab9676bcb4a677f0be72959640d0b664966398d8319

doc/shared_schema.md
manifest
manifest.uuid

index a8a7d32a35273f1899f7ff32b658bd7ef2ae2957..4b9c2f3c2632d9085856a16ff225ff583ac61b8b 100644 (file)
@@ -2,12 +2,19 @@
 Shared-Schema Mode Notes
 ========================
 
-This branch contains a patch to allow SQLite connections to share schemas
+The [reuse-schema](/timeline?r=reuse-schema) branch contains changes 
+to allow SQLite connections to share schemas
 between database connections within the same process in order to save memory.
 Schemas may be shared between multiple databases attached to the same or
 distinct connection handles.
 
-To activate shared-schemas, a database connection must be opened using the
+Compile with -DSQLITE\_ENABLE\_SHARED\_SCHEMA in order to enable the
+shared-schema enhancement.  Enabling the shared-schema enhancement causes
+approximately a 0.1% increase in CPU cycles consumed and about a 3000-byte
+increase in the size of the library, even if shared-schema is never used.
+
+Assuming the compile-time requirements are satisfied, the shared-schema
+feature is engaged by opening the database connection using the
 sqlite3&#95;open&#95;v2() API with the SQLITE&#95;OPEN&#95;SHARED&#95;SCHEMA
 flag specified.  The main database and any attached databases will then share
 an in-memory Schema object with any other database opened within the process
@@ -42,7 +49,7 @@ the shell tool and the following command issued:
 
         .shared-schema check <database-1> [<database-2>]...
 
-where &lt;database-1;&gt; etc. are replaced with the names of database files
+where &lt;database-1&gt; etc. are replaced with the names of database files
 on disk. For each database specified on the command line, a single line of
 output is produced. If the database can share an in-memory schema with the
 main database opened by the shell tool, the output is of the form:
@@ -133,6 +140,3 @@ Schema (and therefore Table) object may correspond to tables in two or more
 databases attached to a single connection. Instead, all virtual-table handles
 associated with a single database are stored in a linked-list headed at
 Db.pVTable.
-
-
-
index 97d48d16ea517e6d7b483c83af67d86c60f7fd68..27f0fb4fd60040abb7d18731b74acde46d927466 100644 (file)
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C In\sthe\sCLI,\sadd\s".help"\stext\sfor\sthe\s.shared-schema\scommand.
-D 2019-06-03T13:46:50.082
+C Updates\sto\sthe\sshared_schema.md\snotes\sdocument.
+D 2019-06-03T14:02:58.467
 F .fossil-settings/empty-dirs dbb81e8fc0401ac46a1491ab34a7f2c7c0452f2f06b54ebb845d024ca8283ef1
 F .fossil-settings/ignore-glob 35175cdfcf539b2318cb04a9901442804be81cd677d8b889fcc9149c21f239ea
 F LICENSE.md df5091916dbb40e6e9686186587125e1b2ff51f022cc334e886c19a0e9982724
@@ -40,7 +40,7 @@ F contrib/sqlitecon.tcl 210a913ad63f9f991070821e599d600bd913e0ad
 F doc/F2FS.txt c1d4a0ae9711cfe0e1d8b019d154f1c29e0d3abfe820787ba1e9ed7691160fcd
 F doc/lemon.html 24956ab2995e55fe171e55bdd04f22b553957dc8bb43501dbb9311e30187e0d3
 F doc/pager-invariants.txt 27fed9a70ddad2088750c4a2b493b63853da2710
-F doc/shared_schema.md 1d3dee7a9f5a1b360a49c2310cd9ccf3c645be08bbe41ff5c3382455cf2ff981
+F doc/shared_schema.md 759fc374709fccf4e5d2d0cbd05f8fedd38fb022bdd8a6c5b5f492684c7023b9
 F doc/vfs-shm.txt e101f27ea02a8387ce46a05be2b1a902a021d37a
 F ext/README.md fd5f78013b0a2bc6f0067afb19e6ad040e89a10179b4f6f03eee58fac5f169bd
 F ext/async/README.txt e12275968f6fde133a80e04387d0e839b0c51f91
@@ -1836,7 +1836,7 @@ F vsixtest/vsixtest.tcl 6a9a6ab600c25a91a7acc6293828957a386a8a93
 F vsixtest/vsixtest.vcxproj.data 2ed517e100c66dc455b492e1a33350c1b20fbcdc
 F vsixtest/vsixtest.vcxproj.filters 37e51ffedcdb064aad6ff33b6148725226cd608e
 F vsixtest/vsixtest_TemporaryKey.pfx e5b1b036facdb453873e7084e1cae9102ccc67a0
-P 0913ff4dc38290677357885ca40fe19ce45dafea6168a4e7403f0af083a48c65
-R 2bd373ec5652a0b12aeedd89c298473b
+P 3ba6f790e029f8c66b9ba16c657463606e6d45e095a498407154477c1358fbb2
+R 6cab164f64a3a65980b262a81227a6bd
 U drh
-Z 7f03ee7fec2240beefd81d88375683ce
+Z 483621f2246737bf010fcf023cb0e487
index 3c58b4ab67b3e9b1875d5d08faec767ecadfcb79..039c4c173495902a0038ba9c8cff3f9ff7bb6639 100644 (file)
@@ -1 +1 @@
-3ba6f790e029f8c66b9ba16c657463606e6d45e095a498407154477c1358fbb2
\ No newline at end of file
+51af2ade8eddae16a7290ab9676bcb4a677f0be72959640d0b664966398d8319
\ No newline at end of file