No description
Find a file
2023-12-11 19:39:44 -03:00
.circleci CI: Add CircleCI using manastech/crystal@1.0 (#59) 2020-09-30 11:56:46 -03:00
.github/workflows Migrate CI to GitHub Actions (#78) 2022-01-28 15:14:33 -03:00
samples Update crystal-db ~> 0.10.0 and Crystal 0.35.0 for logging support (#58) 2020-09-30 11:34:25 -03:00
spec Update to crystal-db 0.12.0 (refactor connection factory) (#91) 2023-06-23 15:36:08 -03:00
src Bump version to 0.21.0 2023-12-11 19:39:44 -03:00
.gitignore update .gitignore 2016-12-26 10:46:08 -03:00
CHANGELOG.md Bump version to 0.21.0 2023-12-11 19:39:44 -03:00
LICENSE add license 2016-06-24 00:02:44 -03:00
README.md Automatically set PRAGMAs using connection query params (#85) 2023-02-18 17:06:09 -03:00
shard.yml Bump version to 0.21.0 2023-12-11 19:39:44 -03:00

crystal-sqlite3 Build Status

SQLite3 bindings for Crystal.

Check crystal-db for general db driver documentation. crystal-sqlite3 driver is registered under sqlite3:// uri.

Installation

Add this to your application's shard.yml:

dependencies:
  sqlite3:
    github: crystal-lang/crystal-sqlite3

Usage

require "sqlite3"

DB.open "sqlite3://./data.db" do |db|
  db.exec "create table contacts (name text, age integer)"
  db.exec "insert into contacts values (?, ?)", "John Doe", 30

  args = [] of DB::Any
  args << "Sarah"
  args << 33
  db.exec "insert into contacts values (?, ?)", args: args

  puts "max age:"
  puts db.scalar "select max(age) from contacts" # => 33

  puts "contacts:"
  db.query "select name, age from contacts order by age desc" do |rs|
    puts "#{rs.column_name(0)} (#{rs.column_name(1)})"
    # => name (age)
    rs.each do
      puts "#{rs.read(String)} (#{rs.read(Int32)})"
      # => Sarah (33)
      # => John Doe (30)
    end
  end
end

DB::Any

  • Time is implemented as TEXT column using SQLite3::DATE_FORMAT_SUBSECOND format (or SQLite3::DATE_FORMAT_SECOND if the text does not contain a dot).
  • Bool is implemented as INT column mapping 0/1 values.

Setting PRAGMAs

You can adjust certain SQLite3 PRAGMAs automatically when the connection is created by using the query parameters:

require "sqlite3"

DB.open "sqlite3://./data.db?journal_mode=wal&synchronous=normal" do |db|
  # this database now uses WAL journal and normal synchronous mode
  # (defaults were `delete` and `full`, respectively)
end

The following is the list of supported options:

Name Connection key
Busy Timeout busy_timeout
Cache Size cache_size
Foreign Keys foreign_keys
Journal Mode journal_mode
Synchronous synchronous
WAL autocheckoint wal_autocheckpoint

Please note there values passed using these connection keys are passed directly to SQLite3 without check or evaluation. Using incorrect values result in no error by the library.