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 · 🇰🇭 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 გაშვებისას SQLite-ის დრაივერს 5-საფეხურიანი სარეზერვო ჯაჭვის მეშვეობით განსაზღვრავს:
ჩაშენებული
better-sqlite3(package.json-ისdependencies-ის მეშვეობით) — ყველაზე სწრაფი, ნატიური ბინარული ფაილი, რომელსაც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
ბაიტს და ცნობილ პლატფორმათა მაგიურ მნიშვნელობებს ადარებს:
| პლატფორმა | ბაიტები (hex) | ჭდე |
|---|---|---|
| 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
# შესრულების დროის 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-ს, დაკავშირებულ მნიშვნელობებს, სტრიქონებს, ბილიკებს ან გამონაკლისის ტექსტს.
ეს არის დიაგნოსტიკური დამხმარე საშუალება და არა დროის ლიმიტი ან მოთხოვნის ოპტიმიზაცია. ის ვერ შეატყობინებს ოპერაციის შესახებ, რომელიც არასდროს სრულდება, ვერ განასხვავებს CPU-ის სამუშაოს დისკის ლოდინისგან, ვერ განსაზღვრავს ზუსტ 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-ის ინსტალაციის შემდგომი ჰუკი (არაფატალური წინასწარი მომზადება)src/lib/db/core.ts—ensureDbInitialized()/getDriverInfo()ექსპორტები
ერთი ჩამწერის ტოპოლოგია (HA არ არის მხარდაჭერილი)
ზემოთ აღწერილი დრაივერების სარეზერვო ჯაჭვი კვლავ ერთ პროცესში მუშაობს. ნაგულისხმევი SQLite OmniRoute არის ერთი ჩამწერი:
- არ დაუკავშიროთ OmniRoute-ის ორი რეპლიკა ერთსა და იმავე
storage.sqliteფაილს. - კონტეინერის ხელახლა გაშვება, Recreate განთავსება, OOM-ით დასრულება ან HEALTHCHECK-ით ხელახლა გაშვება წყვეტს ყველა მიმდინარე SSE სესიას. სტანდარტულ გზაზე სესიების ეტაპობრივი დაცლა არ ხდება.
- ორკესტრატორის სიცოცხლისუნარიანობის შემოწმება, რომელიც ნელ
/healthz-ს გათიშულად მიიჩნევს, ერთადერთ რეპლიკას გააჩერებს. უპირატესობა მიანიჭეთ TCP სიცოცხლისუნარიანობას + HTTP/healthzმზადყოფნას. იხილეთ Docker-ის სახელმძღვანელო — ხელმისაწვდომობა და Kubernetes-ის შემოწმებების რეკომენდაციები.