// 괴짜들을 위해

실제로 내부에서 무엇이 실행되고 있는지

여기부터는 마케팅 미사여구가 없습니다. 활발히 개발 중이고 이 사이트의 모든 스크린샷이 나온 바로 그 SQLly GPUI 클라이언트의 실제 아키텍처입니다 - 크레이트, 데이터 구조, 설계 결정까지.

// 프론트엔드

GPU로 렌더링된 네이티브 UI, 웹뷰가 아님

지금 보고 있는 창은 Electron도 아니고, 네이티브처럼 보이는 스킨을 입은 브라우저 엔진도 아닙니다.

SQLly - GPUI 에디터
GPUI를 통해 네이티브로 렌더링된 SQLly 편집기에서 IntelliSense 키워드 자동 완성을 보여줍니다

여기의 모든 픽셀 - 텍스트 레이아웃, 자동 완성 팝업, 구문 강조 - 는 GPUI 자체의 GPU 가속 렌더러가 그립니다.

🖼️
gpui ✓ 작동함

Zed와 동일한 렌더링 방식

SQLly의 클라이언트는 Zed 편집기를 위해 만들어진 Rust UI 프레임워크인 GPUI 위에 구축되었습니다. GPUI는 유지 모드와 즉시 모드를 결합한 GPU 가속 툴킷으로, DOM도 아니고 그 아래에 AppKit 뷰가 있는 것도 아니며, Rust가 GPU에 직접 그리는 방식입니다.

🧩
sqlly-datatable ✓ 작동함

결과 그리드는 독립된 크레이트입니다

그리드 가상화를 인라인으로 직접 만드는 대신, 결과 그리드는 별도로 배포하는 전용 crate를 사용합니다 - sqlly-datatable - 가상화, 선택, 정렬, 필터링을 독립 컴포넌트 하나로 처리합니다.

🖥️
하나의 코드베이스, 세 개의 OS ✓ 작동함

하나의 소스 트리에서 macOS, Windows, Linux를 모두

GPUI 클라이언트는 같은 Rust 코드베이스로 세 가지 데스크톱 플랫폼을 모두 지원하며, OS별 패키징을 제공합니다: .app 번들은 macOS(Apple Silicon 전용)용이고, .desktop 엔트리는 Linux에서, 그리고 네이티브 .exe Windows에서는 네이티브입니다.

// 오픈 소스, 브라우저에서 실행

사용해 보기 sqlly-datatable - 실제 결과 그리드입니다. WebAssembly로

결과 그리드는 독자적인 오픈 소스 크레이트이고, 샘플 앱은 GPUI의 웹 백엔드에서 WebAssembly로 컴파일됩니다 - 데스크톱 앱과 같은 GPU 렌더러가 그려 주며, 스크린샷이 아니라 진짜 컴포넌트가 WebGPU 캔버스에서 돌아갑니다. 이 라이브 빌드는 이제 문서에서 호스팅하는데, 열 때만 로드되고 떠나는 순간 내려가므로 WebAssembly 페이로드가 백그라운드에 놀지 않습니다.

WebGPU 지원 브라우저 필요 (Chrome/Edge 113 이상 또는 최신 Safari/Firefox). 모든 실행은 사용자 기기에서 이루어지며 어디로도 전송되지 않습니다.

// SQL을 제대로 파싱

두 개의 렉서, 방언을 인식하는 파서, 원본 범위를 그대로 보존하는 트리

SQL은 하나의 언어가 아닙니다. T-SQL, Postgres, MySQL, Oracle, SQLite, ClickHouse, DuckDB는 따옴표 규칙과 주석, 절반 정도의 구문까지 서로 다릅니다 — Redis는 아예 SQL이 아니고요 — 그래서 파이프라인의 앞단에서는 방언을 나중에 붙이는 부가 요소가 아니라 일급 매개변수로 다룹니다.

🔤
sqlly-sqllex ✓ 작동함

방언-테이블 기반 렉서

인용 스타일, 주석 문법, 연산자 집합 같은 토큰화 규칙은 하드코딩된 분기 대신 방언별 테이블로 구동되므로, 방언을 추가하거나 바로잡을 때 렉서를 따로 만들 필요가 없습니다.

🌳
sqlly-sqlparse ✓ 작동함

방언별 오류 복구 파서

지원되는 각 방언은 자체 복구 파서를 가지며, 소스 텍스트의 범위를 충실히 유지합니다 - 즉, 파싱된 트리가 정확한 소스 위치를 유지하므로, 쿼리 주변이 잘못되었더라도 IntelliSense와 진단 기능이 정확한 문자 위치를 가리킬 수 있습니다.

🧭
sqlly-tokenizer ✓ 작동함

일부러 둔 두 번째, 더 빠른 스캐너

별도의 단일 패스 토크나이저가 파일시스템 오버레이 객체 모델을 구동합니다(아래 참조). 이는 전체 렉서/파서 스택보다 의도적으로 더 단순하고 빠른데, 그 이유는 사용자가 실제로 편집하고 있는 쿼리뿐만 아니라 스키마-코드 저장소의 모든 파일을 대상으로 실행되기 때문입니다.

📡
sqlly-lsp ✓ 작동함

진짜 T-SQL 언어 서버

파서 스택 위에는 JSON-RPC/stdio로 동작하는 제대로 된 LSP 구현이 얹혀 있습니다 - 호버, 진단, 시맨틱 토큰, 자동 완성까지 - 에디터를 움직이는 지능을 LSP를 말하는 클라이언트라면 무엇이든 쓸 수 있습니다.

// 스키마 모델 엔진

두 개의 수집기, 하나의 원자적 스냅샷

이 부분은 DBA 가이드에서 '로컬 파일이 라이브 데이터베이스보다 우선할 수 있다'는 트릭을 실제로 작동하게 하고 빠르게 유지되도록 만드는 부분입니다.

// conceptual shape, not literal source
generation += 1;
let db_task   = spawn(collect_from_database(generation));
let fs_task   = spawn(collect_from_filesystem(generation));
let (db, fs)  = join(db_task, fs_task).await;
let merged    = merge_by_provenance(db, fs);  // newer mtime/hash wins
snapshot.swap(merged);  // atomic - readers never see a half-built model
🔀
병렬 수집 ✓ 작동함

데이터베이스와 파일 시스템을 동시에 수집

sqlly-modelengine 데이터베이스 수집기와 파일시스템 수집기를 병렬로 돌리고 각각에 세대 카운터를 붙인 다음, 아래 단계로 결과가 넘어가기 전에 배리어 병합으로 다시 합칩니다.

⏳
타임스탬프 + 해시 기반 오래됨 판정 ✓ 작동함

신선도는 가정하지 않고 측정합니다

병합은 라이브 데이터베이스가 보고하는 내용과 디스크에 있는 내용의 수정 시간과 콘텐츠 해시를 비교하므로, 로컬 파일은 단순히 존재한다고 해서 데이터베이스를 덮어쓰지 않고 실제로 더 최신일 때만 덮어씁니다.

📸
세대 단위 스테이징 스냅샷 ✓ 작동함

읽는 쪽에서는 일관성이 깨진 모델을 절대 보지 않습니다

병합된 모델은 세대(generation) 단위로 하나의 원자적 스냅샷으로 교체됩니다. IntelliSense와 검증은 항상 완전하고 내부적으로 일관된 모델을 읽습니다. 이전 세대이거나 새 세대 중 하나이며, 다시 빌드 중인 부분 상태를 읽는 일은 없습니다.

🌫️
불완전한 영역 ✓ 작동함

신뢰도는 추측이 아니라 데이터로 추적됩니다

모델이 완전히 검증할 수 없는 부분 — 대략 그려진 DDL 스케치, 편집 중인 마이그레이션 — 에는 엔진이 명시적인 Provenance 그리고 Fidelity 메타데이터를 받아 별도의 두 범위 검증 경로로 자동 완성을 수행하며, 추측을 조용히 사실로 끌어올리지 않습니다.

// 온디바이스 AI 스택

클라우드를 옵트인 폴백으로 지원하는 로컬 모델 추론

AI 스토리는 실제로 여러 겹으로 쌓여 있습니다 - 완전한 로컬 추론부터 직접 선택한 클라우드 공급자까지. GPUI 클라이언트에서 지금 실제로 동작하는 것들을, 무엇이 진짜인지 분명히 표시해서 소개합니다.

⚡
fim 자동 완성 ◐ 진행 중

중간 채우기 자동완성

코드 스타일 FIM 완성은 입력하는 동안 인라인 제안을 주는 소형 로컬 모델(Qwen2.5-Coder급)을 상대로 실행하도록 설계되었습니다. 프롬프트 렌더링, 모델/토큰 카탈로그, 환경 설정은 모두 이식되어 단위 테스트를 마쳤고, 아직 마무리 중인 부분은 스트리밍 생성 전송입니다.

🗣️
AI 채팅 패널 ◐ 진행 중

제대로 된 아키텍처를 갖춘 어시스턴트 패널

AI 패널은 포팅된 구조화된 채팅 화면으로, 스텁이 아닙니다. 스키마에 대해 질문하면 생성된 SQL을 돌려받을 수 있습니다. 패널과 그 상태는 진짜이며, 그 뒤의 공급자 연결 배관은 지금 잇는 중입니다.

🦙
ollama ◐ 진행 중

Ollama로 직접 준비한 로컬 모델 사용

이미 Ollama로 모델을 돌리고 있다면 SQLly가 바로 연결되어 스키마 Q&A, 임베딩, 검색에 씁니다. 상태 확인·설치 상태 머신은 포팅되어 UI를 구동하고, 찾아 실행하는 프로세스 관리 계층도 마찬가지입니다. ollama 마무리되고 있습니다.

🧭
sqlly-mlx ◐ 진행 중

Apple Silicon용 MLX 사이드카

Apple Silicon에서의 로컬 추론은 SQLly가 HTTP를 통해 통신하는 작은 외부 MLX 사이드카 프로세스를 통해 실행되며, 무거운 ML 런타임을 메인 앱 프로세스에서 분리합니다. 값 타입과 상태 보고 기능은 포함되어 있으며, 사이드카를 시작하고 관리하는 작업은 진행 중입니다.

🗃️
로컬 벡터 캐시 ○ 계획된

온디바이스 벡터 검색(LanceDB)

이 계획은 LanceDB를 통한 스키마/임베딩 검색용 완전 로컬 벡터 스토어입니다. 현재 그 크레이트는 의도된 스텁입니다 - 모든 호출이 조용히 무시되는 대신 명확하고 정직한 오류를 돌려 줍니다 - 나머지 파이프라인은 그 주변으로 완성되어 있습니다.

☁️
클라우드 폴백 ◐ 진행 중

클라우드 공급자, 옵트인이며 명시적

디바이스 내 모델을 벗어나려 선택할 때, 클라우드 공급자 선택기(OpenRouter, OpenAI, Claude)와 그 환경 설정 창이 준비되어 있습니다 - 사용자가 스스로 지정하지 않는 한 아무 것도 기기를 떠나지 않습니다. 선택기 뒤의 HTTP 전송이 연결되고 있습니다.

왜 아직 끝내지 못한 부분을 굳이 밝히나요? 다른 방법은, 누군가 소스를 읽는 순간 조용히 거짓이 되어버리는 기능 페이지일 뿐입니다. 예를 들어 모델 선택기 UI는 오늘날 GPUI보다 레거시 Swift 앱 쪽이 더 앞서 있습니다 - 여러분이 발견하게 두기보다 우리가 먼저 말하는 편을 택합니다.
// 엔진의 나머지 모든 것

그 밖의 Rust 워크스페이스

엔진은 하나의 모놀리스가 아니라 목적이 분명한 크레이트들로 나뉘어 있고, 대부분은 헤드리스로 쓸 수 있습니다. 그 창구는 sqlly-cli UI 없이 스크립트를 돌리거나 테스트할 때는.

크레이트담당 영역
sqlly-core연결 프로필, 명령/이벤트 모델, 세션, 앱 환경 설정, 충돌 복구 스냅샷.
sqlly-engines하나의 전송 트레이트 아래에 있는 네이티브 드라이버들: TDS 기반 SQL Server(Tiberius), PostgreSQL, MySQL/MariaDB, SQLite, Hrana 기반 libSQL/Turso, 인프로세스 DuckDB, HTTP 기반 ClickHouse, Instant Client를 통한 Oracle, RESP 기반 Redis.
sqlly-query쿼리 실행/스트리밍, IntelliSense 자동 완성 인프라, 쿼리 기록, 토크나이저 연결.
sqlly-metadata객체 탐색기 및 카탈로그 메타데이터 모델.
sqlly-scripting식별자 따옴표 처리, 스크립트 생성, 그리고 탐색 가능한 스크립트 템플릿 카탈로그.
sqlly-plans실행 계획(ShowPlan XML) 파싱 및 계획 경고.
sqlly-admin백업/복원, 활동 모니터, 테이블 편집, 쿼리 스토어, 확장 이벤트, 가져오기/내보내기, 스키마 비교, 디자이너 SQL 생성.
sqlly-securitySQL 및 Entra 인증 공급자, 비밀 저장소 추상화, 보안 카탈로그 SQL.
sqlly-catalog객체 "카드", 스키마 전반의 하이브리드 전체 텍스트 + 벡터 검색, AI 캐시 무효화.
sqlly-testkit워크스페이스 자체 테스트 스위트 전반에서 쓰이는 SQL Server 컨테이너와 픽스처/골든 파일 테스트 헬퍼.
📝
템플릿 ✓ 작동함

진짜 스크립트 템플릿 카탈로그

템플릿 시스템은 동일한 <name,type,default> 자리 표시자 구문 SSMS 템플릿은 - 처음부터 새로 배워야 하는 낯선 DSL이 아니라, 의도적으로 익숙한 문법을 씁니다.

🔬
split_statements ✓ 작동함

배치 스크립트, 한 번에 한 명령문씩

렉서는 변경 검토 경로가 쓰는 문 분할기를 노출하므로, 여러 문짜리 스크립트를 불투명한 덩어리 하나가 아니라 문 하나하나로 추론하고 안전 검사할 수 있습니다.

// 빠르기만 한 게 아니라 검증됨

성능 주장은 테스트 스위트가 뒷받침합니다

✅
✓ 작동함

자동 완성 지연 시간 예산 테스트

IntelliSense 크레이트에는 캐시된 완성이 명시적인 지연 시간 예산 안에 머무는지 검증하는 테스트가 있습니다 - 완성 경로의 성능이 퇴보하면 CI가 실패하지, 몇 달 뒤에야 사용자가 알아차리는 식으로는 안 됩니다.

✅
✓ 작동함

실제 하위 프로세스 통합 테스트

단위 테스트를 넘어, CLI 엔진은 실제 환경 변수를 설정하고 연관 로그를 검증하는 실제 서브프로세스 통합 테스트로 실행됩니다 - 여기에는 핑/응답 상관 관계, 응답 없는 요청 감지, 그리고 정상 종료 로그 다듬기가 포함됩니다.

✅
✓ 작동함

실제 SQL Server에 대한 골든 파일 픽스처

sqlly-testkit 실제 SQL Server 컨테이너를 통합 테스트 용도로 실행하여 쿼리 및 메타데이터 계층이 단순히 모의 응답이 아니라 실제 엔진을 대상으로 테스트되도록 합니다.

그것으로 투어가 끝납니다.

여기서 소스와 어긋난 부분을 발견하면 알려 주세요. 코드베이스는 빠르게 변하니까요. 페이지가 조용히 낡아 가도록 두는 것보다 고치는 편이 낫습니다.