지원 DBMS 와 버전

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

DBMS지원 버전번들 JDBC 드라이버
PostgreSQL9.x이상
postgresql 42.7.3
MySQL5.x / 8.x
mysql-connector-j 8.3.0 (8.x)
mysql-connector-java 5.1.49 (5.x)
MariaDB10.x / 11.x
mariadb-java-client 3.0.4
Oracle11g / 12c / 19c / 21c
ojdbc8 23.3.0.23.09
SQL Server2014 / 2016 / 2017 / 2019 / 2022, Azure SQL
mssql-jdbc 12.6.1.jre11
SQLite3.x
sqlite-jdbc 3.45.3.0
H22.x (Embedded / Server / In-Memory)
h2 2.1.214
DatabricksSQL Warehouse (AWS, Unity Catalog)
databricks-jdbc 3.4.2
SnowflakeCloud Service
snowflake-jdbc 4.3.4

참고: 표에 없는 버전을 사용하려면 커넥션 생성 화면의 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}메모리 기반 (휘발성)

Databricks

Databricks on AWS의 Unity Catalog 기반 SQL Warehouse(Serverless / Pro / Classic)에 PAT 인증으로 연결합니다.

항목값
기본 포트443
JDBC URLjdbc:databricks://{host}:443;transportMode=http;ssl=1;AuthMech=3;httpPath=/sql/1.0/warehouses/{warehouseId}
드라이버com.databricks.client.jdbc.Driver
  • 호스트에는 워크스페이스 hostname, 사용자명에는 token, 비밀번호에는 PAT 값을 입력합니다.
  • 접근 가능한 SQL Warehouse를 조회해 선택하면 httpPath가 URL에 반영됩니다. JDBC URL을 직접 입력할 때는 Warehouse의 Connection details에 표시된 httpPath를 사용하세요.
  • Database는 Unity Catalog의 catalog에 해당하며 ConnCatalog로 전달됩니다. Schema는 ConnSchema로 지정합니다. URL에 이미 포함된 속성은 추가 속성에 중복 입력하지 마세요.

Snowflake

Snowflake 계정에 연결합니다. Database와 Schema를 선택하고, 쿼리 실행에 사용할 Warehouse와 Role을 지정합니다.

항목값
기본 포트443
JDBC URLjdbc:snowflake://{host}/?db={database}&schema={schema}&warehouse={warehouse}&role={role}
드라이버net.snowflake.client.api.driver.SnowflakeDriver
  • 호스트에는 계정 주소(<orgname>-<account_name>.snowflakecomputing.com), 사용자명에는 Snowflake 사용자명, 비밀번호에는 Programmatic Access Token(PAT)을 입력합니다.
  • 연결 화면의 Warehouse와 Role은 JDBC URL의 warehouse·role 속성에 반영됩니다. 중지된 warehouse는 쿼리 실행 시 자동으로 시작되어 크레딧이 소모될 수 있습니다.
  • Database는 Snowflake database에 해당합니다. JDBC URL을 직접 입력할 때는 db·schema로 기본 조회 범위를 지정할 수 있습니다. 추가 속성에는 URL에 이미 지정한 값을 중복 입력하지 마세요.