2011-12-03 12:57:40 +00:00
go-sqlite3
==========
2017-03-05 12:05:35 +00:00
[](http://godoc.org/github.com/mattn/go-sqlite3)
2016-01-29 01:28:43 +00:00
[](https://travis-ci.org/mattn/go-sqlite3)
[](https://coveralls.io/r/mattn/go-sqlite3?branch=master)
2017-03-05 12:05:35 +00:00
[](https://goreportcard.com/report/github.com/mattn/go-sqlite3)
2013-05-11 13:01:06 +00:00
2013-09-28 18:55:26 +00:00
Description
2011-12-03 12:57:40 +00:00
-----------
2012-07-08 23:45:22 +00:00
sqlite3 driver conforming to the built-in database/sql interface
2011-12-03 12:57:40 +00:00
2013-09-28 18:55:26 +00:00
Installation
2012-03-29 03:46:32 +00:00
------------
2013-09-03 12:48:14 +00:00
This package can be installed with the go get command:
2012-07-08 23:45:22 +00:00
go get github.com/mattn/go-sqlite3
2013-09-28 18:55:26 +00:00
2015-10-31 06:59:28 +00:00
_go-sqlite3_ is *cgo* package.
If you want to build your app using go-sqlite3, you need gcc.
2015-11-06 14:23:34 +00:00
However, if you install _go-sqlite3_ with `go install github.com/mattn/go-sqlite3` , you don't need gcc to build your app anymore.
2015-10-31 06:59:28 +00:00
2013-09-28 18:55:26 +00:00
Documentation
-------------
API documentation can be found here: http://godoc.org/github.com/mattn/go-sqlite3
Examples can be found under the `./_example` directory
2012-03-29 03:48:11 +00:00
2013-02-13 09:27:35 +00:00
FAQ
---
2015-06-29 23:57:28 +00:00
* Want to build go-sqlite3 with libsqlite3 on my linux.
Use `go build --tags "libsqlite3 linux"`
2016-04-18 12:19:08 +00:00
* Want to build go-sqlite3 with libsqlite3 on OS X.
Install sqlite3 from homebrew: `brew install sqlite3`
2016-04-22 13:13:07 +00:00
2016-04-18 12:19:08 +00:00
Use `go build --tags "libsqlite3 darwin"`
2015-08-20 00:02:59 +00:00
* Want to build go-sqlite3 with icu extension.
Use `go build --tags "icu"`
2017-03-01 21:15:45 +00:00
Available extensions: `json1` , `fts5` , `icu`
2013-02-13 09:38:12 +00:00
* Can't build go-sqlite3 on windows 64bit.
2013-02-13 09:27:35 +00:00
2013-06-18 11:40:15 +00:00
> Probably, you are using go 1.0, go1.0 has a problem when it comes to compiling/linking on windows 64bit.
2017-02-07 07:54:49 +00:00
> See: [#27](https://github.com/mattn/go-sqlite3/issues/27)
2013-02-13 09:27:35 +00:00
2013-02-13 09:38:12 +00:00
* Getting insert error while query is opened.
2013-02-13 09:27:35 +00:00
2013-06-18 11:40:15 +00:00
> You can pass some arguments into the connection string, for example, a URI.
2017-02-07 07:54:49 +00:00
> See: [#39](https://github.com/mattn/go-sqlite3/issues/39)
2013-02-13 09:27:35 +00:00
2016-02-23 06:20:57 +00:00
* Do you want to cross compile? mingw on Linux or Mac?
2014-11-14 10:49:22 +00:00
2017-02-07 07:54:49 +00:00
> See: [#106](https://github.com/mattn/go-sqlite3/issues/106)
2014-11-14 10:50:39 +00:00
> See also: http://www.limitlessfx.com/cross-compile-golang-app-for-windows-from-linux.html
2014-11-14 10:49:22 +00:00
2015-03-04 16:19:33 +00:00
* Want to get time.Time with current locale
Use `loc=auto` in SQLite3 filename schema like `file:foo.db?loc=auto` .
2016-11-07 07:16:17 +00:00
* Can use this in multiple routines concurrently?
2017-02-07 07:54:49 +00:00
Yes for readonly. But, No for writable. See [#50 ](https://github.com/mattn/go-sqlite3/issues/50 ), [#51 ](https://github.com/mattn/go-sqlite3/issues/51 ), [#209 ](https://github.com/mattn/go-sqlite3/issues/209 ).
2016-11-07 07:16:17 +00:00
2017-01-26 21:55:07 +00:00
* Why is it racy if I use a `sql.Open("sqlite", ":memory:")` database?
Each connection to :memory: opens a brand new in-memory sql database, so if
the stdlib's sql engine happens to open another connection and you've only
specified ":memory:", that connection will see a brand new database. A
workaround is to use "file::memory:?mode=memory& cache=shared". Every
connection to this string will point to the same in-memory database. See
2017-02-07 07:54:49 +00:00
[#204 ](https://github.com/mattn/go-sqlite3/issues/204 ) for more info.
2017-01-26 21:55:07 +00:00
2013-09-28 18:55:26 +00:00
License
2011-12-03 12:57:40 +00:00
-------
2012-03-29 03:46:32 +00:00
MIT: http://mattn.mit-license.org/2012
2014-08-18 08:05:50 +00:00
2015-03-11 19:18:10 +00:00
sqlite3-binding.c, sqlite3-binding.h, sqlite3ext.h
The -binding suffix was added to avoid build failures under gccgo.
2014-08-18 08:05:50 +00:00
2016-02-23 06:20:57 +00:00
In this repository, those files are an amalgamation of code that was copied from SQLite3. The license of that code is the same as the license of SQLite3.
2014-08-18 08:05:50 +00:00
Author
------
Yasuhiro Matsumoto (a.k.a mattn)
