시작하기

웹과 데스크톱

NeoSQL 은 브라우저에서 여는 웹 앱과 Windows, macOS 에 설치하는 데스크톱 앱 두 형태로 사용합니다. 두 앱은 같은 화면을 사용하지만 DB 에 접속하는 경로가 달라서, 접속할 수 있는 DB 와 사용할 수 있는 기능이 다릅니다. 아래에서 차이와 어느 쪽을 언제 사용할지를 설명합니다.

DB 에 접속하는 경로

브라우저나 앱의 화면은 DB 에 직접 접속하지 않습니다. DB 접속은 데스크톱에서는 로컬 서버가, 웹에서는 NeoSQL 서버가 맡습니다. DB 접속을 맡는 서버가 어디에서 실행되는지가 두 앱의 가장 큰 차이입니다.

웹 앱데스크톱 앱
DB 접속을 맡는 서버NeoSQL 이 운영하는 서버기기에서 앱과 함께 실행되는 로컬 서버
접속할 수 있는 DB인터넷에서 접속을 받는 DB. DB 의 방화벽이 NeoSQL 서버에서 오는 접속을 차단하지 않아야 합니다기기에서 접속할 수 있는 DB 모두. 사내망과 VPN 너머의 DB, 기기의 localhost DB, SQLite, H2 파일
  • 회사 DB 의 방화벽은 보통 개발자 기기까지만 접속을 허용합니다. 그래서 사내 DB 를 다루려면 데스크톱 앱이 필요합니다.
  • localhost, SQLite, H2 Embedded 커넥션은 데스크톱 앱에서 사용합니다. Desktop 전용 커넥션 안내가 표시되면 데스크톱 앱에서 커넥션을 여세요.
  • 데스크톱의 로컬 서버는 기기 안(127.0.0.1)에서만 접속을 받습니다. 다른 기기가 로컬 서버를 거쳐 DB 에 접속할 수는 없습니다.

로그인과 프로젝트

웹 앱데스크톱 앱
로그인항상 필요합니다. 로그인하지 않았으면 로그인 화면으로 갑니다로그인하지 않아도 사용할 수 있습니다. 로그인하면 계정 기능이 더해집니다
만들 수 있는 프로젝트계정 프로젝트로그인하지 않으면 로컬 프로젝트. 로그인하면 로컬과 계정 가운데 선택합니다
프로젝트가 저장되는 곳NeoSQL 서버로컬 프로젝트는 기기, 계정 프로젝트는 NeoSQL 서버
DB 접속 정보(비밀번호)NeoSQL 서버에 암호화해 보관합니다로컬 프로젝트는 기기의 OS 보안 저장소에 보관합니다. 계정 프로젝트는 웹과 같습니다
  • 계정 프로젝트는 웹과 데스크톱에서 같은 프로젝트로 열립니다. 로컬 프로젝트는 만든 기기의 데스크톱 앱에서만 열립니다.
  • 프로젝트의 종류는 만들 때 정하고 나중에 변경할 수 없습니다. 이유는 로그인과 프로젝트 종류 에서, 접속 정보를 보관하는 방식은 보안과 데이터가 나가는 곳 에서 설명합니다.

기능별 사용 환경

기능사용하는 환경과 방법
로그인하지 않고 사용하기, 로컬 프로젝트데스크톱 앱에서 사용합니다. 웹 앱에서는 로그인해 계정 프로젝트를 사용합니다.
사내망, VPN, localhost 의 DB, SQLite, H2 파일 DBDB 에 접속할 수 있는 기기의 데스크톱 앱에서 사용합니다.
프로젝트 간 전환(작업 탭)데스크톱에서는 작업 탭으로, 웹에서는 브라우저 탭으로 전환합니다.
탐색기 우클릭데이터 내보내기... 메뉴와 탐색기 우클릭데이터 가져오기... 메뉴데스크톱 앱에서 데이터를 파일로 내보내거나 파일에서 가져옵니다.
탐색기 우클릭Native Backup... 메뉴와 탐색기 우클릭Native Reload... 메뉴데스크톱 앱에서 백업하고 복원합니다.
SQL 결과를 CSV, JSON, Excel 파일로 내보내기데스크톱 앱에서 사용합니다.
생성한 소스코드 저장데스크톱에서는 프로젝트 폴더에 설치하거나 ZIP 파일로 다운로드합니다. 웹에서는 ZIP 파일로 다운로드합니다.
템플릿 팩 가져오기와 내보내기데스크톱에서는 폴더나 ZIP 파일을 사용합니다. 웹에서는 ZIP 파일을 사용합니다.
커스텀 JDBC 드라이버 추가데스크톱 앱에서 드라이버 JAR 파일을 추가합니다.
MCP데스크톱 앱의 MCP 클라이언트 설정 버튼에서 외부 AI 클라이언트를 설정합니다.
AI 모델과 API 키데스크톱에서는 이 기기의 API 키 묶음과 기기나 사내망의 AI 서버를 사용할 수 있습니다. 웹에서는 계정에 등록한 키와 공개 HTTPS 주소를 사용합니다.
ZK 암호화 비밀 키 보관데스크톱 앱의 OS 키체인에 저장합니다.
업데이트(설치와 업데이트)데스크톱 앱은 자동 업데이트를 사용합니다. 웹 앱은 새 버전 안내에 따라 페이지를 새로고침합니다.

웹 앱에서 다른 점

  • 헤더 오른쪽에 데스크톱 앱 버튼이 있습니다. 클릭하면 데스크톱 앱을 받는 홈페이지가 열립니다.
  • 웹 앱은 플랜에 따라 SQL 결과를 가져오는 행 수에 상한이 있습니다. 플랜별 차이는 플랜과 기능 차이 에서 설명합니다.
  • 웹 앱은 데스크톱 브라우저에서 사용합니다. 휴대폰에서는 홈페이지를 이용합니다.

어느 쪽을 사용할까요

이럴 때사용할 것
회사 안이나 VPN 너머의 DB, 기기의 DB 를 다룹니다데스크톱 앱
계정 없이 바로 사용해 보고 싶습니다데스크톱 앱(로그인하지 않고). 웹 앱은 로그인해야 합니다.
프로젝트 데이터를 기기 외부에 두면 안 됩니다데스크톱 앱, 로그인하지 않고 로컬 프로젝트
앱을 설치할 수 없는 기기에서 인터넷에 열린 DB(클라우드 DB 등)를 다룹니다웹 앱
팀과 함께 설계합니다계정 프로젝트(웹, 데스크톱 모두). 팀원을 초대하려면 공유 인원이 2명 이상인 플랜을 사용합니다. 협업과 권한 에서 설명합니다.
외부 AI 도구(MCP)로 NeoSQL 을 다룹니다데스크톱 앱

두 앱을 함께 사용해도 됩니다. 같은 계정으로 로그인하면 계정 프로젝트를 웹에서도 데스크톱에서도 엽니다. 사내 DB 는 데스크톱에서, 인터넷에 열린 DB 는 웹에서 다루는 식으로 나눠 사용할 수 있습니다.

관련 페이지