Skip to content

Nexa SQL 0.8.0

Choose a tag to compare

@github-actions github-actions released this 14 Nov 07:54

Nexa SQL 0.8.0

Minor release (234 commits since 0.7.2). Highlights:

  • AI assistant (Claude · Codex), opt-in — a new assistant tab in the activity bar, off by default (ai.enabled; palette View: Turn on AI assistant). Two providers (ai.provider), each in API mode (API key or workload identity federation per profile, secrets kept in the vault) or CLI mode (the installed claude / codex command's own login); sessions in a side panel, one view tab per session, model and effort chips, cost estimate (ai.prices), Markdown answers with tables, attachments (files, clipboard text and images, result grid via /grid), slash commands (/status, /skills, /agent, /rename), prompt history (Up/Down).
  • 40 app tools for the assistant — search objects and column comments, describe objects and read sources (without opening an editor tab unless you ask), run queries and EXPLAIN, read the Output and Log tabs, edit the editor (partial edits, multiple carets, insert sequences, set syntax, line operations, case conversion), variables (set, formula, delete), bookmarks, project file search and filter, reveal an object in the explorer, open a file at a line, connect and disconnect, settings and commands; the same tools are offered to the CLI through a local MCP server named nexa-sql.
  • Data protection for assistant actions — every statement is classified before it runs: reads need a one-time row-data consent, writes show one approval card with the SQL text, purpose and target (⚠ when an UPDATE/DELETE has no WHERE); bulk changes (no WHERE, or at least ai.guard_bulk_rows rows) and destructive changes (DROP/TRUNCATE/ALTER) add an impact check with the counted row number on the same card; non-SELECT statements without a recorded approval are blocked at execution; read-only profiles stay read-only.
  • Production connections are guarded harder — writes requested by the assistant need two clicks on Allow within run.prod_confirm_ms (a countdown bar shows the armed button); commit/rollback, changing protection settings and run commands are refused on production; disconnecting asks with an approval card; changes are never auto-approved there.
  • Assistant runs stay out of your way — queries the assistant runs while working are hidden (no result grid, Output tab or run card); at the end of a turn the last read-only ```sql block of the answer is shown in the result grid (ai.show_result); a busy session queues tool calls instead of failing; ■ Stop now also cancels the database statement the assistant started.
  • Metadata first — the assistant searches the metadata the object explorer already loaded (names, table and column comments, columns) before querying the data dictionary (ai.meta_first); catalog-only queries and WHERE 1=0 column probes run without the row-data question (ai.meta_auto; unqualified Oracle ALL_/USER_/DBA_/V$ names pass only when they are known dictionary views); describe_object loads columns that were not loaded yet.
  • Chat beside the editor or as its own tab — a split pane to the right of the editor (ai.side, ai.side_width, toolbar AI group) bound to each editor tab; a chat tab is an independent unit with its own connection badge and its own variable table (editor-only actions are disabled there); execution error cards offer [AI] to ask for a fix (ai.error_offer).
  • Editor palette commands — Sort Lines, Sort Lines (Case Sensitive), Permute Lines: Reverse / Shuffle / Unique, and Convert Case (Upper, Lower, Title, Swap, snake_case, kebab-case, UpperCamelCase, lowerCamelCase) on the selected lines or words (whole document without its trailing empty line when nothing is selected; multiple selections stay selected); Goto Symbol (Ctrl+R) opens even when the document has no symbols and offers to show statements as symbols.
  • Variables: uppercase names and formulas — variable names are always uppercase (display, saving and formula text; older lowercase saves are read as uppercase); assign a formula in the Variables window (NAME := expression, : optional before names); formulas survive restart and are marked stale (↻) until recalculated (vars.refresh); circular formulas are refused and chains recalculate one level at a time.
  • Secret variables — substitution variables whose names contain PASS, PWD, SECRET or TOKEN (vars.secret_names) or come from ACCEPT … HIDE are masked everywhere; the Variables window shows the value only while 👁 is held (vars.reveal_secret).
  • List windows: sort and filter — the Transaction Log and Variables windows sort by header click (three states, Shift to combine) and filter by value (funnel); the Transaction Log detail is a read-only text box (select, copy, word wrap); the Variables window has right-click copy (name, value, formula, row, script); the Connection window gets the same value filter on every column.
  • Object backup and assistant statements — while an object backup runs, other changing statements are not accepted; a statement waiting for the backup is not run if you switch to a tab on another connection, and its result returns to the same assistant tool call.
  • Editor and settings — word wrap (editor.word_wrap, View menu, off for large files); click the git change strip in the gutter for a HEAD ↔ working copy diff popup (editor.git_popup, editor.git_context); a successful F5 on an object tab stores the server's source as a history snapshot; fuzzy search in the Settings window (space-separated words, key or label); the Settings window opens without a black flash and loads faster; Preferences at the end of the View menu.
  • Smaller improvements — Sublime-style double-click selection (runs of spaces or symbols) and word/line-wise drag after double/triple click; Find bar collapses the selection when nothing matches (editor.find_keep_last_match); result grid right-click Advanced Copy ▸ Copy row (TSV); Output tab Ctrl+A/Ctrl+C; scroll bar visibility (ui.scrollbars); completion lists plain column names for a single unaliased table and replaces the whole word when accepted mid-word.
  • Fixes — driver download checks network reach first (driver.net_check_ms) and points to the offline bundle on a closed network instead of waiting for a timeout; the formatter no longer adds aliases to referenced tables, keeps WITHIN GROUP and DB links intact; dragging a selection in a full Log window no longer resets; changing only variables now marks the project to be saved; values computed only on the client no longer count as pending production changes; a message sent while the assistant is still answering is queued and sent when the current turn ends — queued messages, together with their attachments, are listed above the input box (up to 3 rows, scroll for more, × removes one) and ■ puts them back in the input box; an API-mode session no longer stays stuck on "HTTP 400 … tool_use.input: Field required" after a reply was cut off in the middle of a tool call (■, max tokens, dropped connection) — the interrupted call is replaced with a note before the next request; while the assistant is answering you can scroll the conversation up (even with small touchpad steps) and it stays there until you scroll or drag back to the bottom; the SQLite driver no longer silently drops all but the first statement of a multi-statement request (e.g. F5 in an object source tab) — non-query batches run in full, all or nothing (drivers-v0.1.12).

Behaviour changes:

  • Variable names are always uppercase — :name and :NAME are the same variable; display, saved files and formula text use uppercase (previously the typed case was kept).
  • Production writes from the assistant need two clicks on Allow within run.prod_confirm_ms; a single write card now also carries the row-data consent.
  • Catalog queries run without the row-data question when ai.meta_auto is on (default on); queries touching user tables, user functions, derived tables or DB links still ask.
  • Stop (■) during an assistant turn also cancels the running database statement, as the editor's ■ does.
  • Variable assignments that only compute on the client (no user routine call) skip the production two-step confirmation and are not held as pending changes.
  • Driver download network check — driver.net_check_ms (default 1500 ms, 0 = off) adds one short TCP reach check before downloading a driver.
  • New settings (defaults): editor.word_wrap off · editor.find_keep_last_match off · editor.git_popup on · editor.git_context 3 · ui.scrollbars auto · vars.secret_names PASS,PWD,SECRET,TOKEN · vars.reveal_secret on · format.table_alias_case keep · notice.ai_error_offer on.
  • New AI settings (46 ai.* keys, inactive while ai.enabled is off) — notable defaults: ai.provider claude · ai.mode api · ai.guard_auto_write off · ai.guard_bulk_rows 1000 · ai.meta_auto on · ai.meta_first on · ai.show_result auto · ai.max_rows 200 · ai.side off · ai.verbosity basic · ai.secret_warn on · ai.history_keep_days 90. No existing default changed.

Update the drivers to drivers-v0.1.12 (SQLite multi-statement requests now run in full instead of only the first statement; driver ABI v2 unchanged, 0.1.11 drivers keep working).

마이너 릴리스(0.7.2 이후 커밋 234). 주요 변경:

  • AI 어시스턴트(Claude · Codex) · 선택 사용 — 활동 막대에 새 어시스턴트 탭 · 기본 꺼짐(ai.enabled · 팔레트 보기: AI 어시스턴트 켜기) · 제공자 둘(ai.provider) · 각각 API 모드(프로필별 API 키 또는 ID 페더레이션 · 비밀은 볼트) 또는 CLI 모드(설치된 claude / codex 명령의 자체 로그인) · 옆 패널 세션 관리 · 세션마다 뷰 탭 · 모델·노력도 칩 · 비용 추정(ai.prices) · 표를 포함한 Markdown 답 · 첨부(파일 · 클립보드 글/이미지 · /grid = 결과 그리드) · 슬래시 명령(/status · /skills · /agent · /rename) · 프롬프트 기록(↑/↓).
  • 어시스턴트용 앱 도구 40종 — 객체·컬럼 코멘트 검색 · 객체 설명·소스 읽기(요청하지 않으면 편집기 탭을 열지 않음) · 조회·EXPLAIN 실행 · Output·Log 탭 읽기 · 편집기 편집(부분 편집 · 다중 캐럿 · 연번 넣기 · 구문 지정 · 줄 연산 · 표기 변환) · 변수(지정 · 수식 · 삭제) · 북마크 · 프로젝트 파일 검색·거르기 · 탐색기에서 객체 위치 보이기 · 줄 지정 파일 열기 · 접속·접속 해제 · 설정·명령 · CLI에는 같은 도구를 로컬 MCP 서버 nexa-sql로 제공.
  • 어시스턴트 동작의 데이터 보호 — 실행 전에 모든 문장을 분류: 조회 = 행 데이터 동의 한 번 · 쓰기 = SQL 본문·목적·대상이 든 승인 카드 한 장(WHERE 없는 UPDATE/DELETE는 ⚠) · 대량 변경(WHERE 없음 또는 ai.guard_bulk_rows 행 이상)과 파괴적 변경(DROP/TRUNCATE/ALTER)은 같은 카드에 센 영향 행 수로 2단계 확인 · 승인 기록 없는 비조회 문장은 실행 단계에서 차단 · 읽기 전용 프로필은 그대로 읽기 전용.
  • 운영 접속은 더 단단히 — 어시스턴트가 요청한 쓰기는 run.prod_confirm_ms 안에 허용을 두 번 눌러야 실행(장전된 버튼에 남은 시간 막대) · 운영에서 커밋/롤백 · 보호 설정 변경 · 실행 명령은 거부 · 접속 해제도 승인 카드 · 운영에서는 변경을 자동 승인하지 않음.
  • 어시스턴트 실행이 작업을 가리지 않음 — 작업 중 돌리는 조회는 숨김 실행(결과 그리드 · Output 탭 · 실행 카드 없음) · 턴이 끝나면 답의 마지막 읽기 전용 ```sql 블록을 결과 그리드에 표시(ai.show_result) · 세션이 바쁘면 도구 호출을 대기열에 · ■ 중지가 어시스턴트가 시작한 DB 문장 실행도 취소.
  • 메타 우선 — 데이터 사전을 조회하기 전에 객체 탐색기가 이미 적재한 메타(이름 · 테이블/컬럼 코멘트 · 컬럼)를 먼저 검색(ai.meta_first) · 카탈로그 전용 조회와 WHERE 1=0 컬럼 확인 조회는 행 데이터 확인 없이 실행(ai.meta_auto · 스키마 한정 없는 Oracle ALL_/USER_/DBA_/V$ 이름은 알려진 사전 뷰일 때만) · describe_object가 아직 안 읽힌 컬럼을 적재.
  • 편집기 옆 대화 또는 독립 탭 — 편집기 오른쪽 분할 창(ai.side · ai.side_width · 툴바 AI 그룹) = 편집기 탭마다 세션 · 채팅 탭 = 독립 단위(자기 연결 표식 · 자기 변수 표 · 편집기가 필요한 동작은 비활성) · 실행 오류 카드의 [AI] = 수정 요청(ai.error_offer).
  • 편집기 팔레트 명령 — 줄 정렬 · 줄 정렬(대소문자 구분) · 줄 순서 바꾸기: 거꾸로 / 섞기 / 중복 제거 · 표기 변환(대문자 · 소문자 · 낱말 첫 글자 대문자 · 대소문자 뒤집기 · snake_case · kebab-case · UpperCamelCase · lowerCamelCase) = 선택한 줄·낱말(선택 없으면 끝 빈 줄을 뺀 문서 전체 · 여러 선택은 변환 뒤에도 유지) · Goto Symbol(Ctrl+R)이 심벌 없는 문서에서도 열리고 문장을 심벌로 보기를 제안.
  • 변수: 대문자 이름과 수식 — 변수 이름은 늘 대문자(표시 · 저장 · 수식 글 · 옛 소문자 저장본은 읽을 때 대문자) · 변수 창에서 수식 지정(이름 := 식 · 식 안 이름 앞 : 생략 가능) · 수식은 재시작 뒤에도 남고 재계산 전에는 ↻(stale) 표시(vars.refresh) · 순환 수식 거절 · 연쇄는 한 층씩 재계산.
  • 비밀 변수 — 이름에 PASS · PWD · SECRET · TOKEN이 든 치환 변수(vars.secret_names)와 ACCEPT … HIDE 변수는 모든 출구에서 가림 · 변수 창 👁을 누르고 있는 동안만 원문(vars.reveal_secret).
  • 목록 창 정렬·필터 — 트랜잭션 로그 창·변수 창 = 머리 클릭 정렬(3단 · Shift 결합) · 깔때기 값 필터 · 트랜잭션 로그 상세 = 읽기 전용 글상자(선택 · 복사 · 줄바꿈) · 변수 창 우클릭 복사(이름 · 값 · 수식 · 행 · 스크립트) · 접속 창도 열마다 같은 값 필터.
  • 객체 백업과 어시스턴트 문장 — 객체 백업이 도는 동안 다른 변경 문장은 받지 않음 · 백업을 기다리던 문장은 다른 연결의 탭으로 옮기면 실행하지 않음 · 그 결과는 같은 어시스턴트 도구 호출로 돌아감.
  • 편집기·설정 — 자동 줄 바꿈(editor.word_wrap · 보기 메뉴 · 큰 파일은 끔) · 거터 git 띠 클릭 = HEAD ↔ 작업본 diff 팝업(editor.git_popup · editor.git_context) · 오브젝트 탭 F5가 성공하면 서버 소스를 히스토리 시점으로 저장 · 설정 창 퍼지 검색(공백으로 낱말 · 키·라벨) · 설정 창이 까만 깜빡임 없이 더 빨리 열림 · 보기 메뉴 끝 환경 설정.
  • 작은 개선 — Sublime식 더블클릭 선택(공백·기호 묶음) · 더블/트리플 클릭 뒤 끌기 = 낱말/줄 단위 · 찾기 결과가 없으면 선택 접기(editor.find_keep_last_match) · 결과 그리드 우클릭 고급 복사 ▸ 행 복사(TSV) · Output 탭 Ctrl+A/Ctrl+C · 스크롤바 표시(ui.scrollbars) · 별칭 없는 단일 테이블 완성 = 열 이름만 · 낱말 한가운데서 확정하면 낱말 전체 교체.
  • 결함 수정 — 드라이버 내려받기 전에 망 도달을 먼저 확인(driver.net_check_ms) · 폐쇄망이면 시간 초과를 기다리지 않고 오프라인 번들 안내 · 포매터가 참조되는 테이블에 별칭을 붙이지 않고 WITHIN GROUP · DB 링크를 보존 · 최대 줄 수에 찬 로그 창의 끌기 선택이 끊기지 않음 · 변수만 바꿔도 프로젝트 저장 대상 · 클라이언트에서 계산만 하는 값은 운영 보류 변경으로 세지 않음 · 어시스턴트가 답하는 중에 보낸 글은 줄에 세웠다가 지금 턴이 끝나면 보냄 — 줄 선 글은 첨부와 함께 입력창 위에 한 줄씩 보임(최대 3줄 · 더 있으면 휠 · × = 그 건만 삭제) · ■ = 줄 선 글을 입력창으로 되돌림 · 도구 호출 도중 응답이 끊긴 뒤(■ · 최대 토큰 · 연결 끊김) API 모드 세션이 "HTTP 400 … tool_use.input: Field required"로 계속 막히던 것 — 다음 요청 전에 끊긴 호출을 안내 글로 바꿔 보냄 · 어시스턴트가 답하는 중에도 대화를 위로 굴릴 수 있음(터치패드의 작은 굴림 포함) · 휠이나 스크롤바로 맨 아래까지 내리면 다시 새 글을 따라감 · SQLite 드라이버가 한 요청에 든 여러 문장 중 첫 문장만 실행하고 나머지를 조용히 버리던 결함 수정(예: 객체 소스 탭 F5) — 조회가 아닌 묶음은 전부 실행 · 전부 또는 전무(drivers-v0.1.12).

동작이 바뀌는 점:

  • 변수 이름은 늘 대문자 — :name과 :NAME은 같은 변수 · 표시 · 저장 파일 · 수식 글 모두 대문자(종전 = 입력한 표기 보존).
  • 어시스턴트의 운영 쓰기 = 허용 두 번 — run.prod_confirm_ms 안에 허용을 두 번 · 쓰기 카드 한 장이 행 데이터 동의도 겸함.
  • 카탈로그 조회는 행 데이터 확인 없이 실행 — ai.meta_auto 켜짐(기본 on)일 때 · 사용자 테이블 · 사용자 함수 · 파생 테이블 · DB 링크를 건드리는 조회는 여전히 확인.
  • 어시스턴트 턴 중 ■(중지) = 실행 중 DB 문장도 취소 — 편집기 ■와 같음.
  • 클라이언트에서 계산만 하는 변수 대입(사용자 루틴 호출 없음)은 운영 2단 확인을 건너뛰고 보류 변경으로 잡지 않음.
  • 드라이버 내려받기 망 확인 — driver.net_check_ms(기본 1500 ms · 0 = 끔) = 내려받기 전에 짧은 TCP 도달 확인 1회.
  • 새 설정(기본값): editor.word_wrap off · editor.find_keep_last_match off · editor.git_popup on · editor.git_context 3 · ui.scrollbars auto · vars.secret_names PASS,PWD,SECRET,TOKEN · vars.reveal_secret on · format.table_alias_case keep · notice.ai_error_offer on.
  • 새 AI 설정(ai.* 46키 · ai.enabled가 off인 동안은 동작 없음) — 주요 기본값: ai.provider claude · ai.mode api · ai.guard_auto_write off · ai.guard_bulk_rows 1000 · ai.meta_auto on · ai.meta_first on · ai.show_result auto · ai.max_rows 200 · ai.side off · ai.verbosity basic · ai.secret_warn on · ai.history_keep_days 90 · 기존 키의 기본값 변경 없음.

드라이버를 drivers-v0.1.12로 갱신하세요(SQLite 여러 문장 요청을 첫 문장만이 아니라 전부 실행 · 드라이버 ABI v2는 그대로라 0.1.11 드라이버도 계속 동작합니다).

Lightweight cross-platform SQL client (IDE) for Oracle, SQL Server, PostgreSQL, MySQL/MariaDB, SQLite, DuckDB, IBM Db2, ClickHouse and ODBC sources, with the nsql CLI.
Installers only (no portable build). Changes: see docs/DEVLOG.md.

OS File Install
Windows x64 nexa-sql-0.8.0-windows-x64.msi Double-click, or msiexec /i … /qn (silent; adds nsql to PATH; .sql association optional) · winget install SosomLab.NexaSQL · choco install nexa-sql (only when this release was pushed to those channels)
macOS (Universal) nexa-sql-0.8.0-macos-universal.pkg / .dmg Installer → /Applications/Nexa SQL.app + /usr/local/bin/nsql · brew install --cask kiros33/tap/nexa-sql
Linux x86_64 .deb / .rpm sudo apt install ./…deb / sudo dnf install ./…rpm · or the signed repository at https://pkg.sosomlab.com/ (apt install nexa-sql / dnf install nexa-sql)

Drivers are not bundled (only the Oracle OCI driver, which needs an Instant Client): the first connection to PostgreSQL, MySQL/MariaDB, SQL Server, SQLite, DuckDB, Oracle Thin, IBM Db2, ClickHouse or ODBC downloads the signed driver package from the drivers-v* pre-release (currently drivers-v0.1.12) and installs it (driver.auto_install). Offline: nsql driver install --file nsql-drivers-all-<ver>-<os>-<arch>.zip. Driver packages are built for Windows x64, Linux x86_64, Apple Silicon and Intel macOS (ODBC included on all four).
Verify downloads with sha256sums.txt. Builds are not code-signed yet (DR-20): macOS Gatekeeper and Windows SmartScreen will warn.
License: PolyForm Noncommercial 1.0.0 — free for noncommercial use only.


크로스플랫폼 경량 SQL 클라이언트(IDE) + CLI nsql — 설치본만 배포합니다(포터블 없음 · DR-27).

운영체제 파일 설치
Windows x64 nexa-sql-0.8.0-windows-x64.msi 더블클릭 또는 msiexec /i … /qn(조용한 설치 · PATH 추가 옵션 · .sql 연결은 선택)
macOS (Universal · Apple Silicon/Intel) nexa-sql-0.8.0-macos-universal.pkg 설치기 실행 → /Applications/Nexa SQL.app + /usr/local/bin/nsql 링크
macOS (drag-to-Applications) nexa-sql-0.8.0-macos-universal.dmg 끌어 놓기 · CLI 링크는 dmg 안 안내문
Linux x86_64 (deb) nexa-sql_0.8.0_amd64.deb sudo dpkg -i 또는 sudo apt install ./…deb
Linux x86_64 (rpm) nexa-sql-0.8.0-1.x86_64.rpm sudo dnf install ./…rpm
macOS (Homebrew) — brew install --cask kiros33/tap/nexa-sql(공개 뒤 자동 반영 · nsql도 PATH에)
Linux (APT 저장소 · Debian/Ubuntu) — 저장소 등록 뒤 sudo apt install nexa-sql · 갱신 = apt upgrade(아래 · 공개 뒤 자동 반영)
Linux (RPM 저장소 · Fedora/RHEL 계열) — 저장소 등록 뒤 sudo dnf install nexa-sql · 갱신 = dnf upgrade(아래 · 공개 뒤 자동 반영)

Linux 패키지 저장소(pkg.sosomlab.com · 서명됨)

한 번 등록하면 새 버전을 apt upgrade/dnf upgrade로 받습니다(안내 = https://pkg.sosomlab.com/).

# APT(Debian · Ubuntu)
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
sudo apt update && sudo apt install nexa-sql
# RPM(Fedora · RHEL 계열)
sudo curl -fsSLo /etc/yum.repos.d/sosomlab.repo https://pkg.sosomlab.com/rpm/sosomlab.repo
sudo dnf install nexa-sql

받은 파일은 sha256sums.txt로 확인하세요. 제거: Windows 프로그램 추가/제거 · macOS sudo "/Applications/Nexa SQL.app/Contents/Resources/uninstall.sh" · Linux dpkg -r nexa-sql/dnf remove nexa-sql.
사용자 데이터(설정·연결 프로필)는 OS 사용자 폴더에 있으며 제거해도 보존됩니다.

서명

코드 서명 키가 투입되지 않은 빌드는 macOS Gatekeeper·Windows SmartScreen이 경고합니다(DR-20 · 별도 요청 시 서명).

  • macOS: xattr -dr com.apple.quarantine "/Applications/Nexa SQL.app"
  • Windows: SmartScreen "추가 정보 → 실행"

라이선스: PolyForm Noncommercial 1.0.0 — 변경 내역: docs/DEVLOG.md