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

12.6 KB
Raw Blame

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 резервних корака:

  1. Уграђени better-sqlite3 (путем dependencies у package.json) — најбржи, изворна бинарна датотека, инсталира га npm install када су присутни алати за изградњу.

  2. better-sqlite3 инсталиран током извршавања (у ~/.omniroute/runtime/) — инсталира се по потреби при првом покретању ИЛИ путем scripts/build/postinstall.mjs → scripts/postinstall.mjs. Пре учитавања проверава магичне бајтове изворне .node датотеке (ELF / Mach-O / PE) ради заштите од оштећених бинарних датотека или оних за погрешну платформу.

  3. node:sqlite (стандардна библиотека Node ≥22.5) — није потребна изворна изградња; користи се када обе путање за better-sqlite3 не успеју. Ограничен скуп функција.

  4. 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 пробе.