지원 DBMS 와 버전

NeoSQL 이 지원하는 DBMS 와 각 DBMS 의 지원 버전, 번들된 JDBC 드라이버를 정리한 표입니다.

DBMS지원 버전번들 JDBC 드라이버
MariaDB10.x / 11.xmariadb-java-client 3.0.4
MySQL5.x / 8.xmysql-connector-j 8.3.0 (8.x)
mysql-connector-java 5.1.49 (5.x)
Oracle11g / 12c / 19c / 21cojdbc8 23.3.0.23.09
PostgreSQL9.x 이상postgresql 42.7.3
SQL Server2014 / 2016 / 2017 / 2019 / 2022, Azure SQLmssql-jdbc 12.6.1.jre11
SQLite3.xsqlite-jdbc 3.45.3.0
H22.x (Embedded / Server / In-Memory)h2 2.1.214

참고: 표에 없는 버전을 사용하려면 커넥션 생성 화면의 JDBC Driver 설정에서 Add Custom Driver 로 직접 .jar 파일을 등록할 수 있습니다 (데스크톱 모드 전용).

DBMS 별 연결 가이드

NeoSQL이 지원하는 각 데이터베이스의 JDBC URL · 드라이버 · 기본 속성을 안내합니다.

MariaDB

항목값
기본 포트3306
JDBC URLjdbc:mariadb://{host}:{port}/{database}
드라이버org.mariadb.jdbc.Driver

기본 연결 속성:

  • useUnicode=true — 유니코드 지원
  • characterEncoding=utf8 — UTF-8 인코딩
  • useSSL=false — SSL 비활성화
  • allowMultiQueries=true — 다중 쿼리 허용

MySQL

항목값
기본 포트3306
JDBC URLjdbc:mysql://{host}:{port}/{database}
드라이버com.mysql.cj.jdbc.Driver

기본 연결 속성:

  • serverTimezone=Asia/Seoul — 서버 타임존 설정
  • useSSL=false — SSL 비활성화

Oracle

지원 버전: 11g / 12c / 19c / 21c

항목값
기본 포트1521
드라이버oracle.jdbc.OracleDriver
드라이버 타입thin, oci, oci8 중 선택

Oracle은 연결 방식을 선택할 수 있습니다:

연결 방식JDBC URL
Service Namejdbc:oracle:thin:@//{host}:{port}/{serviceName}
SIDjdbc:oracle:thin:@{host}:{port}:{SID}

Oracle 전용 옵션:

  • oracleRetrieveRemarks=true — 테이블/컬럼 코멘트 조회 (조회 시간이 길어질 수 있음)
  • oracleRetrieveSynonyms=false — 퍼블릭 시노님 포함 여부

PostgreSQL

항목값
기본 포트5432
JDBC URLjdbc:postgresql://{host}:{port}/{database}
드라이버org.postgresql.Driver

SQL Server

항목값
기본 포트1433
JDBC URLjdbc:sqlserver://{host}:{port};database={database}
드라이버com.microsoft.sqlserver.jdbc.SQLServerDriver

기본 연결 속성:

  • encrypt=true — 연결 암호화
  • trustServerCertificate=true — 서버 인증서 신뢰

참고: SQL Server는 연결 속성 구분자로 & 대신 ;(세미콜론)을 사용합니다.

SQLite

항목값
JDBC URLjdbc:sqlite:{파일 경로}
드라이버org.sqlite.JDBC

SQLite는 파일 기반 데이터베이스로, 별도의 서버 없이 로컬 파일에 직접 연결합니다.

  • 호스트, 포트, 사용자명, 비밀번호 입력이 필요 없습니다.
  • 데이터베이스 파일 경로만 지정하면 연결됩니다.

연결 예시:

  • jdbc:sqlite:/Users/user/data/mydb.db — 절대 경로
  • jdbc:sqlite:./data/mydb.db — 상대 경로
  • jdbc:sqlite::memory: — 메모리 기반 (휘발성)

참고: SQLite는 Desktop 모드에서만 사용할 수 있습니다. 로컬 파일 시스템 접근이 필요하기 때문에 Web App 모드에서는 지원되지 않습니다.

H2

항목값
기본 포트9092 (TCP 모드)
드라이버org.h2.Driver

H2는 연결 모드를 선택할 수 있습니다:

모드JDBC URL설명
TCPjdbc:h2:tcp://{host}:{port}/{database}네트워크를 통한 원격 접속
Embeddedjdbc:h2:{database}로컬 파일 기반 접속
In-Memoryjdbc:h2:mem:{database}메모리 기반 (휘발성)