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 (Српски)
🌐 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 · 🇸🇰 sk · 🇸🇮 sl · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW
OmniRoute одређује свој SQLite управљачки програм при покретању путем ланца од 5 резервних корака:
Уграђени
better-sqlite3(путемdependenciesуpackage.json) — најбржи, изворна бинарна датотека, инсталира гаnpm installкада су присутни алати за изградњу.better-sqlite3инсталиран током извршавања (у~/.omniroute/runtime/) — инсталира се по потреби при првом покретању ИЛИ путемscripts/build/postinstall.mjs → scripts/postinstall.mjs. Пре учитавања проверава магичне бајтове изворне.nodeдатотеке (ELF / Mach-O / PE) ради заштите од оштећених бинарних датотека или оних за погрешну платформу.node:sqlite(стандардна библиотека Node ≥22.5) — није потребна изворна изградња; користи се када обе путање за better-sqlite3 не успеју. Ограничен скуп функција.sql.js(WASM) — последња резервна опција. Ради свуда, али је спорија и уписује податке у интервалима, уместо синхроно.
Зашто ова сложеност?
- Windows EBUSY:
npm install -g omniroute@latestможе да не успе ако јеbetter_sqlite3.nodeиз претходне верзије закључан од стране активног процеса. Инсталација током извршавања у~/.omniroute/runtime/заобилази глобални npm кеш. - Нема алата за изградњу: Нека окружења (корпоративни Windows без VS Build
Tools, минималне Docker слике) не могу да компајлирају
better-sqlite3. Инсталатер током извршавања преузима унапред изграђену бинарну датотеку из npm регистра; резервни управљачки програми обезбеђују да се OmniRoute ипак покрене чак и ако то не успе. - Изоловани системи без приступа мрежи: Ако npm регистар није доступан,
node:sqliteилиsql.jsгарантују основну функционалност.
Провера магичних бајтова
Пре учитавања .node датотеке инсталиране током извршавања, OmniRoute чита првих 8
бајтова и пореди их са познатим магичним вредностима платформи:
| Платформа | Бајтови (хекс.) | Ознака |
|---|---|---|
| Linux | 7F 45 4C 46 |
elf |
| macOS 64-битни BE | FE ED FA CF |
macho |
| macOS 64-битни LE | CF FA ED FE |
macho-le |
| macOS fat (универзални) | CA FE BA BE |
macho-fat |
| Windows | 4D 5A (MZ) |
pe |
Неподударање магичне вредности → датотека се занемарује, а резервни поступак прелази на следећи корак.
Провера активног управљачког програма
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" }
Ручно управљање
# Прескочите postinstall припрему (за брзе CI инсталације)
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute
# Принудно поново инсталирајте runtime better-sqlite3
rm -rf ~/.omniroute/runtime
omniroute # поново ће се инсталирати при следећем покретању
# Проверите који је управљачки програм активан
omniroute config db-info # (ако CLI команда постоји)
Дијагностиковање синхроних застоја
Када користите better-sqlite3, подесите OMNIROUTE_SQLITE_SLOW_MS=200 пре покретања да бисте
укључили мерење времена синхроног адаптера. Подразумевано је искључено. Завршена операција која траје
најмање толико милисекунди емитује упозорење [SQLITE-SLOW], највише једном у
десет секунди по адаптеру. Упозорење садржи само управљачки програм, класу операције
(prepare, get, all, run, exec, pragma, трансакцију или одржавање) и
протекле милисекунде: без SQL-а, везаних вредности, редова, путања или текста изузетка.
Ово је помоћно средство за дијагностику, а не временско ограничење или оптимизација упита. Оно не може да пријави операцију која се никада не заврши, разликује рад процесора од чекања на диск, идентификује тачан SQL нити прати операције извршене путем непосредног руковаоца управљачког програма. Трајање асинхроног прављења резервне копије намерно је изузето; други SQLite управљачки програми нису инструментисани овом опционом функцијом. Онемогућавањем променљиве враћа се оригинални адаптер без омотача за мерење времена. Нема промена у шеми базе података нити у сачуваној конфигурацији.
Упозорење о кашњењу за /healthz пријављује вршну вредност петље догађаја од претходног узорка,
а не просек током целокупног рада. Упоредите његове временске ознаке са упозорењима о спорим операцијама
и метрикама хоста/складишта пре него што застој припишете SQLite-у или отказу диска.
Референце
Имплементација:
bin/cli/runtime/magicBytes.mjs— помоћне функције за проверу магичних бајтова бинарних датотекаbin/cli/runtime/sqliteRuntime.mjs— разрешавање током извршавања у 5 корака + инсталатер по потребиbin/cli/runtime/index.mjs— оркестратор покретања (warmUpRuntimes())scripts/postinstall.mjs— npm post-install кука (нефатална припрема)src/lib/db/core.ts— извозиensureDbInitialized()/getDriverInfo()
Топологија са једним писцем (HA није подржан)
Наведени ланац резервних управљачких програма и даље се извршава у једном процесу. Подразумевани SQLite у OmniRoute-у има једног писца:
- Немојте повезивати две OmniRoute реплике са истом датотеком
storage.sqlite. - Поновно покретање контејнера, Recreate распоређивање, OOM прекид или HEALTHCHECK поновно покретање прекида сваку активну SSE сесију. На подразумеваној путањи не постоји контролисано завршавање сесија.
- Оркестраторска провера активности која спор
/healthzсматра неактивним прекинуће једину реплику. Дајте предност TCP провери активности + HTTP/healthzпровери спремности. Погледајте Docker водич — доступност и препоруке за Kubernetes пробе.