본문 바로가기
tool/OrcaSQL

OrcaSQL v0.2.0

tealight 2026. 4. 28. 11:26

OrcaSQL 

OrcaSQL은 Windows 11 및 macOS를 지원하는 MySQL 데스크톱 GUI 클라이언트입니다.
쿼리 편집·결과 그리드 인라인 편집·스키마 관리·SSH 터널을 통합한 Wails v3 기반 네이티브 앱입니다.

소스 코드는 Private 저장소에서 관리됩니다. 이 저장소는 릴리스 바이너리만 제공합니다.

주요 기능

연결 관리

  • 다중 MySQL 연결 동시 운용 (연결 탭)
  • SSH 터널 / HTTP 프록시 경유 연결
  • 연결 그룹화, 색상 태그, 드래그 정렬
  • OS 키체인(Keychain / Credential Manager) 비밀번호 보안 저장
  • 다중 인스턴스 동시 실행 지원

SQL 에디터

  • Monaco 기반 SQL 에디터 (VS Code와 동일한 엔진)
  • DataGrip 스타일 자동완성 — 테이블·컬럼·db.table 형식·별칭 prefix
  • SELECT * 컬럼 목록 자동 확장 Snippet
  • SQL 자동 포맷 (키워드 대소문자·들여쓰기 설정 가능)
  • 다중 쿼리 동시 실행 (세미콜론 구분)
  • 쿼리 실행 취소 (Stop 버튼)
  • Placeholder 모달 — ?param SQL 변수를 입력 폼으로 안전 치환
  • 쿼리 탭 컨텍스트 메뉴 — 새 탭 / 모두 닫기 / 오른쪽 탭 닫기

결과 그리드

  • 인라인 셀 편집 (INSERT / UPDATE / DELETE 자동 생성)
  • 타입별 셀 에디터 — 날짜 DatePicker · Boolean 토글 · Numeric 검증 · ENUM 드롭다운 · SET 멀티셀렉트 · JSON 자동 포맷
  • 신규 행 직접 입력 (INSERT), 명시적 NULL 설정 (Ctrl+0)
  • 헤더에 PRIMARY KEY / UNIQUE / INDEX / FK 뱃지 자동 표시
  • 컬럼 고정 (Freeze) — 스크롤 시 좌측 고정
  • 컬럼 통계 팝오버 — COUNT / NULL 수 / DISTINCT / MIN / MAX / AVG / 상위 빈도값
  • 행 복사 포맷 — TSV / CSV / JSON / INSERT SQL (단일·다중 행)
  • 클라이언트 필터 (결과 내 실시간 검색)

오브젝트 브라우저

  • 데이터베이스·테이블·뷰·프로시저·함수·트리거·사용자 트리
  • 테이블 클릭 → Data / Info 탭 자동 열기
  • 컨텍스트 메뉴 — CREATE / DROP DATABASE, RENAME / COPY TABLE

테이블 디자이너

  • 컬럼 추가·수정·삭제 (데이터 타입, NOT NULL, DEFAULT, AUTO_INCREMENT, CHARSET)
  • 인덱스 관리 (PRIMARY / UNIQUE / INDEX / FULLTEXT)
  • 외래 키(FK) 설정
  • DDL 미리보기 및 실행
  • CREATE 코드 탭 — SHOW CREATE TABLE 결과를 Monaco SQL 하이라이트로 표시 + 클립보드 복사

테이블 데이터 탭

  • 서버 사이드 WHERE 필터, 컬럼 클릭 ORDER BY
  • 페이지네이션 (페이지 번호 직접 입력, First / Last, 25 / 50행 선택)
  • 총 행 수 표시

쿼리 히스토리

  • 일(日)단위 파일 분리, 연결별 필터
  • 성공 / 오류 상태 필터, 실행 시간 정렬
  • 느린 쿼리 색상 강조, SQL 전문 펼치기, 클립보드 복사

SQL 스니펫

  • 에디터 선택 영역 저장, 태그 검색, 커서 위치 삽입

사용자 및 권한 관리

  • GRANT / REVOKE UI, 비밀번호 변경, 계정 잠금 토글

프로세스 리스트

  • SHOW PROCESSLIST 실시간 조회, 쿼리 Kill, 장시간 쿼리 필터

MCP 서버 통합 (AI 클라이언트 연동)

Claude Code · Cursor · Claude Desktop 등 MCP 클라이언트가 OrcaSQL 활성 연결을 통해 DB 질의 가능. 환경설정 → MCP 탭에서 활성화.

  • 127.0.0.1 전용 listen, OS 키체인 보관 Bearer 토큰 인증
  • 5 도구: list_connections / list_databases / list_tables / describe_table / execute_query
  • 권한 게이트 3단계 (read-only 기본 / +쓰기 / +DDL)
  • Connection allowlist (사용자가 노출할 연결 선택)
  • AI 부트스트랩 프롬프트 + 클라이언트 설정 JSON 원클릭 복사
  • 자가 헬스체크 + StatusBar 인디케이터 (재시작·테스트·설정 바로가기)

내보내기

  • CSV, JSON, TSV, Excel(.xlsx), INSERT SQL

UI / UX

  • 다크 모드 / 라이트 모드 전환
  • 한국어 / 영어 UI 전환
  • 메뉴바에 앱 버전 뱃지 표시 (macOS)
  • ESC로 팝업 닫기, 키보드 단축키 설정
  • 패널 크기 자유 조절 (리사이저)
  • macOS 트래픽 라이트 / Windows 타이틀바 네이티브 통합

시스템 요구사항

플랫폼 최소 사양
Windows Windows 10 22H2 이상 (x64)
macOS macOS 10.15 Catalina 이상 (Apple Silicon / Intel 모두 지원)

MySQL 5.7 / 8.0 / 8.4 호환.

설치 방법

Windows

  1. 아래 Assets에서 OrcaSQL-*-Setup.msi 파일을 다운로드합니다.
  2. 설치 파일을 실행하고 화면의 안내를 따릅니다.
  3. 시작 메뉴에서 OrcaSQL을 실행합니다.

macOS

  1. 아래 Assets에서 OrcaSQL.dmg 파일을 다운로드합니다.
  2. DMG 파일을 마운트한 뒤 OrcaSQL.app을 Applications 폴더로 드래그합니다.
  3. "파일이 손상되어 열 수 없습니다" 메시지가 표시되는 경우 — 현재 OrcaSQL은 Apple 코드서명을 적용하지 않아 macOS가 quarantine 속성을 부여하면서 발생하는 현상입니다(파일 자체는 정상). 터미널에서 아래 명령으로 해제할 수 있습니다. 
    xattr -cr /Applications/OrcaSQL.app
    DMG 파일 자체에 경고가 뜨면 다운로드한 DMG에도 동일하게 적용합니다. 
    xattr -cr ~/Downloads/OrcaSQL.dmg
  4. 처음 실행 시 Gatekeeper 경고("확인되지 않은 개발자")가 표시되면 시스템 설정 → 개인정보 및 보안 → "확인 없이 열기" 를 클릭합니다.

GITHUB

https://github.com/chltjdgus/OrcaSQL

라이선스

이 소프트웨어는 프리웨어로 무료 사용이 가능합니다.
재배포·역공학·수정·상업적 이용은 허용되지 않습니다.

이 저장소는 OrcaSQL의 공개 릴리스 전용 저장소입니다. 소스 코드 기여(PR/Issue)는 받지 않습니다.

OrcaSQL-0.2.0-Setup.msi
9.3 MB

저작자표시 (새창열림)

티스토리툴바