From 7bea8b5e70badbf849c68199191dbc9bd9da851a Mon Sep 17 00:00:00 2001 From: Peter Wilkinson Date: Wed, 11 Nov 2020 14:43:58 +1100 Subject: [PATCH 1/3] Small warning note on cache settings when using SQLite as a backend --- docs/relstorage-options.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/relstorage-options.rst b/docs/relstorage-options.rst index dcc453d7..45659833 100644 --- a/docs/relstorage-options.rst +++ b/docs/relstorage-options.rst @@ -536,6 +536,9 @@ cache-local-dir performance comes with version 3.15 and the best performance is with 3.24 or higher. + .. warning:: + When using SQLite as a RelStorage backend this setting is ignored. + Deprecated Options ++++++++++++++++++ From 5e3b70414038254c584abc39d586e03f2d97ed60 Mon Sep 17 00:00:00 2001 From: Peter Wilkinson Date: Thu, 12 Nov 2020 11:43:38 +1100 Subject: [PATCH 2/3] Revert "Small warning note on cache settings when using SQLite as a backend" This reverts commit 7bea8b5e70badbf849c68199191dbc9bd9da851a. --- docs/relstorage-options.rst | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/relstorage-options.rst b/docs/relstorage-options.rst index 45659833..dcc453d7 100644 --- a/docs/relstorage-options.rst +++ b/docs/relstorage-options.rst @@ -536,9 +536,6 @@ cache-local-dir performance comes with version 3.15 and the best performance is with 3.24 or higher. - .. warning:: - When using SQLite as a RelStorage backend this setting is ignored. - Deprecated Options ++++++++++++++++++ From 28800c55e9e8b2ccbe3b0537738aa85caa393da5 Mon Sep 17 00:00:00 2001 From: Peter Wilkinson Date: Thu, 12 Nov 2020 11:45:24 +1100 Subject: [PATCH 3/3] Mention cache-local-dir on SQLite options page --- docs/sqlite3/options.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sqlite3/options.rst b/docs/sqlite3/options.rst index 5fd2d956..6d9924a8 100644 --- a/docs/sqlite3/options.rst +++ b/docs/sqlite3/options.rst @@ -15,7 +15,7 @@ because it uses shared memory, those processes *must* all be on the same machine. The database files also should reside locally. Using a persistent cache file is not supported with this driver and -will be automatically disabled. In some cases, it may be advantageous +will be automatically disabled (``cache-local-dir`` has no effect). In some cases, it may be advantageous to also disable RelStorage's in-memory pickle cache altogether (``cache-local-mb 0``) and allow the operating system's filesystem cache to serve that purpose.