데이터베이스 연결 창은 커넥션 하나의 DBMS 와 접속 정보, 탐색기에 보일 스키마, 접속할 때 넘길 속성을 정합니다. 커넥션이 무엇을 담고 SQL 과 ERD 가 어디에 묶이는지는 연결과 실행 대상 에서 설명합니다. 창의 탭과 칸은 아래에서 하나씩 설명합니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 탭 줄 | 아래 '탭' 표의 탭입니다. 탭 옆의 숫자는 활성화한 보안 연결, 선택한 스키마, 넣은 속성의 수입니다. |
| 2 | 연결 이름 칸과 설명 칸 | 탐색기에 보일 이름과 메모입니다. 이름은 꼭 넣어야 합니다. |
| 3 | DBMS 칸 | 커넥션의 DBMS 입니다. 저장한 커넥션은 DBMS 를 변경할 수 없습니다. |
| 4 | JDBC 드라이버 칸 | 접속에 사용할 JDBC 드라이버입니다. 옆의 톱니 버튼은 JDBC 드라이버 관리 창을 엽니다(드라이버 관리). |
| 5 | 접속 칸 | 호스트 칸, 포트 칸, 사용자 칸, 패스워드 칸, 데이터베이스 칸입니다. SQLite 같은 파일 DB 는 데이터베이스 파일 칸 하나입니다. DBMS 마다 다른 칸은 아래 '접속 칸' 에서 설명합니다. |
| 6 | JDBC URL 칸 | 접속 칸으로 만든 JDBC URL 입니다. 직접 수정할 수도 있습니다. |
| 7 | 연결 테스트 버튼 | 지금 입력으로 DB 에 접속해 보고, 성공하면 스키마 목록을 가져옵니다. 결과는 버튼 옆 아이콘으로 보입니다. |
| 8 | 초기화 버튼 | 확인을 거친 뒤 입력을 비웁니다. 아래 '주의할 점' 을 보세요. |
| 9 | 저장 버튼, 취소 버튼, 커넥션 삭제 버튼 | 저장하거나 닫습니다. 커넥션 삭제 버튼은 저장한 커넥션에만 보이고, 삭제의 영향은 객체 탐색기 에서 설명합니다. |
탭
| 탭 | 하는 일 | 사용할 수 있을 때 |
|---|---|---|
| 연결 | DBMS 와 접속 정보 | 늘 |
| SSL/SSH | SSL/TLS, SSH Tunnel, 프록시. SSL/TLS 와 SSH 터널 에서 설명합니다 | DB에 연결 버튼을 클릭한 뒤 |
| 스키마 | 탐색기에 보일 스키마 | 연결 테스트 버튼으로 스키마 목록을 받은 뒤 |
| 속성 | 접속할 때 드라이버에 넘길 속성 | DB에 연결 버튼을 클릭한 뒤 |
| 프로파일 | 환경 항목, 색상 항목, 배경 워터마크 스위치, 보호 모드 항목. 커넥션 프로파일 에서 설명합니다 | 늘 |
| 테이블 템플릿 | 새 테이블을 만들 때 미리 들어갈 컬럼 | 늘 |
| Renamer | 소스코드를 만들 때 테이블, 컬럼 이름을 클래스, 필드 이름으로 변환하는 규칙. 소스코드 생성 에서 설명합니다 | 늘 |
| 데이터 사전 | 커넥션이 사용할 도메인과 사전. 커넥션에 지정 에서 설명합니다 | 저장한 커넥션 |
- 계정 프로젝트에서 커넥션을 수정할 권한이 없는 팀원에게는 프로파일 탭만 보입니다. 프로파일은 개인 설정이기 때문입니다.
- 테이블 템플릿 탭은 처음에 기본 키 컬럼
id하나가 들어 있습니다(BIGINT에 해당하는 선택한 DBMS 의 타입, 자동 증가,NOT NULL). 공통 컬럼을 여기에 더해 두면 새 테이블마다 넣지 않아도 됩니다.
새 커넥션 만들기
- 탐색기 위의 커넥션... 버튼을 클릭합니다. 커넥션이 하나도 없으면 탐색기 가운데의 새 커넥션 만들기 버튼을 클릭해도 됩니다.
- DBMS 칸(3)에서 DBMS 를 선택합니다. DBMS 만 선택하고 저장하면 접속 정보 없이 ERD 만 그리는 커넥션이 됩니다.
- 실제 DB 에 접속하려면 DB에 연결 버튼을 클릭합니다. 접속 칸(5)이 나오고, 호스트 칸과 포트 칸에 선택한 DBMS 의 기본값이 들어갑니다.
- 접속 칸에 접속 정보를 넣습니다. JDBC URL 칸(6)이 따라 변경됩니다.
- 연결 테스트 버튼(7)을 클릭합니다. 연결에 성공했습니다. 알림이 표시되면 스키마 탭을 사용할 수 있고, 기본 스키마(MySQL, MariaDB 는 접속 칸에 넣은 데이터베이스)가 체크되어 있습니다.
- 스키마 탭에서 탐색기에 보일 스키마를 선택합니다(아래 '스키마 탭').
- 저장 버튼(9)을 클릭합니다. 저장하기 전에 확인 창이 표시될 수 있습니다(아래 '저장할 때 표시되는 확인').
- 연결 테스트 버튼으로 한 접속이 실패하면 버튼 옆에 빨간 아이콘과 DB 가 돌려준 오류가 표시됩니다. 오류가 닫힌 뒤에는 아이콘을 클릭하면 다시 보입니다.
- 접속 정보 없이 저장한 커넥션은 메뉴로 다시 열어 DB에 연결 버튼을 클릭하면 접속 정보를 넣을 수 있습니다. 그동안 그린 ERD 를 어느 스키마에 붙일지는 저장할 때 ERD 연결하기 창이 묻습니다.
- SQLite 와 H2 Embedded 파일 연결은 데스크톱 앱에서 설정합니다. 찾아보기... 버튼으로 파일을 선택하거나 새 파일... 버튼으로 새 파일을 지정합니다.
접속 칸
DBMS 에 따라 칸이 더 있거나 다릅니다. 자세한 차이는 DBMS 별 참고 에서 설명합니다.
| DBMS | 다른 칸 |
|---|---|
| 여러 접속 방식이 있는 DBMS | 연결 유형 칸, 드라이버 칸이 보입니다. 선택하면 URL 의 모양이 변경됩니다 |
| Oracle | 역할 칸에서 Normal, SYSDBA, SYSOPER 가운데 선택합니다 |
| PostgreSQL | Supabase 모드 항목이 있습니다. 호스트가 Supabase 주소이면 Supabase 로 전환 링크가 나옵니다 |
| Databricks | 데이터베이스 칸이 카탈로그 칸으로 보입니다. Warehouse 불러오기 버튼으로 호스트와 개인 액세스 토큰(패스워드 칸)으로 사용할 수 있는 SQL Warehouse 칸의 목록을 불러와 선택합니다 |
| Snowflake | Warehouse 칸, Role 칸이 있습니다. 목록 새로고침 버튼으로 데이터베이스와 Warehouse 목록을 불러옵니다. 두 값은 URL 파라미터로 들어갑니다 |
| BigQuery | 데이터베이스 칸이 프로젝트 칸으로 보입니다. 서비스 계정 키(JSON)를 패스워드 칸에 넣거나 키 파일(JSON) 불러오기 버튼으로 불러옵니다. Location 칸은 비워 두어도 됩니다 |
| SQLite, H2 Embedded | 호스트와 포트 없이 데이터베이스 파일 칸 하나입니다. 찾아보기... 버튼으로 있는 파일을 선택합니다. SQLite 는 새 파일... 버튼으로 새 파일의 위치와 이름을 정할 수 있고, 파일은 처음 접속할 때(연결 테스트 버튼 등) 만들어집니다 |
JDBC URL 과 속성
JDBC URL 칸과 속성 탭은 역할이 나뉩니다.
| JDBC URL 칸 | 속성 탭 | |
|---|---|---|
| 담는 것 | 호스트 칸, 포트 칸, 데이터베이스 칸과 내가 URL 끝에 직접 작성한 파라미터 | 키와 값의 목록 |
| 만드는 곳 | 접속 칸을 수정하면 다시 만들어집니다. 직접 작성한 파라미터는 그대로 남습니다 | DBMS 를 선택하면 선택한 DBMS 의 기본 속성(접속 시간 제한 등)이 기입됩니다. 수정하거나 삭제할 수 있습니다 |
| 접속할 때 | 그대로 드라이버에 넘깁니다 | URL 에 붙이지 않고 따로 드라이버에 넘깁니다 |
- URL 을 직접 수정하면 호스트 칸, 포트 칸, 데이터베이스 칸이 URL 에 맞춰 변경됩니다. URL 의 파라미터는 속성 탭으로 옮겨지지 않습니다.
- 속성은 연결 속성 줄에 키와 값을 넣고 추가 버튼을 클릭해 더합니다.
- SSL 관련 키를 URL 이나 속성에 넣으면 SSL/SSH 탭에서 관리하라는 안내와 경고 아이콘이 나옵니다. 값을 옮기지는 않습니다. SSL/SSH 탭에서 SSL 을 활성화하면 탭의 설정이 앞서고, 비활성화하면 속성 탭의 값이 그대로 넘어갑니다.
스키마 탭
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 스키마 접두어 사용 항목 | 소스코드를 만들 때 템플릿이 테이블 이름 앞에 스키마 이름을 붙이게 합니다. |
| 2 | 스키마 목록 새로고침 버튼 | DB 에서 스키마 목록을 다시 받습니다. DB 에 스키마를 새로 만든 뒤 클릭합니다. |
| 3 | 스키마 패턴 줄 | 지금 체크한 스키마입니다. |
| 4 | 스키마 목록 | 체크한 스키마만 탐색기에 보이고, SQL 탭과 ERD 의 실행 대상으로 선택할 수 있습니다. |
- 데이터베이스 계층이 있는 DBMS(PostgreSQL, SQL Server, Snowflake, Databricks, BigQuery)는 데이터베이스마다 묶어 보여 줍니다. 접속한 데이터베이스에는 기본 표시가 붙고, 다른 데이터베이스는 펼칠 때 스키마를 가져옵니다.
- PostgreSQL 은 처음에 접속한 데이터베이스만 보여 줍니다. 전체 데이터베이스 표시 항목을 활성화하면 접근할 수 있는 모든 데이터베이스가 목록에 나옵니다.
- 그 밖의 DBMS 는 사용자 스키마와 시스템 스키마를 따로 묶습니다. 시스템 스키마는 탐색기에서 읽기 전용으로 보이고, 탐색기의 메뉴로 스키마를 시스템 스키마로 지정할 수도 있습니다(객체 탐색기).
- 전에 선택한 스키마가 DB 에 없으면 DB에 없음 표시가 붙습니다. 스키마 매핑 버튼으로 DB 의 다른 스키마에 옮겨 붙이거나, 휴지통 버튼으로 커넥션에서 제외합니다.
저장할 때 표시되는 확인
저장 버튼을 클릭하면 상황에 따라 아래 창이 차례로 표시됩니다. 어느 창이든 취소하면 저장하지 않습니다.
| 창 | 표시되는 때 | 사용할 수 있는 곳 |
|---|---|---|
| 접속 정보 없이 저장 | DB에 연결 버튼을 클릭하지 않고 저장할 때. 나중에 접속 정보를 넣을 수 있다는 확인입니다 | 모든 프로젝트 |
| 접속 대상 변경 | 저장한 커넥션의 접속 대상을 변경할 때(아래) | 모든 프로젝트 |
| 자격증명이 암호화되지 않습니다 | 비밀값을 넣었는데 기기의 OS 보안 저장소를 사용할 수 없을 때. 계속하면 비밀값이 평문으로 저장됩니다 | 로컬 프로젝트 |
| Desktop 전용 커넥션 | 웹 앱에서 SQLite, H2 Embedded, localhost 커넥션을 저장하거나 테스트할 때. 진행하지 않습니다 | 웹 앱 |
| 비공개 커넥션으로 전환, 공개 커넥션으로 전환 | 접속 정보가 변경되어 공개 커넥션과 개인 커넥션 사이를 오갈 때. 팀 ERD 가 개인 ERD 로 변경되면 변경되는 ERD 목록이 보입니다 | 계정 프로젝트 |
공개 커넥션과 개인 커넥션이 정해지는 규칙은 연결과 실행 대상 에서 설명합니다.
접속 대상 변경하기
호스트 칸, 포트 칸, 데이터베이스 칸, JDBC 드라이버 칸이나 JDBC URL 칸(파라미터 제외)을 변경하면 다른 DB 를 가리키는 것으로 봅니다. 저장한 커넥션에 테이블이나 ERD 가 있으면 접속 대상 변경 창이 표시됩니다.
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 안내 | 새 DB 에 없는 테이블은 사라집니다. ERD 가 백업될 커넥션 이름과, DB 에 반영하지 않아 버려질 변경이 있는 테이블 이름이 함께 보입니다. |
| 2 | ERD 보존 항목 | 활성화해 두면 ERD 를 새 DB 기준으로 다시 그립니다(노드 배치는 처음으로 돌아갑니다). 비활성화하면 ERD 를 삭제하고 백업본만 남깁니다. ERD 가 있을 때만 보입니다. |
| 3 | 취소 버튼과 확인 버튼 | 취소하면 커넥션을 저장하지 않습니다. |
확인한 뒤에는 전에 선택한 스키마를 새 DB 의 어느 스키마에 붙일지 스키마 매핑 창이 묻습니다. 같은 이름의 스키마가 미리 선택되어 있고, 선택하지 않은 스키마는 커넥션에서 빠집니다. SSL 설정, 속성, 비밀번호만 변경할 때는 접속 대상 변경 창이 표시되지 않습니다.
커넥션 복사하기
- 탐색기에서 커넥션을 우클릭하고 메뉴를 클릭합니다. 데이터베이스 연결 복사 창이 원본의 설정이 자동 기입된 상태로 열리고, 이름 뒤에 (복사본) 표시가 붙습니다.
- 이름과 다른 점을 수정합니다.
- 계정 프로젝트이면 비밀번호와 SSL, SSH, 프록시의 비밀값을 다시 넣습니다. 창 위의 비밀번호·SSL 키·SSH/프록시 인증정보 같은 비밀값은 복사되지 않습니다. 다시 입력해 주세요. 안내가 알려 줍니다.
- 연결 테스트 버튼으로 스키마 목록을 받고 저장 버튼을 클릭합니다.
- 복사본은 원본의 AI 설정, 데이터 사전 지정, 원본에 불러 둔 테이블(아직 DB 에 없는 가상 테이블 포함)을 가져오지 않습니다. 커넥션 프로파일은 가져옵니다.
- 로컬 프로젝트에서는 비밀값까지 복사됩니다.
주의할 점
- 저장한 커넥션의 DBMS 는 변경할 수 없습니다. 다른 DBMS 로 옮기려면 새 커넥션을 만드세요.
- 다른 DB 를 사용하려고 기존 커넥션의 호스트나 데이터베이스를 변경하면, 새 DB 에 없는 테이블과 반영하지 않은 변경이 사라집니다. 같은 설계를 다른 DB 에도 사용하려면 메뉴로 커넥션을 복사하세요.
- 초기화 버튼은 접속 대상(호스트, 포트, JDBC 드라이버 칸, 데이터베이스, URL)과 계정만 비웁니다. 연결 이름 칸과 설명, 속성 탭, SSL/SSH 탭, 테이블 템플릿 탭의 설정은 그대로 둡니다. 잘못 눌렀으면 저장하지 말고 취소 버튼으로 창을 닫으세요.