화면: 연결과 탐색기

드라이버 관리

JDBC 드라이버 관리 창은 DBMS 마다 앱에 들어 있는 기본 JDBC 드라이버를 보여 주고, 다른 버전이나 다른 회사의 드라이버 JAR 파일을 커스텀 드라이버로 더합니다. 더한 드라이버는 커넥션 창의 JDBC 드라이버 칸에서 선택합니다. 드라이버를 더할 수 있는 것은 데스크톱 앱뿐입니다. 웹 앱은 NeoSQL 서버에 들어 있는 기본 드라이버로만 접속합니다.

사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트

화면 구성

번호이름설명
1DBMS 목록드라이버가 있는 DBMS 입니다. 클릭하면 오른쪽에 선택한 DBMS 의 드라이버가 보입니다.
2드라이버 표드라이버의 이름, 버전, 드라이버 클래스입니다.
3기본 열새 커넥션에서 DBMS 를 선택하면 먼저 선택되는 드라이버에 기본 표시가 붙습니다.
4유형 열앱에 들어 있는 드라이버는 기본 제공 표시, 내가 더한 드라이버는 사용자 지정 표시입니다. 커스텀 드라이버에만 휴지통 버튼이 있습니다.
5사용자 지정 드라이버 추가 버튼커스텀 드라이버를 더하는 창을 엽니다(아래).
  • 창은 커넥션 창의 JDBC 드라이버 칸 옆 톱니 버튼으로 엽니다. 웹 앱에서도 창은 열려 기본 드라이버를 볼 수 있지만, 사용자 지정 드라이버 추가 버튼을 클릭하면 커스텀 드라이버 추가는 데스크톱 버전에서만 지원됩니다. 안내가 표시됩니다.
  • 기본 드라이버는 삭제하거나 변경할 수 없습니다.
  • MySQL 에는 기본으로 선택되는 MySQL 8 드라이버 말고 옛 서버용 MySQL 5 (Legacy) 드라이버도 들어 있습니다.

커스텀 드라이버 더하기

번호이름설명
1DBMS Type 칸드라이버로 접속할 DBMS 입니다. 관리 창에서 선택한 DBMS 로 시작합니다.
2Driver ID 칸드라이버를 구별하는 이름입니다. 이미 있는 ID 는 사용할 수 없고, 칸을 벗어나면 바로 확인합니다.
3Label 칸커넥션 창의 드라이버 목록에 보일 이름입니다.
4Driver Class 칸JAR 안의 JDBC 드라이버 클래스 이름입니다(예: oracle.jdbc.OracleDriver).
5Version 칸목록에 함께 보일 버전입니다. 비워 두어도 됩니다.
6JAR Files드라이버 JAR 파일을 드래그 앤 드롭하거나 클릭해서 선택합니다. 여러 파일을 함께 업로드할 수 있고, .jar 파일만 받습니다.
  1. 커넥션 창에서 JDBC 드라이버 칸 옆 톱니 버튼을 클릭해 JDBC 드라이버 관리 창을 엽니다.
  2. DBMS 목록에서 드라이버를 더할 DBMS 를 선택하고 사용자 지정 드라이버 추가 버튼을 클릭합니다.
  3. Driver ID 칸, Label 칸, Driver Class 칸을 채웁니다. 드라이버 클래스 이름은 드라이버 문서에서 확인하세요.
  4. JAR 파일을 JAR Files 영역(6)에 놓습니다. 드라이버가 다른 JAR 를 필요로 하면 함께 드롭합니다.
  5. 저장 버튼을 클릭합니다. 창이 닫히고 드라이버 표에 사용자 지정 표시와 함께 보입니다.
  6. 커넥션 창의 JDBC 드라이버 칸에서 새 드라이버를 선택하고 연결 테스트 버튼을 클릭합니다.
  • 커스텀 드라이버의 JAR 는 기기의 NeoSQL 설정 폴더에 저장됩니다. 다른 기기로 옮겨지지 않습니다.
  • 커넥션에는 선택한 드라이버의 ID, 이름, 클래스, 버전이 함께 저장됩니다.

다른 기기에 드라이버가 없을 때

계정 프로젝트를 다른 기기에서 열거나 팀원이 열면, 커넥션이 사용하는 커스텀 드라이버가 열어 본 기기에 없을 수 있습니다.

  • 데스크톱 앱은 프로젝트를 열 때 누락된 드라이버 설치 창을 띄웁니다. 커넥션에 저장된 드라이버 정보가 자동 기입되어 있으므로 JAR 파일만 드래그 앤 드롭하고 저장합니다. 번들된 기본 드라이버의 JAR로 대체 항목을 선택하면 JAR 대신 같은 DBMS 의 기본 드라이버를 같은 ID 로 복사해 등록합니다. 건너뛰기 버튼으로 넘길 수도 있습니다.
  • 넘긴 커넥션은 탐색기에 경고 아이콘이 붙습니다. 접속할 때는 같은 드라이버 클래스를 사용하는 기본 드라이버를 찾아 사용합니다. 클래스 이름이 기본 드라이버와 다르면 접속하지 못하니 드라이버를 설치하거나 커넥션 창에서 기본 드라이버로 변경하세요.
  • 웹 앱은 커넥션에 지정한 드라이버와 같은 클래스를 사용하는 기본 드라이버로 접속합니다. 커넥션 창의 JDBC 드라이버 칸에 누락 표시와 웹 환경에서는 커스텀 드라이버를 추가할 수 없습니다. 같은 드라이버 클래스의 번들 드라이버가 있으면 그것으로 접속하고, 없으면 접속할 수 없습니다. 안내가 보이고, 같은 드라이버 클래스를 사용하는 기본 드라이버로 접속합니다.

주의할 점

  • 휴지통 버튼을 클릭하면 드라이버 삭제 창이 표시됩니다. 열어 둔 프로젝트에 그 드라이버를 사용하는 커넥션이 있으면 창에 프로젝트와 커넥션 이름이 보입니다. 열지 않은 프로젝트의 커넥션은 확인하지 않습니다. 삭제한 드라이버를 선택한 커넥션은 드라이버가 없는 상태가 되므로, 삭제하기 전에 커넥션의 드라이버를 기본 드라이버로 변경하세요.
  • 기본 드라이버가 접속하는 DB 라면 커스텀 드라이버를 더할 필요가 없습니다. 오래된 DB 버전이 새 드라이버를 받지 않을 때처럼 특정 버전이 꼭 필요할 때 더하세요.
  • 드라이버 클래스 이름이 틀리면 저장은 되지만 연결 테스트 버튼으로 접속하면 실패합니다.

관련 화면