Skip to content
A type-safe, Swift-language layer over SQLite3.
Swift Objective-C Ruby Other
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github WS Sep 29, 2017
Documentation Add missing parenthesis May 22, 2019
SQLite.playground Connection#pluck can throw Oct 20, 2016
SQLite.xcodeproj Rename SQLite-Bridging.m -> SQLiteObjc.m May 30, 2019
Sources version bump Jun 21, 2019
.cocoadocs.yml Add config file for CocoaDocs Nov 12, 2016
.gitignore Absolute path Dec 20, 2016
.swift-version Swift 4.2, Xcode 10.1 Dec 19, 2018
.travis.yml Updated to Swift 5 Apr 19, 2019 Swift 4.2, Xcode 10.1 Dec 19, 2018 Documentation Apr 22, 2019
LICENSE.txt 2015: The year of header cleanup Feb 5, 2015
Makefile Updated iOS simulator to iPhone XS Apr 19, 2019
Package.swift Changed language versions array to contain Ints to try and get CI wor… Apr 22, 2019 Updated version in README and Documentation Apr 24, 2019
SQLite.swift.podspec version bump Jun 21, 2019 Set iOS version Jun 16, 2017


Build Status CocoaPods Version Swift5 compatible Platform Carthage compatible Join the chat at

A type-safe, Swift-language layer over SQLite3.

SQLite.swift provides compile-time confidence in SQL statement syntax and intent.


  • A pure-Swift interface
  • A type-safe, optional-aware SQL expression builder
  • A flexible, chainable, lazy-executing query layer
  • Automatically-typed data access
  • A lightweight, uncomplicated query and parameter binding interface
  • Developer-friendly error handling and debugging
  • Full-text search support
  • Well-documented
  • Extensively tested
  • SQLCipher support via CocoaPods
  • Active support at StackOverflow, and Gitter Chat Room (experimental)


import SQLite

let db = try Connection("path/to/db.sqlite3")

let users = Table("users")
let id = Expression<Int64>("id")
let name = Expression<String?>("name")
let email = Expression<String>("email")

try { t in
    t.column(id, primaryKey: true)
    t.column(email, unique: true)
// CREATE TABLE "users" (
//     "name" TEXT,
//     "email" TEXT NOT NULL UNIQUE
// )

let insert = users.insert(name <- "Alice", email <- "")
let rowid = try
// INSERT INTO "users" ("name", "email") VALUES ('Alice', '')

for user in try db.prepare(users) {
    print("id: \(user[id]), name: \(user[name]), email: \(user[email])")
    // id: 1, name: Optional("Alice"), email:
// SELECT * FROM "users"

let alice = users.filter(id == rowid)

try <- email.replace("", with: "")))
// UPDATE "users" SET "email" = replace("email", '', '')
// WHERE ("id" = 1)

// DELETE FROM "users" WHERE ("id" = 1)

try db.scalar(users.count) // 0
// SELECT count(*) FROM "users"

SQLite.swift also works as a lightweight, Swift-friendly wrapper over the C API.

let stmt = try db.prepare("INSERT INTO users (email) VALUES (?)")
for email in ["", ""] {

db.totalChanges    // 3
db.changes         // 1
db.lastInsertRowid // 3

for row in try db.prepare("SELECT id, email FROM users") {
    print("id: \(row[0]), email: \(row[1])")
    // id: Optional(2), email: Optional("")
    // id: Optional(3), email: Optional("")

try db.scalar("SELECT count(*) FROM users") // 2

Read the documentation or explore more, interactively, from the Xcode project’s playground.

SQLite.playground Screen Shot

For a more comprehensive example, see this article and the companion repository.


Note: Version 0.12 requires Swift 5 (and Xcode 10.2) or greater. Version 0.11.6 requires Swift 4.2 (and Xcode 10.1) or greater.


Carthage is a simple, decentralized dependency manager for Cocoa. To install SQLite.swift with Carthage:

  1. Make sure Carthage is installed.

  2. Update your Cartfile to include the following:

    github "stephencelis/SQLite.swift" ~> 0.12.0
  3. Run carthage update and add the appropriate framework.


CocoaPods is a dependency manager for Cocoa projects. To install SQLite.swift with CocoaPods:

  1. Make sure CocoaPods is installed. (SQLite.swift requires version 1.6.1 or greater.)

    # Using the default Ruby install will require you to use sudo when
    # installing and updating gems.
    [sudo] gem install cocoapods
  2. Update your Podfile to include the following:

    target 'YourAppTargetName' do
        pod 'SQLite.swift', '~> 0.12.0'
  3. Run pod install --repo-update.

Swift Package Manager

The Swift Package Manager is a tool for managing the distribution of Swift code.

  1. Add the following to your Package.swift file:
dependencies: [
    .package(url: "", from: "0.12.0")
  1. Build your project:
$ swift build


To install SQLite.swift as an Xcode sub-project:

  1. Drag the SQLite.xcodeproj file into your own project. (Submodule, clone, or download the project first.)

    Installation Screen Shot

  2. In your target’s General tab, click the + button under Linked Frameworks and Libraries.

  3. Select the appropriate SQLite.framework for your platform.

  4. Add.

Some additional steps are required to install the application on an actual device:

  1. In the General tab, click the + button under Embedded Binaries.

  2. Select the appropriate SQLite.framework for your platform.

  3. Add.


See the planning document for a roadmap and existing feature requests.

Read the contributing guidelines. The TL;DR (but please; R):



SQLite.swift is available under the MIT license. See the LICENSE file for more information.


These projects enhance or use SQLite.swift:


Looking for something else? Try another Swift wrapper (or FMDB):

You can’t perform that action at this time.