핵심 개념

연결과 실행 대상

NeoSQL 에서 데이터베이스와 관련된 모든 작업은 커넥션에서 시작합니다. 커넥션이 무엇을 담고, SQL 과 ERD 가 어디에서 실행되며, 접속 정보가 어디에 저장되는지를 알아 두면 "SQL 이 엉뚱한 스키마에서 돌았다", "웹에서는 사내 DB 가 안 보인다" 같은 혼란을 피할 수 있습니다.

커넥션은 DBMS 와 접속 정보입니다

커넥션은 DBMS 의 종류와, 필요하면 DB 에 접속하는 정보(호스트, 포트, 사용자, 비밀번호 등)를 담습니다. 접속 정보는 꼭 넣지 않아도 됩니다. 아직 DB 가 없거나 설계만 먼저 하고 싶으면 DBMS 만 선택한 커넥션으로 ERD 를 그릴 수 있습니다.

작업필요한 커넥션 설정
ERD 설계DBMS 를 선택합니다. 테이블은 선택한 DBMS 의 타입으로 만들어집니다.
실제 DB 의 테이블을 ERD 로 가져오기DB 접속 정보를 입력한 커넥션을 사용합니다.
ERD 의 설계를 DB 에 반영DB 접속 정보를 입력한 커넥션을 사용합니다.
SQL 편집기DB 접속 정보를 입력한 커넥션을 사용합니다.
  • 탐색기 위의 커넥션... 버튼으로 새 커넥션을 만들면 DBMS(1)만 선택한 상태로 시작합니다. 접속 정보 칸은 DB에 연결 버튼(2)을 클릭해야 나타납니다.
  • 접속 정보 없이 저장하면 나중에 추가할 수 있다는 확인을 한 번 거칩니다. 저장한 커넥션은 탐색기 우클릭수정... 메뉴로 다시 열어 언제든 접속 정보를 넣을 수 있습니다.
  • 접속 정보를 나중에 넣으면, 그동안 커넥션으로 그린 ERD 를 실제 DB 의 어느 스키마에 붙일지 묻는 ERD 연결하기 창이 열립니다. 선택하지 않은 ERD 는 그대로 둡니다.

실행 대상: 커넥션, 데이터베이스, 스키마

SQL 과 ERD 는 커넥션 하나에 묶이고, 안에서 어느 데이터베이스와 스키마를 대상으로 하는지도 함께 기억합니다. DBMS 마다 커넥션 아래 계층의 모양이 다릅니다.

DBMS실행 대상의 계층
PostgreSQL, SQL Server, Snowflake커넥션 › 데이터베이스 › 스키마
Databricks커넥션 › 카탈로그 › 스키마
BigQuery커넥션 › 프로젝트 › 데이터셋
MySQL, MariaDB커넥션 › 데이터베이스(스키마와 같은 자리입니다)
Oracle커넥션 › 스키마(사용자)
SQLite, H2커넥션 › 스키마
문서묶이는 곳변경하는 곳
SQL 탭접속 정보가 있는 커넥션, (계층이 있으면) 데이터베이스 하나, 스키마 하나SQL 편집기 도구 모음의 커넥션 이름을 클릭하면 열리는 SQL 편집기 설정 창
ERD커넥션, (계층이 있으면) 데이터베이스 하나, 스키마 하나 또는 전체 (모든 스키마 허용) 항목ERD 를 만들 때 정합니다
  • 실행 대상으로 선택할 수 있는 스키마는 커넥션 창의 스키마 탭에서 선택한 스키마뿐입니다. 탐색기에 보이는 스키마도 같습니다.
  • ERD 하나는 데이터베이스 하나 안에서만 그립니다. 여러 데이터베이스에 걸친 ERD 는 만들 수 없습니다.
  • SQL Server 는 세션의 기본 스키마를 변경할 수 없습니다. 그래서 SQL 탭의 스키마는 로그인 사용자의 기본 스키마로 고정되고, 다른 스키마의 객체는 SQL 에 스키마.테이블 로 적어야 합니다.

웹과 데스크톱은 DB 에 접속하는 곳이 다릅니다

NeoSQL 이 DB 에 접속할 때 실제로 연결을 여는 프로그램은 화면이 아니라 백그라운드에서 실행되는 서버입니다. 웹 앱과 데스크톱 앱은 서버가 있는 곳이 다릅니다.

웹 앱데스크톱 앱
DB 에 접속하는 곳NeoSQL 서버기기 안의 로컬 서버(앱에 함께 설치됩니다)
접속할 수 있는 DB인터넷에서 접속할 수 있는 DB기기에서 접속할 수 있는 모든 DB(사내망, VPN, localhost, 기기의 파일)
SQLite, H2 Embedded, localhost사용할 수 없습니다사용할 수 있습니다
사용자 지정 JDBC 드라이버추가할 수 없습니다(기본 드라이버만)추가할 수 있습니다
  • 웹 앱에서 SQLite, H2 Embedded, localhost 커넥션을 저장하거나 테스트하려 하면 Desktop 전용 커넥션 안내가 표시되고 진행하지 않습니다. NeoSQL 서버에는 기기의 파일과 localhost 가 없기 때문입니다.
  • DB 방화벽이 회사 안이나 개발자 기기에서 오는 접속만 받는다면 데스크톱 앱을 사용하세요. 자세한 비교는 웹과 데스크톱 에서 설명합니다.

접속 정보가 저장되는 곳

비밀번호, 인증서, SSH 키 같은 비밀값은 프로젝트 종류에 따라 다른 곳에 저장됩니다. 프로젝트 종류는 로그인과 프로젝트 종류 에서 설명합니다.

로컬 프로젝트(데스크톱)계정 프로젝트
저장되는 곳기기의 OS 보안 저장소(macOS 키체인, Windows DPAPI 등)NeoSQL 서버에 암호화해 저장
기기 외부로나가지 않습니다서버에 저장되고, 접속할 때 DB 에 접속하는 서버(데스크톱은 로컬 서버, 웹은 NeoSQL 서버)가 받아 사용합니다
팀원과해당 없음DB 사용자, 비밀번호와 SSL 인증서는 커넥션에 하나만 저장되어 함께 사용합니다. SSH, 프록시 인증 정보는 팀원마다 따로 입력합니다
  • OS 보안 저장소를 사용할 수 없는 환경에서 비밀값을 넣고 저장하면 자격증명이 암호화되지 않습니다 경고가 표시됩니다. 계속하면 비밀값이 기기에 평문으로 저장됩니다.
  • 계정 프로젝트에서 커넥션을 복사하면 비밀번호와 키 같은 비밀값은 복사되지 않아 복사본에서 다시 입력해야 합니다. 로컬 프로젝트는 비밀값까지 함께 복사합니다.
  • 암호화 방식과 ZK 암호화는 보안과 데이터가 나가는 곳 에서 설명합니다.

공개 커넥션과 개인 커넥션

계정 프로젝트의 커넥션은 기본적으로 팀원 모두에게 보이는 공개 커넥션입니다. 다만 기기에 묶인 커넥션은 다른 팀원의 기기에서 같은 DB 를 가리키지 않으므로 개인 커넥션으로 저장하고 만든 사람에게만 보입니다. 사용자가 선택하는 것이 아니라 접속 정보로 자동으로 정해집니다.

개인 커넥션이 되는 경우예
SQLite 커넥션모든 SQLite 파일
H2 의 파일, 메모리 DB(서버 모드가 아닌 H2)jdbc:h2:file:
호스트가 기기를 가리킬 때localhost, 127.0.0.1, ::1, 0.0.0.0
  • 사설망 주소(10.x, 192.168.x 등)는 개인 커넥션으로 보지 않습니다. 팀원들이 같은 사내망에서 같은 DB 를 사용하는 경우가 많기 때문입니다.
  • 공개 커넥션의 접속 정보를 변경해 개인 커넥션이 되면, 그 커넥션을 사용하던 팀 ERD 가 내 개인 ERD 로 변경됩니다. 다른 팀원이 있거나 변경될 팀 ERD 가 있으면 저장하기 전에 확인을 거칩니다.
  • 로컬 프로젝트에는 공개, 개인 구분이 없습니다. 팀원이 없기 때문입니다.

보안 연결: 암호화와 상대 확인은 다릅니다

커넥션 창의 SSL/SSH 탭에서 SSL/TLS 스위치를 활성화하면 DB 와 주고받는 내용이 암호화됩니다. 하지만 암호화만으로는 상대가 진짜 DB 서버인지 알 수 없습니다. 중간에서 가로채는 서버와도 암호화된 연결은 맺어지기 때문입니다. 모드는 암호화와 서버 확인을 어디까지 확인할지 정합니다.

모드암호화서버 인증서 확인호스트 이름 확인
Disable안 함안 함안 함
Prefer서버가 지원하면안 함안 함
Require함안 함안 함
Verify CA함함안 함
Verify Full함함함
  • SSL 을 처음 활성화하면 모드는 Require 모드입니다. Require 모드는 암호화만 합니다. 운영 DB 라면 CA 인증서 칸에 인증서를 넣고 Verify Full 모드를 사용하세요.
  • IP 주소, 별칭, SSH 터널로 접속하면 인증서의 호스트 이름과 접속 주소가 달라 Verify Full 모드가 실패합니다. 이때는 Verify CA 모드를 사용합니다. 거꾸로 Verify CA 모드는 성공하는데 Verify Full 모드만 실패하면 호스트 이름 문제입니다.
  • 선택할 수 있는 모드는 DBMS 마다 다릅니다. 예를 들어 MariaDB 에는 Prefer 모드가 없고, SQL Server 에는 Verify CA 모드가 없습니다. Oracle 은 모드 대신 JDBC URL 칸의 tcps 가 SSL 을 정하고, SQLite 와 H2 는 SSL 이 없습니다. DBMS 별 차이는 DBMS 별 참고 에서 설명합니다.

SSH 터널은 외부에서 바로 접속할 수 없는 DB 에 SSH 서버(배스천 호스트)를 거쳐 접속하는 방법입니다. NeoSQL 은 SSH 서버에 먼저 접속하고, 그 SSH 서버에서 본 DB 주소(원격 호스트 칸)로 연결을 넘깁니다.

  • 호스트 키 검증 항목은 처음에 비활성화되어 있습니다. 비활성화되어 있으면 SSH 서버가 변경되어도 알아채지 못하므로 운영 환경에서는 활성화하세요.
  • 웹 앱에서는 SSH 터널도 NeoSQL 서버가 엽니다. SSH 서버에 인터넷에서 접속할 수 있어야 합니다.
  • 항목별 설명은 SSL/TLS 와 SSH 터널 에서 합니다.

주의할 점

  • 이미 저장한 커넥션의 호스트나 데이터베이스를 변경하면 접속 대상 변경 확인 창이 표시됩니다. 새 DB 에 없는 테이블은 프로젝트에서 사라지고, 아직 DB 에 반영하지 않은 변경은 버려집니다. 커넥션의 ERD 는 변경하기 전 모습으로 백업 커넥션에 남습니다. 다른 DB 를 사용하려면 커넥션을 새로 만드는 편이 안전합니다.
  • SSL 설정은 SSL/SSH 탭에서 하세요. JDBC URL 칸이나 속성 탭에 SSL 관련 값을 넣으면 탭에서 관리하라는 안내가 표시됩니다.
  • 웹 앱에서 DB 에 접속할 수 없으면 NeoSQL 서버에서 DB 로 가는 길(DNS, 방화벽, 사내망)이 차단된 것입니다. 사내망 DB 는 데스크톱 앱으로 접속하세요.

관련 페이지