Модулі баз даних

Elide надає три модулі SQL:

Модуль	Точка входу	Модель з’єднання
SQLite	`elide:sqlite`	Вбудована й синхронна
PostgreSQL	`elide:postgres`	Мережеве з’єднання та API на основі Promise
MySQL	`elide:mysql`	Мережеве з’єднання та API на основі Promise

Глобального об’єкта Elide.db немає. Імпортуйте потрібний драйвер.

SQLite

import { Database } from "elide:sqlite";

const db = new Database();
try {
  db.exec("CREATE TABLE checks (ok INTEGER)");
  db.exec("INSERT INTO checks VALUES (1)");

  console.log(db.query("SELECT ok FROM checks").get());
  // { ok: 1 }
} finally {
  db.close();
}

new Database() і new Database(":memory:") створюють базу даних у пам’яті. Шлях відкриває базу даних у файлі. Екземпляр надає query, prepare, exec, transaction, loadExtension, serialize і close.

Інструкція (statement) надає all(), values(), get() і run(). Кожен метод приймає позиційні (?, ?1) або іменовані ($name) параметри:

import { Database } from "elide:sqlite";

const db = new Database();
db.exec("CREATE TABLE users (name TEXT, age INTEGER)");
db.prepare("INSERT INTO users VALUES (?, ?)").run("Ada", 36);
db.prepare("INSERT INTO users VALUES ($name, $age)").run({ $name: "Alan", $age: 41 });
console.log(db.prepare("SELECT name FROM users WHERE age > ?").all(40));
// [{name: "Alan"}]
db.close();

Транзакції обгортають синхронну функцію зворотного виклику:

import { Database } from "elide:sqlite";

const db = new Database();
try {
  db.exec("CREATE TABLE checks (ok INTEGER)");
  const insert = db.transaction(() => {
    db.exec("INSERT INTO checks VALUES (1)");
  });

  insert();
  console.log(db.query("SELECT COUNT(*) AS count FROM checks").get());
  // { count: 1 }
} finally {
  db.close();
}

PostgreSQL і MySQL

Обидва мережеві драйвери надають фабрику Database з методом connect:

import { Database } from "elide:postgres";

const db = await Database.connect({
  host: "127.0.0.1",
  port: 5432,
  database: "app",
  user: "app",
  password: process.env.DB_PASSWORD,
});

await db.close();

Для MySQL використовуйте elide:mysql і порт 3306. Об’єкт конфігурації потребує database, user і password. Поведінка з’єднання та запитів потребує запущеного сервера бази даних, і її слід перевіряти з тією версією та конфігурацією сервера, які використовує ваш застосунок.

SQLite

PostgreSQL і MySQL

Див. також