Skip to content

Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors

9.6 KB
Raw Blame

SQLite Runtime Resolution (Eesti)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW


OmniRoute tuvastab käivitamisel oma SQLite'i draiveri viieastmelise varuahela kaudu:

  1. Kaasapandud better-sqlite3 (package.json faili dependencies kaudu) — kiireim, kasutab natiivset binaarfaili ja installitakse käsuga npm install, kui kompileerimistööriistad on saadaval.

  2. Käituse ajal installitud better-sqlite3 (asukohas ~/.omniroute/runtime/) — installitakse laisalt esimesel käivitamisel VÕI ahela scripts/build/postinstall.mjs → scripts/postinstall.mjs kaudu. Enne laadimist valideeritakse natiivse .node faili signatuurbaidid (ELF / Mach-O / PE), et kaitsta rikutud või vale platvormi binaarfailide eest.

  3. node:sqlite (Node ≥22.5 standardteek) — natiivset kompileerimist pole vaja; kasutatakse siis, kui mõlemad better-sqlite3 teed ebaõnnestuvad. Piiratud funktsioonide komplekt.

  4. sql.js (WASM) — viimane varuvariant. Töötab kõikjal, kuid on aeglasem ja kirjutab andmeid sünkroonse kirjutamise asemel kindla intervalliga.

Miks selline keerukus?

  • Windowsi EBUSY: npm install -g omniroute@latest võib ebaõnnestuda, kui eelneva versiooni better_sqlite3.node on töötava protsessi poolt lukustatud. Käitusaegne install asukohas ~/.omniroute/runtime/ väldib globaalset npm-i vahemälu.
  • Kompileerimistööriistad puuduvad: mõned keskkonnad (ettevõtte Windows ilma VS Build Toolsita, minimaalsed Dockeri tõmmised) ei suuda paketti better-sqlite3 kompileerida. Käitusaegne installer hangib npm-i registrist eelkompileeritud binaarfaili; varudraiverid tagavad, et OmniRoute käivitub ka siis, kui see ebaõnnestub.
  • Võrgust eraldatud süsteemid: kui npm-i register pole kättesaadav, tagab node:sqlite või sql.js põhifunktsionaalsuse.

Signatuurbaitide valideerimine

Enne käituse ajal installitud .node faili laadimist loeb OmniRoute esimesed 8 baiti ja võrdleb neid teadaolevate platvormisignatuuridega:

Platvorm Baidid (hex) Silt
Linux 7F 45 4C 46 elf
macOS 64-bit BE FE ED FA CF macho
macOS 64-bit LE CF FA ED FE macho-le
macOS fat (universaalne) CA FE BA BE macho-fat
Windows 4D 5A (MZ) pe

Sobimatu signatuur → faili eiratakse ja varuahel jätkub järgmise sammuga.

Aktiivse draiveri kontrollimine

import { getDriverInfo } from "@/lib/db/core";

const info = getDriverInfo();
// { source: "bundled" | "runtime" | "runtime-installed-now" | "node-sqlite" | "sql-js",
//   kind: "better-sqlite3" | "node-sqlite" | "sql-js" }

Käsitsi juhtimine

# Jäta installimisjärgne eellaadimine vahele (kiirete CI-installide jaoks)
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute

# Installi käitusaegne better-sqlite3 sunniviisiliselt uuesti
rm -rf ~/.omniroute/runtime
omniroute  # installitakse järgmisel käivitamisel uuesti

# Kontrolli, milline draiver on aktiivne
omniroute config db-info  # (kui CLI-käsk on olemas)

Sünkroonsete hangumiste diagnoosimine

Paketi better-sqlite3 kasutamisel määra enne käivitamist OMNIROUTE_SQLITE_SLOW_MS=200, et lülitada sisse sünkroonse adapteri ajastuse mõõtmine. Vaikimisi on see välja lülitatud. Lõpetatud toiming, mis kestab vähemalt nii mitu millisekundit, väljastab hoiatuse [SQLITE-SLOW], maksimaalselt üks kord kümne sekundi jooksul adapteri kohta. Hoiatus sisaldab ainult draiverit, toiminguklassi (prepare, get, all, run, exec, pragma, transaktsioon või hooldus) ja kulunud aega millisekundites: see ei sisalda SQL-i, seoseid, ridu, failiteid ega eranditeksti.

See on diagnostiline abivahend, mitte ajalõpp ega päringu optimeerimine. See ei saa teatada toimingust, mis kunagi ei naase, eristada protsessori tööd kettal ootamisest, tuvastada täpset SQL-i ega jälgida töötlemata draiveri pideme kaudu tehtud toiminguid. Asünkroonse varundamise kestus on sihilikult välja jäetud; teised SQLite'i draiverid ei ole selle valikulise funktsiooni kaudu instrumenteeritud. Muutuja keelamine taastab algse adapteri ilma ajastusümbristeta. Andmebaasi skeemi ega salvestatud konfiguratsiooni ei muudeta.

/healthz viivituse hoiatus annab teada sündmusetsükli tipust alates eelmisest mõõtmisest, mitte kogu tööaja keskmisest. Enne hangumise omistamist SQLite'ile või ketta tõrkele kõrvuta selle ajatempleid aeglaste toimingute hoiatuste ning hosti ja andmekandja mõõdikutega.

Viited

Teostus:

  • bin/cli/runtime/magicBytes.mjs — binaarfailide signatuurbaitide valideerimise abifunktsioonid
  • bin/cli/runtime/sqliteRuntime.mjs — viieastmeline käitusaegne tuvastaja + laisk installer
  • bin/cli/runtime/index.mjs — käivitamise orkestreerija (warmUpRuntimes())
  • scripts/postinstall.mjs — npm-i installimisjärgne haak (mittesaatuslik eellaadimine)
  • src/lib/db/core.ts — ensureDbInitialized() / getDriverInfo() ekspordid

Ühe kirjutajaga topoloogia (HA pole toetatud)

Ülaltoodud draiverite varuahel töötab endiselt ühes protsessis. SQLite'i vaikekonfiguratsiooniga OmniRoute kasutab ühte kirjutajat:

  • Ära ühenda kahte OmniRoute'i replikaati sama storage.sqlite failiga.
  • Konteineri taaskäivitamine, Recreate-juurutus, OOM-i tõttu lõpetamine või HEALTHCHECK-i taaskäivitus katkestab kõik pooleliolevad SSE-seansid. Standardlahenduses seansse enne sulgemist ei tühjendata.
  • Orkestraatori elusolekukontroll, mis käsitleb aeglast /healthz vastust tõrkena, lõpetab ainsa replikaadi. Eelista TCP-elusolekukontrolli + HTTP /healthz valmiduskontrolli. Vaata jaotisi Dockeri juhend — käideldavus ja Kubernetese kontrollide soovitused.