macOS용 PostgreSQL SQL 도구 Widen

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

Widen은 macOS에서 PostgreSQL 스키마를 탐색하고 자연어 질문을 SQL 초안으로 바꾸는 오픈소스 네이티브 GUI입니다. 클라우드 모드에서는 사용자가 고른 제공업체에 질문과 허용된 스키마 메타데이터를 보내고, 조건을 충족하는 macOS 26+ Apple Silicon에서는 Apple의 온디바이스 Foundation Model을 사용할 수 있습니다. 모든 SQL은 한 문장·허용된 읽기 및 쓰기 유형·차단 목록을 기준으로 결정론적 검증을 거치며, 쓰기는 자동 실행되지 않고 사용자의 확인을 요구합니다. Text-to-SQL은 60개 결과 기반 출시 게이트의 의미 통과율 기준을 현재 충족하지 못해 베타로 남아 있고, PostgreSQL만 지원하며 결과 영속 저장과 SQL 구문 강조 같은 기능에는 제한이 있습니다.

섹션별 상세

Widen은 macOS 14 이상에서 동작하는 오픈소스 네이티브 PostgreSQL GUI이며, 데이터베이스 스키마를 탐색하고 질의 세션을 유지하면서 자연어 질문을 SQL 초안으로 바꿉니다. 사용자가 질문을 입력하면 선택한 백엔드가 허용된 테이블, 열, 자료형, 외래 키와 안전 규칙을 참고해 SQL과 설명, 가정, 참조 테이블, 신뢰도, 위험 수준을 구조화된 형태로 반환합니다. 생성된 문장은 자동 실행되지 않고 사용자가 SQL을 확인하거나 수정한 뒤 실행을 결정하므로, 자율 데이터베이스 에이전트가 아니라 검토 가능한 Text-to-SQL 작업공간에 가깝습니다.

Widen의 macOS 다크 모드 화면에서 자연어 요청과 생성된 PostgreSQL SQL, 데이터베이스 스키마 목록이 함께 표시됩니다. — Screenshot화면 중앙에는 이번 주 벤치마크 레코드를 조회하는 자연어 요청과 SELECT 문이 나타나며, 오른쪽에는 여러 `preseason_` 테이블이 나열되어 있습니다. 자연어 질문을 SQL로 변환한 뒤 사용자가 실행 전에 문장을 확인하는 Widen의 Text-to-SQL 흐름과 스키마 기반 작업공간 구성을 시각적으로 보여줍니다.

Widen은 클라우드와 로컬이라는 두 가지 Text-to-SQL 경로를 제공합니다. 클라우드 모드에서는 사용자가 설정한 제공업체로 질문과 허용된 스키마 메타데이터를 보내며, 새로 설치한 환경은 OpenRouter의 고정된 openai/gpt-5.5 프로필을 기본값으로 사용합니다. macOS 26 이상 Apple Silicon 기기에서 Apple Intelligence를 켜면 Apple의 온디바이스 Foundation Model을 선택할 수 있지만, 작은 컨텍스트 창 때문에 큰 스키마는 테이블 단위로 잘려 전달되므로 단순하고 좁은 요청에 더 적합합니다.

Text-to-SQL 기능은 출시 게이트를 통과하기 전까지 베타 상태로 유지됩니다. 게이트는 고정 모델을 대상으로 한 60개 결과에서 엔드투엔드 의미 통과율 90% 이상, 안전성 유효성 100%, 스키마 유효성 100%, 명확화 결정 정확도 100%, 전송 신뢰성 95% 이상, 반복 수리 실패 0건을 요구하지만 현재 의미 통과율 기준을 충족하지 못했습니다. 평가된 버전이 아닌 모델로 OpenRouter 별칭이 바뀌면 Widen은 검증되지 않은 모델을 조용히 실행하지 않고 클라우드 생성을 실패 처리합니다.

수동 SQL과 모델이 만든 SQL은 동일한 결정론적 안전 검증기를 거칩니다. 한 번에 하나의 문장만 허용하고 SELECT/WITH 읽기 또는 명시적인 INSERT, UPDATE, DELETE 쓰기만 통과시키며 DDL, 트랜잭션 키워드, 세미콜론 연결, pg_sleep, dblink, 대형 객체 호출을 차단합니다. 읽기는 BEGIN READ ONLY 트랜잭션에서 실행되고 쓰기는 일반 트랜잭션에서 실행되며, DELETE와 WHERE 없는 UPDATE에는 별도 확인이 필요하므로 애플리케이션 보호 장치와 PostgreSQL 권한을 함께 사용하는 구성이 권장됩니다.

bash

createdb widen_test
psql -d widen_test -f scripts/sample_db.sql

샘플 PostgreSQL 데이터베이스를 만들고 Widen 저장소의 초기화 SQL을 실행합니다.

sql

CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  email TEXT NOT NULL,
  name TEXT,
  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

CREATE TABLE orders (
  id SERIAL PRIMARY KEY,
  user_id INTEGER NOT NULL REFERENCES users(id),
  total_cents INTEGER NOT NULL,
  status TEXT NOT NULL,
  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

샘플 상점 데이터베이스에서 사용자와 주문 테이블의 구조를 정의합니다.

Widen은 스키마 브라우저와 영속 세션을 데이터베이스 작업의 중심에 둡니다. 오른쪽 인스펙터에서 스키마, 테이블, 열, 자료형, 외래 키를 확인하고, 세션에는 대화 기록과 활성 SQL, 생성 메타데이터를 저장하며 결과 표는 재시작 뒤 다시 쿼리해야 합니다. 읽기 쿼리에 LIMIT이 없으면 기본 행 제한을 적용한 서브쿼리로 감싸고, 실행 결과는 같은 대화 흐름 안의 표 카드로 표시해 SQL과 결과의 연결을 유지합니다.

프로젝트는 MIT 라이선스로 공개되며 macOS용 네이티브 앱으로 빌드됩니다. macOS 14 이상이 기본 요구사항이고 Apple의 로컬 모델에는 macOS 26 이상 Apple Silicon과 Apple Intelligence가 추가로 필요하며, 소스 빌드에는 Xcode 26이 필요합니다. PostgreSQL만 지원하는 초기 MVP라 DataGrip, TablePlus, Postico 수준의 기능 완성도와는 차이가 있고 CSV 내보내기만 제공하며 SQL 구문 강조와 결과 영속 저장은 아직 제한됩니다.

용어 해설

자연어-SQL 변환(Text-to-SQL): — 사용자의 자연어 질문을 데이터베이스 스키마에 맞는 SQL 문으로 변환하는 기술입니다. Widen은 허용된 테이블·열·자료형·외래 키와 안전 규칙을 모델에 전달하고 SQL, 설명, 가정, 참조 테이블, 신뢰도, 위험 수준을 구조화된 결과로 받습니다. 생성된 SQL은 실행 전에 결정론적 검증을 거치므로 데이터베이스 작업에 모델을 직접 연결할 때의 위험을 줄이는 데 중요합니다.
기반 모델(Foundation Model): — 다양한 작업을 수행하도록 학습된 범용 AI 모델을 뜻합니다. Widen은 조건을 충족하는 macOS 26+ Apple Silicon 기기에서 Apple의 온디바이스 Foundation Model을 선택해 자연어 질문을 SQL로 바꿀 수 있도록 합니다. 데이터가 Mac 밖으로 나가지 않는 로컬 처리 경로를 제공하지만 작은 컨텍스트 창 때문에 큰 스키마에는 제약이 있습니다.
읽기 전용 트랜잭션(Read-only Transaction): — 데이터 변경을 허용하지 않는 데이터베이스 트랜잭션 방식입니다. Widen은 읽기 쿼리를 BEGIN READ ONLY 트랜잭션 안에서 실행하고 실행 시 문장 시간 제한과 행 수 제한을 적용합니다. 자연어로 생성한 SQL이나 직접 입력한 SQL이 데이터를 수정하지 못하게 하는 데이터베이스 권한과 함께 방어 계층을 구성합니다.
스키마 스냅샷(Schema Snapshot): — 데이터베이스의 테이블, 열, 자료형, 외래 키 같은 구조 정보를 특정 시점에 저장한 복사본입니다. Widen은 스키마를 schemas.json에 캐시해 재실행 직후 마지막으로 확인한 구조를 표시하고, 사용자가 Refresh Schema를 누르면 실제 데이터베이스에서 최신 구조를 다시 가져옵니다. Text-to-SQL 모델이 참고할 허용 스키마의 범위를 관리하는 기반 정보이기도 합니다.

기술

Widen
PostgreSQL
OpenRouter
openai/gpt-5.5
Apple Foundation Model
Apple Intelligence
macOS
Xcode 26
Sparkle

활용 사례

자연어로 PostgreSQL 데이터 조회
스키마와 외래 키 탐색
SQL 초안 생성 후 수동 검토
데이터베이스별 채팅·SQL·결과 세션 관리
읽기 전용 데이터베이스 작업
상점 샘플 데이터베이스를 이용한 Text-to-SQL 테스트

언급된 리소스

GitHubWiden Releases