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 파일 DB | DB 에 접속할 수 있는 기기의 데스크톱 앱에서 사용합니다. |
| 프로젝트 간 전환(작업 탭) | 데스크톱에서는 작업 탭으로, 웹에서는 브라우저 탭으로 전환합니다. |
| 메뉴와 메뉴 | 데스크톱 앱에서 데이터를 파일로 내보내거나 파일에서 가져옵니다. |
| 메뉴와 메뉴 | 데스크톱 앱에서 백업하고 복원합니다. |
| 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 는 웹에서 다루는 식으로 나눠 사용할 수 있습니다.
관련 페이지