Connecting to a Cluster
SQLite databases in SQLite Cloud are distributed across a cluster of nodes. Each cluster comes with a multi-region load balancer that routes traffic to the nearest appropriate node.
Click “Connect” in the bottom left-hand corner of your dashboard to get your connection string to use with a SQLite Cloud client library.
Connecting with JavaScript
Here’s an example of how you can connect to your cluster using the @sqlitecloud/drivers
JavaScript client library:
First, install the client library:
npm install @sqlitecloud/drivers
Then, connect to your cluster using the connection string:
import { Database } from '@sqlitecloud/drivers';
const db = new Database('sqlitecloud://<your-project-id>.sqlite.cloud:<your-host-port>?apikey=<your-api-key>')
const fetchAlbums = async () => await db.sql`USE DATABASE chinook.sqlite; SELECT * FROM albums;`;
fetchAlbums().then((albums) => console.log(albums));
// [{ Title: 'For Those About To Rock We Salute You', ... }, ...]
Connecting with Python
Install the Python client library:
pip install sqlitecloud
Then, connect to your cluster using the connection string:
import sqlitecloud
# Open the connection to SQLite Cloud
# Note: Include your target database in the url to skip the USE DATABASE command
conn = sqlitecloud.connect("sqlitecloud://<your-project-id>.sqlite.cloud:<your-host-port>?apikey=<your-api-key>")
cursor = conn.execute("SELECT * FROM albums WHERE AlbumId = ?", (1, ))
result = cursor.fetchone()
print(result)
conn.close()
# (1, 'For Those About To Rock We Salute You', 1)