From 92e4da02d75707ab8efc8b0e08c6f3ee5fb2b1b4 Mon Sep 17 00:00:00 2001 From: Gert-Jan Timmer Date: Sat, 26 May 2018 21:13:26 +0200 Subject: [PATCH] Relocated FAQ item to usage subsection of Features --- README.md | 30 ++++++++++++++++++++---------- 1 file changed, 20 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 6a71218..08b19f9 100644 --- a/README.md +++ b/README.md @@ -40,6 +40,26 @@ This package allows additional configuration of features available within SQLite [Click here for more information about build tags / constraints.](https://golang.org/pkg/go/build/#hdr-Build_Constraints) +### Usage + +If you wish to build this library with additional extensions / features. +Use the following command. + +```bash +go build --tags "" +``` + +For available features see the extension list. +When using multiple build tags, all the different tags should be space delimted. + +Example: + +```bash +go build --tags "icu json1 fts5 secure_delete" +``` + +### Feature / Extension List + | Extension | Build Tag | Description | |-----------|-----------|-------------| | Additional Statistics | sqlite_stat4 | This option adds additional logic to the ANALYZE command and to the query planner that can help SQLite to chose a better query plan under certain situations. The ANALYZE command is enhanced to collect histogram data from all columns of every index and store that data in the sqlite_stat4 table.

The query planner will then use the histogram data to help it make better index choices. The downside of this compile-time option is that it violates the query planner stability guarantee making it more difficult to ensure consistent performance in mass-produced applications.

SQLITE_ENABLE_STAT4 is an enhancement of SQLITE_ENABLE_STAT3. STAT3 only recorded histogram data for the left-most column of each index whereas the STAT4 enhancement records histogram data from all columns of each index.

The SQLITE_ENABLE_STAT3 compile-time option is a no-op and is ignored if the SQLITE_ENABLE_STAT4 compile-time option is used | @@ -68,16 +88,6 @@ This package allows additional configuration of features available within SQLite Use `go build --tags "libsqlite3 darwin"` -- Want to build go-sqlite3 with additional extensions / features. - - Use `go build --tags ""` - - When using multiple build tags, all the different tags should be space delimted. - - For available features / extensions see [Features](#features). - - Example building multiple features: `go build --tags "icu json1 fts5 secure_delete"` - - Can't build go-sqlite3 on windows 64bit. > Probably, you are using go 1.0, go1.0 has a problem when it comes to compiling/linking on windows 64bit.