Nexa SQL

v0.7.0

세 OS에서 똑같이 동작하는 경량 SQL 클라이언트(IDE) + CLI nsql — SQL*Plus식 세션 변수를 모든 DBMS에서

사용 설명서 다운로드 GitHub 문서 (Wiki)

모든 데스크톱 OS에서 사용할 수 있어요

Windows설치 방법 ↓
macOS설치 방법 ↓
Linux설치 방법 ↓

10종 드라이버 패키지 (drivers-v0.1.11 · Oracle은 Thin · OCI 2종)
14.3MB Windows x64 MSI 설치본 (v0.7.0 · Oracle OCI 드라이버만 포함)
15개 CLI nsql 명령
173종 객체 탐색기 DBMS 아이콘

설치

Windows

Chocolatey

choco install nexa-sql

최신 0.7.0 승인을 2026-11-07에 확인했습니다(릴리스 당일 승인). 0.2.8 · 0.2.9처럼 건너뛴 버전이 있어 늘 최신이라고 보장하지는 않습니다.

조용한 설치 (MSI)

msiexec /i nexa-sql-0.7.0-windows-x64.msi /qn

GitHub Releases에서 받은 MSI 파일 이름으로 바꿔 실행합니다. 컴퓨터 단위 설치입니다.

winget (등록 전 · 아직 설치 불가)

winget install SosomLab.NexaSQL

첫 제출 PR #447007이 검토 대기 중이라 아직 설치할 수 없습니다(2026-11-07 확인). 지금은 Chocolatey 또는 GitHub Releases MSI를 쓰세요.

GitHub Releases에서 nexa-sql-<버전>-windows-x64.msi를 받아 더블클릭합니다. 설치 중 nsql을 PATH에 추가하는 항목과 .sql 파일 연결(선택)을 고를 수 있습니다.
코드 서명이 없어 SmartScreen이 막으면 추가 정보 → 실행을 누릅니다. 받은 파일은 sha256sums.txt와 Get-FileHash로 대조하세요.
처음 접속할 때 필요한 드라이버를 GitHub에서 받아 설치합니다. 폐쇄망이면 nsql driver install --file nsql-drivers-all-<버전>-windows-x86_64.zip으로 미리 설치하세요.
Oracle은 기본 Thin 드라이버로 Instant Client 없이 접속합니다. 11g 서버처럼 OCI가 필요하면 Oracle Instant Client를 설치하고 설정 ▸ DBMS ▸ Oracle에서 폴더를 지정하거나 NSQL_ORACLE_CLIENT_DIR을 설정합니다.

Windows 10 1809 이상 · x64. winget(SosomLab.NexaSQL)은 아직 등록 전입니다(첫 제출 PR #447007이 0.5.0으로 검토 대기 · 2026-11-07 확인). 제거는 설정 ▸ 앱에서 합니다(설정·프로필은 %APPDATA%\nexa-sql에 남음).

macOS

Homebrew Cask (권장)

brew install --cask kiros33/tap/nexa-sql

설치 때 격리 표식을 떼어 주어 바로 실행되고 nsql도 PATH에 연결됩니다. 탭이 릴리스를 자동 추종하며 0.7.0 반영을 2026-11-07에 확인했습니다. 갱신은 brew upgrade --cask kiros33/tap/nexa-sql.

설치 파일 — nexa-sql-<버전>-macos-universal.pkg를 실행하면 /Applications/Nexa SQL.app과 /usr/local/bin/nsql이 설치됩니다. .dmg는 앱을 응용 프로그램 폴더로 끌어 놓습니다.
직접 받은 앱이 Gatekeeper에 막히면 xattr -dr com.apple.quarantine "/Applications/Nexa SQL.app"을 실행하세요.
제거: sudo "/Applications/Nexa SQL.app/Contents/Resources/uninstall.sh"(Homebrew는 brew uninstall --cask kiros33/tap/nexa-sql).

macOS 11 Big Sur 이상 · Apple Silicon · Intel 공용 Universal. 드라이버는 처음 접속할 때 내려받습니다. 설정·프로필은 ~/Library/Application Support/nexa-sql에 있습니다.

Linux

APT 저장소 등록 — Debian · Ubuntu (최초 1회)

sudo curl -fsSLo /usr/share/keyrings/sosomlab-archive-keyring.gpg https://pkg.sosomlab.com/sosomlab-archive-keyring.gpg
sudo curl -fsSLo /etc/apt/sources.list.d/sosomlab.sources https://pkg.sosomlab.com/apt/sosomlab.sources

SosomLab 서명 패키지 저장소(pkg.sosomlab.com)를 등록합니다. 다른 SosomLab 앱으로 이미 등록했다면 건너뛰세요.

APT로 설치

sudo apt update && sudo apt install nexa-sql

이후 apt upgrade로 새 버전을 받습니다. 저장소에 0.7.0이 있는 것을 2026-11-07에 확인했습니다.

DNF 저장소 등록 — Fedora · RHEL 계열 (최초 1회)

sudo curl -fsSLo /etc/yum.repos.d/sosomlab.repo https://pkg.sosomlab.com/rpm/sosomlab.repo

다른 SosomLab 앱으로 이미 등록했다면 건너뛰세요.

DNF로 설치

sudo dnf install nexa-sql

갱신은 dnf upgrade. 저장소에 0.7.0이 있는 것을 2026-11-07에 확인했습니다.

설치 파일 — sudo apt install ./nexa-sql_<버전>_amd64.deb 또는 sudo dnf install ./nexa-sql-<버전>-1.x86_64.rpm.
제거: sudo dpkg -r nexa-sql 또는 sudo dnf remove nexa-sql(설정·프로필은 ~/.config/nexa-sql에 남음).

x86_64 · glibc 2.34 이상. 한글 표시용 fonts-noto-cjk와 X11/Wayland 라이브러리가 권장 의존으로 함께 설치됩니다. 드라이버는 처음 접속할 때 내려받습니다.

Oracle · SQL Server · PostgreSQL · MySQL/MariaDB · SQLite · DuckDB · IBM Db2 · ClickHouse와 ODBC 소스에 붙는 올 러스트 SQL IDE와 명령줄 도구 nsql. VAR · EXEC :V · SELECT INTO · PRINT · DEFINE 같은 SQL*Plus 스크립트가 다른 DBMS에서도 돌고, 같은 엔진·프로필·설정을 GUI와 CLI가 공유합니다. 드라이버는 처음 접속할 때 서명된 패키지로 설치하고, SSH 터널 · xlsx/parquet 가져오기와 내보내기 · 읽기 전용 프로필까지 담았습니다.

스크린샷

메인 화면 — 객체 탐색기 · 편집기 · 결과 그리드(열 머리 타입 배지 · 조건 바)

주요 기능

SQL*Plus식 세션 변수 VAR · EXEC :V := 값/식 · SELECT … INTO :V · PRINT · DEFINE/&치환 · REF CURSOR · 편집기 안 CONNECT. SQL Server에서도 GO를 넘어 같은 변수를 이어 쓰고, 탭 · 연결 공유 · 글로벌 층과 접속 프로필 변수로 범위를 나눕니다.
폭넓은 DBMS · 드라이버 자동 설치 Oracle(Thin · OCI) · SQL Server · PostgreSQL · MySQL/MariaDB · SQLite · DuckDB · IBM Db2 · ClickHouse · ODBC. 처음 접속할 때 서명된 드라이버 패키지를 받아 SHA-256과 Ed25519로 검증한 뒤 설치하며, 폐쇄망용 오프라인 번들이 있습니다.
SSH 터널 · TLS 모든 접속에 시스템 ssh 포트 포워딩을 붙입니다(키 인증). PostgreSQL TLS는 인증서 사슬과 호스트 이름 검증까지 고를 수 있습니다.
GUI와 CLI가 같은 엔진 화면에서 돌린 스크립트를 nsql run으로 그대로 배치 실행합니다. 연결 프로필 · 설정 · 북마크를 공유하고, 종료 코드(0/1/2)로 CI에서 판정합니다. 대화형 셸에는 기록 찾기와 Tab 완성이 있습니다.
3-OS 동일 화면 올 러스트 + 자체 CPU 래스터라이저. Qt · WebView · Electron 없이 Windows · macOS · Linux에서 같은 화면으로 동작하고, 단축키만 각 OS 관례(Ctrl/⌘)를 따릅니다.
Sublime Text 관습의 편집기 Sublime 기본 단축키 · 사용자 .sublime-keymap · Goto Anything(Ctrl+P) · 명령 팔레트 · 다중 커서 · Insert Sequence · 북마크 · 파일 검색 · 미니맵 · 색 프리셋. 큰 파일은 단계별로 부가 기능만 꺼서 편집합니다.
문맥 코드 완성 · 오류 자리 안내 테이블 · 컬럼 · 루틴 · 방언별 데이터 타입 제안, FK 기반 JOIN 조건, 시그니처 카드. Ctrl 객체 링크 카드와 함께, 실패한 문장은 오류 자리나 오타가 의심되는 자리로 캐럿을 옮깁니다.
결과 그리드 편집 · 엑셀식 필터 단일 테이블 결과를 셀에서 고쳐 한 트랜잭션으로 적용합니다. 열 머리 타입 배지, 값 목록 필터 · 필터 칩 · OR 모드, 조건 바 재조회, 페이지 겹침 검사로 결과 변경을 알아챕니다.
객체 탐색기 · 객체 찾기 DBMS별 트리, 객체 용량, 소스 열기와 한 단위 컴파일, Generate SQL, CREATE 문 diff. 객체 찾기 창은 모든 연결 서버의 이름 · 설명 · 컬럼 · 소스 본문을 찾습니다.
실행 계획 검토 실행 계획을 공통 트리로 풀고 자동 검토 탭으로 문제를 짚습니다. 실제 실행 계획은 문장을 실제로 실행해 실측 행 수와 시간을 보여 줍니다.
가져오기 · 내보내기 csv · tsv · json · jsonl · xlsx · parquet를 열 매핑과 형 추천으로 가져오고 새 표도 만듭니다. 내보내기는 Excel · Parquet까지 스트리밍으로 쓰고, DBMS별 빠른 적재 경로를 자동 선택합니다.
Output 탭 · 로그 · 라이브 모니터 DBMS_OUTPUT · PRINT · RAISE NOTICE · 컴파일 결과를 등급 색으로 한곳에. 트랜잭션 로그는 보낸 문장 · 바인드 변수 · 값 치환 문장을 보여 주고, Oracle 라이브 모니터는 DBMS_PIPE와 장기 작업 진행을 봅니다.
운영 서버 안전장치 운영(PRD) 접속은 그리드 읽기 전용 · 2단 보류 커밋 · 변경 전 DDL 백업. 읽기 전용 프로필은 GUI · 스크립트 · 가져오기의 변경을 막고, 지운 프로필은 30일 동안 되살릴 수 있습니다.
암호화된 연결 프로필 비밀번호만 ChaCha20-Poly1305로 봉인해 사용자 폴더에 저장합니다(Windows는 DPAPI 기기 키). 저장하지 않은 비밀번호는 실행 중 메모리에서만 암호화 보관합니다. 프로필은 비밀번호 없이 내보낼 수 있습니다.
WASM 확장 · 패키지 저장소 Package Control처럼 저장소의 index.json으로 확장을 찾아 SHA-256 검증 후 설치합니다. 코드 확장은 샌드박스 WASM으로 재시작 없이 로드되며, nsql ext로 저장소를 검사합니다.

소개

Nexa SQL은 Windows · macOS · Linux에서 똑같이 생기고 똑같이 동작하는 가벼운 SQL 클라이언트(IDE)와 명령줄 도구 nsql을 한 묶음으로 제공합니다. 전부 Rust로 작성했고 자체 CPU 래스터라이저로 화면을 직접 그려 Qt · WebView · Electron을 쓰지 않습니다. 매일 여러 DBMS를 오가는 DB 개발자와 DBA를 위해 만들었습니다.

접속 대상이 크게 늘었습니다. Oracle은 Instant Client가 필요 없는 Thin 드라이버가 기본이고, SQL Server · PostgreSQL · MySQL/MariaDB · SQLite · DuckDB · IBM Db2(자체 DRDA 드라이버) · ClickHouse와 ODBC를 지원합니다. Redshift · CockroachDB · YugabyteDB · Greenplum · TimescaleDB는 PostgreSQL 드라이버로, Tibero · Altibase · CUBRID · SAP HANA · Informix는 ODBC 프리셋으로 붙습니다. 설치본에는 Oracle OCI 드라이버만 들어 있고 나머지는 처음 접속할 때 서명된 패키지를 내려받아 설치하며, 폐쇄망용 오프라인 번들도 있습니다.

대표 기능은 SQL*Plus식 세션 변수를 여러 DBMS에서 쓰는 스크립트 엔진입니다. VAR 선언, EXEC :V := 값 또는 식, SELECT … INTO :V, PRINT, DEFINE과 &치환, REF CURSOR, 편집기 안의 CONNECT가 같은 문법으로 동작합니다. 엔진이 Oracle에서는 PL/SQL 블록과 OUT 바인드로, SQL Server에서는 sp_executesql과 꼬리 SELECT로, PostgreSQL · SQLite에서는 $n 바인드로 바꿔 보내므로 SQL Server에서도 GO로 나뉜 여러 배치가 같은 변수를 이어 씁니다. 어떻게 바뀌는지는 nsql plan으로 서버 없이 미리 볼 수 있습니다.

편집기는 Sublime Text의 관습을 따릅니다. 기본 단축키 세트가 Sublime과 같고 Goto Anything(Ctrl+P), 명령 팔레트, 다중 커서, 북마크, 파일 검색이 있으며 사용자 .sublime-keymap 파일도 읽습니다. 문맥별 코드 완성, Ctrl 객체 링크, 방언별 구문 색과 색 프리셋, 포맷 프리셋이 있는 SQL 포맷터, 선언 이름 중심의 아웃라인, 미니맵, 다중 캐럿 순번 넣기(Insert Sequence)를 제공합니다. 실패한 문장은 오류 자리로, 구문 오류는 오타가 의심되는 자리로 캐럿이 옮겨 갑니다.

결과 그리드는 200행씩 가져와 스크롤에 따라 더 읽고, 행 상한 0이면 도착하는 대로 이어 붙입니다. 열 머리 타입 배지, 엑셀식 값 목록 필터, 조건 바로 결과를 좁히고, 단일 테이블 결과는 셀을 고쳐 한 트랜잭션으로 적용합니다. 서버 커서 없이 다음 페이지를 받을 때는 앞 페이지 끝 행을 겹쳐 비교해 결과가 바뀌면 조용히 누락하지 않고 멈춥니다. 객체 찾기 창은 연결된 모든 서버의 이름 · 설명 · 컬럼 · 소스 본문을 한 번에 찾고, 실행 계획 검토는 계획 트리와 자동 검토 탭을 보여 줍니다.

CLI nsql은 run · shell · export · import · format · explain · plan · conn · driver · cat · config · grep · bookmark · license · ext 15개 명령을 제공합니다. 결과는 stdout, 메시지는 stderr로 나뉘어 파이프와 CI에 바로 쓰이고, 대화형 셸에는 기록 찾기와 Tab 완성이 되는 자체 줄 편집기가 있습니다. 가져오기는 csv · tsv · json · jsonl · xlsx · parquet를 받아 새 표까지 만들고, 내보내기는 xlsx와 parquet까지 스트리밍으로 씁니다. 대량 적재는 PostgreSQL COPY · SQL Server TDS 벌크 · MySQL LOAD DATA · Oracle OCI 배열 DML을 자동으로 고릅니다.

운영 서버로 표시한 접속은 그리드가 읽기 전용이고, 변경은 2단 커밋 버튼을 누를 때까지 보류되며, 객체를 바꾸기 전에 DDL을 백업합니다. 읽기 전용 프로필은 GUI · 스크립트 · 가져오기의 변경을 모두 막습니다. 연결 프로필은 비밀번호만 ChaCha20-Poly1305로 암호화하고 Windows는 기기 키를 DPAPI로 보호합니다. 앱은 원격 측정을 보내지 않고 라이선스도 오프라인 파일로 확인합니다. 다만 드라이버 설치와 갱신을 위해 GitHub에서 색인과 패키지를 받고, 기본 설정에서 하루 한 번 색인을 읽으며 접속 때 새 판을 먼저 설치합니다. 모두 설정으로 끌 수 있습니다.

아직 안 되는 것도 밝힙니다. Oracle Thin은 실행 중 취소 · 암묵 결과 집합 · OS 인증 · 네이티브 암호화 · 12c 미만 서버를 지원하지 않아 그때는 Instant Client가 있는 OCI를 씁니다. SQL Server는 서버 인증서를 검증하지 않고, PostgreSQL 기본 TLS 모드는 평문으로 떨어질 수 있습니다. MS Access 지원은 실험 단계입니다. 코드 서명이 없어 SmartScreen · Gatekeeper 경고가 뜨며, winget은 아직 등록 전입니다. PolyForm Noncommercial 1.0.0 라이선스로 개인 · 비상업 사용은 무료이며 상업 사용은 별도 유료 라이선스(문의 [email protected])가 필요합니다.

릴리스 노트

v0.7.0 2026-11-07 편집기 버퍼 비교 · 로컬 히스토리 · 오브젝트 소스 시점 복원 · 선언 차이 비교 · 더 안전한 그리드 편집 · 창 투명도.

추가

비교 · 로컬 히스토리 — 편집기 두 버퍼 비교(edit.compare_with · 비교 탭 여럿 보관) · F7 / Shift+F7 = 차이 이동 · 편집기 거터의 git 변경 띠(editor.git_gutter · Alt+F7 = 다음 묶음) · 저장한 파일의 로컬 히스토리를 edit.history로 diff 탭에서 엽니다.
오브젝트 소스 시점 — 프로시저 · 패키지 · 뷰 등의 소스 탭이 열 때와 컴파일(F5) 직전마다 시점을 남기고, 로컬 히스토리에서 복원…으로 시점 본문을 편집기 탭에 되돌립니다(실행하기 전에는 서버에 아무것도 보내지 않음).
실제 객체와 비교에 선언 차이 — CREATE 문을 서버 객체와 비교하면 테이블 열(추가 · 삭제 · 타입/NULL · 순서)과 프로시저/함수 인자 · 반환 타입 차이를 요약해 비교 머리 줄과 Output 탭에 보여 줍니다.
창 투명도 — 메인 창을 살짝 투명하게, 뒤로 가면 조금 더(window.transparency · window.transparency_blur · Windows · macOS · X11).

개선

더 안전한 그리드 편집 — UNIQUE 키는 열이 모두 NOT NULL일 때만 행 식별에 쓰고, 적용 전에 바꾸거나 추가한 키 값을 서버에서 한 번에 확인해 이미 있으면 아무것도 쓰지 않습니다(grid.edit_key_check). 머리 배지로 행 식별 방식(KEY · RID · ALL)을 보여 줍니다.
방언 수정 — PostgreSQL · DuckDB · ClickHouse 서버 SHOW 통과 · 필수 인자 수로 오버로드 고르기 · PostgreSQL SET search_path / SET SCHEMA를 세션에 반영 · MySQL 8.0.19+ MERGE 행 별칭 · PostgreSQL 함수 소스 열기 보강.
드라이버 drivers-v0.1.11 — SQL Server geography · geometry · hierarchyid · sql_variant 열 읽기, UDT 열이 있는 표로 가져오기 패닉 해소 · Db2 zoned NUMERIC · 로케이터 값 디코드. driver.auto_install이 켜져 있으면 다음 접속 때 자동 설치됩니다.

수정

가져오기 중 오류에서 Skip/Stop을 고르면 커밋 안 된 앞 배치가 조용히 누락되던 문제 · nsql import --create가 아무것도 못 가져오면 만든 표를 지움 · ClickHouse 결과 그리드는 읽기 전용 · 상세 패널에서 연 오브젝트 소스가 제 탭으로.

변경

창 투명도 기본 켜짐(포커스 5% · 비활성 10%) — 둘 다 0이면 종전처럼 불투명합니다. 성능 향상 모드는 끕니다.
grid.refetch_confirm 기본이 off — 결과 다시 받기가 묻지 않고 진행하며, 행이 교체되면 실행당 한 번 경고 토스트를 띄웁니다.
history.enabled(기본 켬) — 저장한 파일과 오브젝트 소스를 앱 데이터 폴더 history/에 보관합니다(항목당 50개 · 전체 200MB까지). grid.edit_key_check(기본 켬)는 키를 바꾸는 편집 적용 때 확인 조회 1회를 더 보냅니다.

배포

GitHub · Homebrew · APT/RPM 0.7.0 반영, Chocolatey 0.7.0은 2026-11-07 승인(2026-11-07 확인). winget은 첫 제출 PR #447007(0.5.0)이 아직 병합되지 않았습니다.

설치