Turso Quickstart (Swift)

You will need an existing database to continue. If you don’t have one, create one.

Get the database URL:

turso db show --url <database-name>

Get the database authentication token:

turso db tokens create <database-name>

Assign credentials to the environment variables inside .env.

TURSO_DATABASE_URL=
TURSO_AUTH_TOKEN=

First begin by adding libsql as a package dependency in XCode using this repo:

Or add it to your SwiftPM dependencies:

import PackageDescription

let package = Package(
    // ...
    dependencies: [
        .package(url: "https://github.com/tursodatabase/libsql-swift", from: "0.1.1"),
    ],
    // ...
)

You must first create a Database object and then open a Connection to it:

import Libsql

let db = try Database(
    path: "./local.db",
    url: "TURSO_DATABASE_URL",
    authToken: "TURSO_AUTH_TOKEN",
    syncInterval: 300
)

let conn = try db.connect()

import Libsql

let db = try Database(
    path: "./local.db",
)

let conn = try db.connect()

import Libsql

let db = try Database(
    url: "TURSO_DATABASE_URL",
    authToken: "TURSO_AUTH_TOKEN"
)

let conn = try db.connect()

You can execute a SQL query against your existing database by calling query(), or execute() when you expect the query to not yield any rows:

let rows = try conn.query("SELECT * FROM users")

If you need to use placeholders for values, you can do that:

When using embedded replicas you should call sync() on the database type to sync your local database with the primary database, unless you are using sync_interval (though there is no issue with calling sync with sync_interval enabled):

try db.sync()