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
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í:
Pribalený
better-sqlite3(prostredníctvomdependenciesvpackage.json) — najrýchlejší, natívny binárny súbor, nainštalovaný príkazomnpm install, keď sú k dispozícii nástroje na zostavenie.Ovládač
better-sqlite3nainštalovaný za behu (v~/.omniroute/runtime/) — nainštaluje sa odložene pri prvom spustení ALEBO prostredníctvomscripts/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.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í.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@latestmôže zlyhať, ak je súborbetter_sqlite3.nodez 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:sqlitealebosql.jszaruč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úborovbin/cli/runtime/sqliteRuntime.mjs— 5-krokový resolver za behu + odložený inštalátorbin/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— exportyensureDbInitialized()/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ý
/healthzpovaž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.