🇺🇸 Glancer — 레일즈 데이터베이스 질문을 쉬운 말로 물어보세요

Source: Dev.to

Overview

Glancer는 Ruby on Rails 엔진으로, 자연어를 사용해 데이터베이스를 질의할 수 있게 해줍니다. 관련 스키마 컨텍스트를 가져와 SELECT 쿼리(또는 ActiveRecord 표현식)를 생성하고, 이를 안전하게 검증·실행한 뒤, 결과와 사람에게 읽히기 쉬운 설명을 반환합니다.

Example
“지난 30일 동안 주문이 몇 건 있었고, 상태별로 그룹화된 결과는?”
→ SELECT가 실행되고, 결과가 표시되며, 답변이 자연어로 작성됩니다.

Blazer에서 영감을 받은 Glancer는 수동 SQL 작성을 자연어 질문으로 대체합니다.

Installation

# Add to your Gemfile
gem "glancer"

제너레이터를 실행하고 마이그레이션합니다:

rails generate glancer:install
rails db:migrate
rails glancer:index:all

앱에서 /glancer 경로에 접속하면 질문을 시작할 수 있습니다.

Configuration

제너레이터가 초기화 파일을 생성합니다. 여기서 LLM 제공자를 설정합니다. 최소한의 Gemini 설정 예시는 다음과 같습니다:

# config/initializers/glancer.rb
Glancer.configure do |config|
  config.llm_provider   = :gemini
  config.llm_model      = "gemini-2.0-flash"
  config.gemini_api_key = ENV["GEMINI_API_KEY"]

  config.schema_permission = true
end

지원되는 제공자에는 OpenAI, OpenRouter, 그리고 RubyLLM이 지원하는 모든 모델이 포함됩니다. 역할별로 다른 모델을 지정할 수 있습니다(예: 쿼리 생성에는 더 똑똑한 모델, 응답 작성에는 더 저렴한 모델).

Usage

1. 브라우저에서 /glancer를 엽니다.
2. 자연어로 질문을 입력합니다.
3. Glancer가 스키마 컨텍스트를 가져오고, 쿼리를 생성·검증한 뒤 트랜잭션 안에서 실행하고, 결과와 설명을 표시합니다.

Safety

• 모든 쿼리는 항상 롤백되는 트랜잭션 안에서 실행됩니다.
• 키워드 차단 리스트가 DELETE, UPDATE, INSERT, DROP 등과 같은 문장을 실행기까지 도달하기 전에 차단합니다.
• 추가 보호를 위해 Glancer를 읽기 전용 레플리카에 연결할 수 있습니다.

No Extra Infrastructure

임베딩은 기존 데이터베이스의 JSON 컬럼에 저장됩니다—외부 벡터 스토어(Pinecone, Weaviate 등)는 필요하지 않습니다.

Custom Context

config/glancer/llm_context.glancer.md에 마크다운 파일을 추가해 비즈니스 규칙, 상태값, 매출 계산식, 무시할 컬럼 등을 Glancer에게 알려줄 수 있습니다.

- `orders.status` 값: "pending" | "paid" | "shipped" | "refunded"
- 월 매출 = SUM(orders.total) WHERE status = "paid"
- "churn"에 대한 질문이 들어오면 `subscriptions` 테이블의 `churned_at` 컬럼을 사용

UI Features

• 결과가 테이블 형태로 표시되며 원클릭 CSV 내보내기가 가능합니다.
• 적절한 경우 차트가 자동으로 생성됩니다.
• 쿼리는 백그라운드 스레드에서 실행돼 메인 앱 스레드가 자유롭게 유지됩니다.
• @table_name을 입력하면 특정 테이블을 질문에 고정할 수 있습니다.
• 생성된 SQL을 인라인으로 편집하고 다시 실행할 수 있습니다.
• 마이크로 질문을 받아 적을 수 있습니다.
• 스키마 뷰어는 /glancer/db-schema에서 확인할 수 있습니다.

Blazer Integration

이미 Blazer가 설치돼 있다면, Glancer는 생성된 SQL을 바로 Blazer에서 열 수 있는 버튼을 표시합니다.

Contribution & Feedback

Glancer는 스터디 프로젝트로 시작했으며 현재 버전 1.0.0입니다. 이슈와 풀 리퀘스트를 환영합니다. 유용하다고 생각되면 레포지토리에 ⭐를 달아 주세요.

• GitHub:
• RubyGems:**