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.9 KB
Raw Blame

SQLite Runtime Resolution (Slovenčina)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 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 · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW


OmniRoute vyhľadáva svoj ovládač SQLite pri spustení prostredníctvom 5-krokového reťazca záložných možností:

  1. Pribalený better-sqlite3 (prostredníctvom dependencies v package.json) — najrýchlejší, natívny binárny súbor, nainštalovaný príkazom npm install, keď sú k dispozícii nástroje na zostavenie.

  2. Ovládač better-sqlite3 nainštalovaný za behu (v ~/.omniroute/runtime/) — nainštaluje sa odložene pri prvom spustení ALEBO prostredníctvom scripts/build/postinstall.mjs → scripts/postinstall.mjs. Pred načítaním overuje magické bajty natívneho súboru .node (ELF / Mach-O / PE), aby zabránil načítaniu poškodených binárnych súborov alebo súborov pre nesprávnu platformu.

  3. node:sqlite (štandardná knižnica Node ≥22.5) — nevyžaduje natívne zostavenie; použije sa, keď zlyhajú obe možnosti better-sqlite3. Má obmedzenú množinu funkcií.

  4. sql.js (WASM) — posledná záložná možnosť. Funguje všade, ale je pomalšia a zapisuje údaje v intervaloch, nie synchrónne.

Prečo je to také zložité?

  • Windows EBUSY: npm install -g omniroute@latest môže zlyhať, ak je súbor better_sqlite3.node z predchádzajúcej verzie uzamknutý spusteným procesom. Inštalácia za behu do ~/.omniroute/runtime/ obchádza globálnu vyrovnávaciu pamäť npm.
  • Chýbajúce nástroje na zostavenie: Niektoré prostredia (firemný Windows bez VS Build Tools, minimalistické obrazy Docker) nedokážu skompilovať better-sqlite3. Inštalátor za behu získa vopred zostavený binárny súbor z registra npm; záložné ovládače zabezpečia, že sa OmniRoute spustí aj v prípade, že tento postup zlyhá.
  • Izolované systémy bez prístupu k sieti: Ak register npm nie je dostupný, node:sqlite alebo sql.js zaručia základnú funkčnosť.

Overovanie magických bajtov

Pred načítaním súboru .node nainštalovaného za behu načíta OmniRoute prvých 8 bajtov a porovná ich so známymi magickými hodnotami platforiem:

Platforma Bajty (hex) Označenie
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 (univerzálny) CA FE BA BE macho-fat
Windows 4D 5A (MZ) pe

Nezhodná magická hodnota → súbor sa ignoruje a pokračuje sa ďalším krokom záložného reťazca.

Kontrola aktívneho ovládača

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" }

Manuálne ovládanie

# Preskočenie úvodného načítania po inštalácii (pre rýchle inštalácie CI)
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute

# Vynútená preinštalácia runtime balíka better-sqlite3
rm -rf ~/.omniroute/runtime
omniroute  # preinštaluje sa pri ďalšom spustení

# Kontrola aktívneho ovládača
omniroute config db-info  # (ak príkaz CLI existuje)

Diagnostika synchrónnych pozastavení

Pri použití better-sqlite3 nastavte pred spustením OMNIROUTE_SQLITE_SLOW_MS=200, čím zapnete meranie času synchrónneho adaptéra. Predvolene je vypnuté. Dokončená operácia, ktorá trvá aspoň uvedený počet milisekúnd, vygeneruje upozornenie [SQLITE-SLOW], najviac raz za desať sekúnd pre každý adaptér. Upozornenie obsahuje iba ovládač, triedu operácie (prepare, get, all, run, exec, pragma, transakciu alebo údržbu) a uplynutý čas v milisekundách: neobsahuje SQL, väzby, riadky, cesty ani text výnimky.

Ide o diagnostickú pomôcku, nie o časový limit ani optimalizáciu dotazov. Nedokáže nahlásiť operáciu, ktorá sa nikdy nevráti, rozlíšiť prácu procesora od čakania na disk, identifikovať konkrétny príkaz SQL ani sledovať operácie vykonávané prostredníctvom nespracovaného prístupu k ovládaču. Trvanie asynchrónneho zálohovania je zámerne vylúčené; ostatné ovládače SQLite nie sú týmto voliteľným meraním vybavené. Vypnutím premennej sa obnoví pôvodný adaptér bez meracích obalov. Schéma databázy ani uložená konfigurácia sa nezmenia.

Upozornenie na oneskorenie z /healthz hlási maximálne oneskorenie slučky udalostí od predchádzajúcej vzorky, nie priemer za celú dobu behu. Pred pripísaním pozastavenia databáze SQLite alebo zlyhaniu disku porovnajte jeho časové pečiatky s upozorneniami na pomalé operácie a metrikami hostiteľa či úložiska.

Referencie

Implementácia:

  • bin/cli/runtime/magicBytes.mjs — pomocné funkcie na overovanie magických bajtov binárnych súborov
  • bin/cli/runtime/sqliteRuntime.mjs — 5-krokový resolver za behu + odložený inštalátor
  • bin/cli/runtime/index.mjs — orchestrátor spustenia (warmUpRuntimes())
  • scripts/postinstall.mjs — hook npm po inštalácii (nekritické úvodné načítanie)
  • src/lib/db/core.ts — exporty ensureDbInitialized() / getDriverInfo()

Topológia s jediným zapisujúcim procesom (HA nie je podporovaná)

Vyššie uvedený reťazec záložných ovládačov stále beží v jednom procese. Predvolená konfigurácia SQLite v OmniRoute má jediný zapisujúci proces:

  • Nepripájajte dve repliky OmniRoute k rovnakému súboru storage.sqlite.
  • Reštart kontajnera, nasadenie typu Recreate, ukončenie z dôvodu OOM alebo reštart prostredníctvom HEALTHCHECK ukončí každú prebiehajúcu reláciu SSE. Štandardný postup neposkytuje riadené ukončenie relácií.
  • Kontrola živosti orchestrátora, ktorá pomalý /healthz považuje za nefunkčný stav, ukončí jedinú repliku. Uprednostnite kontrolu živosti cez TCP + kontrolu pripravenosti cez HTTP /healthz. Pozrite si Príručku pre Docker — dostupnosť a odporúčania pre sondy Kubernetes.