Node.js SDK — Database
Full database reference for the server-side SDK.
Methods
// Multiple rows
const { results } = await sdk.db.query<T>(sql, params?)
// Single row (null if not found)
const row = await sdk.db.queryOne<T>(sql, params?)
// DDL / no result needed
await sdk.db.exec(sql)
// Multiple statements in one round-trip (transactional)
const results = await sdk.db.batch(statements)Examples
// SELECT
const { results: users } = await sdk.db.query(
'SELECT id, email, name FROM users WHERE active = 1 ORDER BY created_at DESC LIMIT ?',
[20]
)
// INSERT with RETURNING
const { results: [newUser] } = await sdk.db.query(
'INSERT INTO users (id, email, name, created_at) VALUES (?, ?, ?, ?) RETURNING *',
[crypto.randomUUID(), email, name, Date.now()]
)
// UPDATE
await sdk.db.query(
'UPDATE users SET name = ?, updated_at = ? WHERE id = ?',
[newName, Date.now(), userId]
)
// Batch (all-or-nothing)
await sdk.db.batch([
{ sql: 'INSERT INTO orders ...', params: [...] },
{ sql: 'UPDATE inventory SET stock = stock - 1 ...', params: [...] },
])See Database Features for the full guide.