HikariCPConnectionPool
HikariCPConnectionPool (HikariCP 기반 데이터베이스 연결 풀)
HikariCP를 기반으로 데이터베이스 연결 풀링(Database Connection Pooling) 서비스를 제공하는 컨트롤러 서비스예요. 풀에서 커넥션을 받아 쓰고, 사용이 끝나면 다시 풀로 돌려줄 수 있어요.
출처: 문서
본문
설명
HikariCP 기반의 데이터베이스 커넥션 풀링 서비스를 제공해요. 풀에서 커넥션을 요청해 사용하고, 사용이 끝나면 다시 반환할 수 있어요.
태그
connection, database, dbcp, hikari, jdbc, pooling, store
속성 (Properties)
아래 목록에서 필수 속성은 별표(*)로 표시했어요. 그 외 속성은 선택 사항이고, 표에는 기본값과 NiFi Expression Language 지원 여부도 함께 나와 있어요.
| 표시 이름 | API 이름 | 기본값 | 허용 값 | 설명 |
|---|---|---|---|---|
| Database Connection URL * | hikaricp-connection-url |
데이터베이스에 연결하는 데 사용하는 커넥션 URL이에요. 데이터베이스 시스템 이름, 호스트, 포트, 데이터베이스 이름과 일부 파라미터를 포함할 수 있어요. 커넥션 URL의 정확한 문법은 DBMS가 지정해요. | ||
| Database Driver Class Name * | hikaricp-driver-classname |
JDBC 드라이버의 정규화된(full-qualified) 클래스 이름이에요. 예: com.mysql.jdbc.Driver |
||
| Database Driver Location(s) | hikaricp-driver-locations |
드라이버 JAR와 그 의존성(있는 경우)을 포함하는 파일/폴더 및/또는 URL의 쉼표로 구분된 목록이에요. 예: /var/tmp/mariadb-java-client-1.1.7.jar |
||
| Kerberos User Service | hikaricp-kerberos-user-service |
Kerberos 인증에 사용할 Kerberos User Controller Service를 지정해요. | ||
| Max Connection Lifetime | hikaricp-max-conn-lifetime |
-1 |
커넥션의 최대 수명이에요. 이 시간을 초과하면 다음 활성화(activation), 수동화(passivation) 또는 검증(validation) 테스트에서 커넥션이 실패해요. 0 이하 값은 커넥션 수명이 무한함을 뜻해요. | |
| Max Total Connections * | hikaricp-max-total-conns |
10 |
풀이 도달할 수 있는 최대 크기를 제어해요. 유휴(idle) 상태와 사용 중(in-use) 커넥션을 모두 포함해요. 기본적으로 데이터베이스 백엔드로의 실제 커넥션 최대 개수를 결정해요. 합리적인 값은 실행 환경에 따라 달라져요. 풀이 이 크기에 도달하고 유휴 커넥션이 없으면, 서비스는 connectionTimeout 밀리초 동안 블록한 뒤 타임아웃돼요. | |
| Max Wait Time * | hikaricp-max-wait-time |
500 millis |
사용 가능한 커넥션이 없을 때 풀이 커넥션이 반환되기를 기다리는 최대 시간이에요. 실패하거나, 0 <time units>이면 무기한 기다려요. |
|
| Minimum Idle Connections * | hikaricp-min-idle-conns |
10 |
HikariCP가 풀에서 유지하려는 최소 유휴 커넥션 수를 제어해요. 유휴 커넥션이 이 값 아래로 떨어지고 풀의 전체 커넥션이 'Max Total Connections'보다 적으면, HikariCP는 추가 커넥션을 빠르고 효율적으로 만들기 위해 최선을 다해요. 이 속성은 'Max Total Connections'와 같게 설정하는 것을 권장해요. | |
| Password | hikaricp-password |
데이터베이스 사용자의 비밀번호예요. | ||
| Database User | hikaricp-username |
데이터베이스 사용자 이름이에요. | ||
| Validation Query | hikaricp-validation-query |
커넥션을 반환하기 전에 검증하는 데 사용하는 검증 쿼리예요. 커넥션이 유효하지 않으면 버려지고 새로운 유효한 커넥션을 반환해요. 참고: 검증을 사용하면 성능에 약간의 비용이 있을 수 있어요. |
상태 관리
이 컴포넌트는 상태를 저장하지 않아요.
제한 사항 (Restricted)
필요 권한
| 필요 권한 | 설명 |
|---|---|
| reference remote resources | Database Driver Location이 HTTP를 통해 리소스를 참조할 수 있어요. |
시스템 리소스 고려 사항
이 컴포넌트는 시스템 리소스 고려 사항을 지정하지 않아요.