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 는 데스크톱 앱으로 접속하세요.
관련 페이지
- 커넥션 만들기와 수정: 커넥션 창의 탭과 칸을 하나씩 설명합니다.
- SSL/TLS 와 SSH 터널: 보안 연결과 터널, 프록시의 항목입니다.
- SQL 실행과 트랜잭션: SQL 탭이 실행 대상에서 SQL 을 실행하는 방식입니다.
- 운영 DB 안전장치: 운영 DB 커넥션에서 실수를 차단하는 장치입니다.