JDBC 드라이버 관리 창은 DBMS 마다 앱에 들어 있는 기본 JDBC 드라이버를 보여 주고, 다른 버전이나 다른 회사의 드라이버 JAR 파일을 커스텀 드라이버로 더합니다. 더한 드라이버는 커넥션 창의 JDBC 드라이버 칸에서 선택합니다. 드라이버를 더할 수 있는 것은 데스크톱 앱뿐입니다. 웹 앱은 NeoSQL 서버에 들어 있는 기본 드라이버로만 접속합니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | DBMS 목록 | 드라이버가 있는 DBMS 입니다. 클릭하면 오른쪽에 선택한 DBMS 의 드라이버가 보입니다. |
| 2 | 드라이버 표 | 드라이버의 이름, 버전, 드라이버 클래스입니다. |
| 3 | 기본 열 | 새 커넥션에서 DBMS 를 선택하면 먼저 선택되는 드라이버에 기본 표시가 붙습니다. |
| 4 | 유형 열 | 앱에 들어 있는 드라이버는 기본 제공 표시, 내가 더한 드라이버는 사용자 지정 표시입니다. 커스텀 드라이버에만 휴지통 버튼이 있습니다. |
| 5 | 사용자 지정 드라이버 추가 버튼 | 커스텀 드라이버를 더하는 창을 엽니다(아래). |
- 창은 커넥션 창의 JDBC 드라이버 칸 옆 톱니 버튼으로 엽니다. 웹 앱에서도 창은 열려 기본 드라이버를 볼 수 있지만, 사용자 지정 드라이버 추가 버튼을 클릭하면 커스텀 드라이버 추가는 데스크톱 버전에서만 지원됩니다. 안내가 표시됩니다.
- 기본 드라이버는 삭제하거나 변경할 수 없습니다.
- MySQL 에는 기본으로 선택되는 MySQL 8 드라이버 말고 옛 서버용 MySQL 5 (Legacy) 드라이버도 들어 있습니다.
커스텀 드라이버 더하기
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | DBMS Type 칸 | 드라이버로 접속할 DBMS 입니다. 관리 창에서 선택한 DBMS 로 시작합니다. |
| 2 | Driver ID 칸 | 드라이버를 구별하는 이름입니다. 이미 있는 ID 는 사용할 수 없고, 칸을 벗어나면 바로 확인합니다. |
| 3 | Label 칸 | 커넥션 창의 드라이버 목록에 보일 이름입니다. |
| 4 | Driver Class 칸 | JAR 안의 JDBC 드라이버 클래스 이름입니다(예: oracle.jdbc.OracleDriver). |
| 5 | Version 칸 | 목록에 함께 보일 버전입니다. 비워 두어도 됩니다. |
| 6 | JAR Files | 드라이버 JAR 파일을 드래그 앤 드롭하거나 클릭해서 선택합니다. 여러 파일을 함께 업로드할 수 있고, .jar 파일만 받습니다. |
- 커넥션 창에서 JDBC 드라이버 칸 옆 톱니 버튼을 클릭해 JDBC 드라이버 관리 창을 엽니다.
- DBMS 목록에서 드라이버를 더할 DBMS 를 선택하고 사용자 지정 드라이버 추가 버튼을 클릭합니다.
- Driver ID 칸, Label 칸, Driver Class 칸을 채웁니다. 드라이버 클래스 이름은 드라이버 문서에서 확인하세요.
- JAR 파일을 JAR Files 영역(6)에 놓습니다. 드라이버가 다른 JAR 를 필요로 하면 함께 드롭합니다.
- 저장 버튼을 클릭합니다. 창이 닫히고 드라이버 표에 사용자 지정 표시와 함께 보입니다.
- 커넥션 창의 JDBC 드라이버 칸에서 새 드라이버를 선택하고 연결 테스트 버튼을 클릭합니다.
- 커스텀 드라이버의 JAR 는 기기의 NeoSQL 설정 폴더에 저장됩니다. 다른 기기로 옮겨지지 않습니다.
- 커넥션에는 선택한 드라이버의 ID, 이름, 클래스, 버전이 함께 저장됩니다.
다른 기기에 드라이버가 없을 때
계정 프로젝트를 다른 기기에서 열거나 팀원이 열면, 커넥션이 사용하는 커스텀 드라이버가 열어 본 기기에 없을 수 있습니다.
- 데스크톱 앱은 프로젝트를 열 때 누락된 드라이버 설치 창을 띄웁니다. 커넥션에 저장된 드라이버 정보가 자동 기입되어 있으므로 JAR 파일만 드래그 앤 드롭하고 저장합니다. 번들된 기본 드라이버의 JAR로 대체 항목을 선택하면 JAR 대신 같은 DBMS 의 기본 드라이버를 같은 ID 로 복사해 등록합니다. 건너뛰기 버튼으로 넘길 수도 있습니다.
- 넘긴 커넥션은 탐색기에 경고 아이콘이 붙습니다. 접속할 때는 같은 드라이버 클래스를 사용하는 기본 드라이버를 찾아 사용합니다. 클래스 이름이 기본 드라이버와 다르면 접속하지 못하니 드라이버를 설치하거나 커넥션 창에서 기본 드라이버로 변경하세요.
- 웹 앱은 커넥션에 지정한 드라이버와 같은 클래스를 사용하는 기본 드라이버로 접속합니다. 커넥션 창의 JDBC 드라이버 칸에 누락 표시와 웹 환경에서는 커스텀 드라이버를 추가할 수 없습니다. 같은 드라이버 클래스의 번들 드라이버가 있으면 그것으로 접속하고, 없으면 접속할 수 없습니다. 안내가 보이고, 같은 드라이버 클래스를 사용하는 기본 드라이버로 접속합니다.
주의할 점
- 휴지통 버튼을 클릭하면 드라이버 삭제 창이 표시됩니다. 열어 둔 프로젝트에 그 드라이버를 사용하는 커넥션이 있으면 창에 프로젝트와 커넥션 이름이 보입니다. 열지 않은 프로젝트의 커넥션은 확인하지 않습니다. 삭제한 드라이버를 선택한 커넥션은 드라이버가 없는 상태가 되므로, 삭제하기 전에 커넥션의 드라이버를 기본 드라이버로 변경하세요.
- 기본 드라이버가 접속하는 DB 라면 커스텀 드라이버를 더할 필요가 없습니다. 오래된 DB 버전이 새 드라이버를 받지 않을 때처럼 특정 버전이 꼭 필요할 때 더하세요.
- 드라이버 클래스 이름이 틀리면 저장은 되지만 연결 테스트 버튼으로 접속하면 실패합니다.
관련 화면
- 커넥션 만들기와 수정: JDBC 드라이버 칸에서 드라이버를 선택합니다.
- 웹과 데스크톱: 데스크톱 앱에서만 지원하는 기능입니다.
- DBMS 별 참고: DBMS 마다 들어 있는 기본 드라이버입니다.