커넥션 생성

데이터베이스 연결 정보를 설정하고 커넥션을 생성하는 방법을 안내합니다.

커넥션 추가

프로젝트에 새 데이터베이스 커넥션을 추가합니다.

1

커넥션 추가 버튼 클릭

좌측 패널의 커넥션 목록에서 "+" 버튼을 클릭합니다.

2

DBMS 선택

연결할 데이터베이스 종류를 선택합니다. MariaDB, MySQL, Oracle, PostgreSQL, SQL Server, SQLite, H2를 지원합니다.

3

연결 정보 입력

호스트, 포트, 데이터베이스명, 사용자명, 비밀번호를 입력합니다.

4

연결 테스트 및 저장

"연결 테스트" 버튼으로 연결을 확인한 후 "저장" 버튼을 클릭합니다.

커넥션 생성

연결 정보 항목

커넥션 생성 시 입력하는 항목의 상세 설명입니다.

항목설명예시
커넥션 이름구분을 위한 표시 이름개발DB, 운영DB
호스트데이터베이스 서버 주소localhost, 192.168.1.100
포트데이터베이스 서비스 포트3306 (MySQL), 5432 (PostgreSQL)
데이터베이스연결할 데이터베이스(스키마) 이름myapp_dev
사용자명데이터베이스 접속 계정root, admin
비밀번호접속 계정의 비밀번호-

데이터베이스별 연결 설정

NeoSQL이 지원하는 각 데이터베이스의 연결 설정을 안내합니다.

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

항목값
기본 포트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}메모리 기반 (휘발성)

연결 테스트

입력한 연결 정보가 올바른지 저장 전에 확인합니다.

참고: 연결 테스트 실패 시 호스트 주소, 포트, 방화벽 설정, 데이터베이스 접속 권한을 확인하세요.