DBCPConnectionPool
DBCPConnectionPool
데이터베이스 커넥션 풀링 서비스를 제공하는 OpenFlow 컨트롤러 서비스예요.
출처: 문서
본문
기능 — 일반 공개(Generally Available)
Openflow Snowflake 배포는 AWS, Azure, GCP 상용(Commercial) 지역의 모든 계정에서 사용할 수 있어요. Openflow BYOC 배포는 AWS 상용 지역의 모든 계정에서 사용할 수 있어요.
설명 (Description)
데이터베이스 커넥션 풀링 서비스를 제공해요. 풀에서 연결을 요청하고 사용 후 반환할 수 있어요.
태그 (Tags)
connection, database, dbcp, jdbc, pooling, store
속성 (Properties)
아래 목록에서 필수 속성은 별표(*)로 표시돼요. 그 외 속성은 선택 사항으로 간주돼요. 표에는 기본값과 해당 속성이 NiFi Expression Language를 지원하는지 여부도 함께 표시돼요.
| 표시 이름 (Display Name) | API 이름 (API Name) | 기본값 (Default Value) | 허용 값 (Allowable Values) | 설명 (Description) |
|---|---|---|---|---|
| Database Connection URL * | Database Connection URL | 데이터베이스에 연결하는 데 사용하는 데이터베이스 연결 URL이에요. 데이터베이스 시스템 이름, 호스트, 포트, 데이터베이스 이름 및 일부 매개변수를 포함할 수 있어요. 데이터베이스 연결 URL의 정확한 구문은 DBMS에 의해 지정돼요. | ||
| Database Driver Class Name * | Database Driver Class Name | 데이터베이스 드라이버 클래스 이름이에요. | ||
| Database Driver Location(s) | Database Driver Location(s) | 드라이버 JAR 및 그 의존성(있는 경우)이 포함된 파일/폴더 및/또는 URL의 쉼표로 구분된 목록이에요. 예: '/var/tmp/mariadb-java-client-1.1.7.jar' | ||
| Database User | Database User | 데이터베이스 사용자 이름이에요. | ||
| Kerberos User Service | Kerberos User Service | Kerberos로 인증하는 데 사용해야 하는 Kerberos User Controller Service를 지정해요. | ||
| Max Total Connections * | Max Total Connections | 8 | 이 풀에서 동시에 할당할 수 있는 최대 활성 연결 수예요. 음수이면 제한이 없어요. | |
| Max Wait Time * | Max Wait Time | 500 millis | 풀이 (사용 가능한 연결이 없을 때) 연결이 반환되기를 기다리는 최대 시간이에요. 초과하면 실패하고, -1이면 무기한 기다려요. | |
| Maximum Connection Lifetime | Maximum Connection Lifetime | -1 | 연결의 최대 수명이에요. 이 시간이 지나면 연결은 다음 활성화(activation), 비활성화(passivation) 또는 검증 테스트에서 실패해요. 0 이하의 값은 연결 수명이 무한함을 의미해요. | |
| Maximum Idle Connections | Maximum Idle Connections | 8 | 추가 연결이 해제되지 않고 풀에서 유휴 상태로 남을 수 있는 최대 연결 수예요. 음수 값으로 설정하면 무제한 유휴 연결을 허용해요. | |
| Minimum Evictable Idle Time | Minimum Evictable Idle Time | 30 mins | 연결이 퇴출(eviction) 대상이 되기 전에 풀에서 유휴 상태로 있을 수 있는 최소 시간이에요. | |
| Minimum Idle Connections | Minimum Idle Connections | 0 | 추가 연결이 생성되지 않고 풀에서 유휴 상태로 남을 수 있는 최소 연결 수예요. 0 또는 이하로 설정하면 유휴 연결을 허용하지 않아요. | |
| Password | Password | 데이터베이스 사용자의 비밀번호예요. | ||
| Soft Minimum Evictable Idle Time | Soft Minimum Evictable Idle Time | -1 | 유휴 연결 퇴출기가 연결을 퇴출하기 전에 연결이 풀에서 유휴 상태로 있을 수 있는 최소 시간이에요. 단, 풀에 최소 유휴 연결 수가 남아 있다는 추가 조건이 있어요. 이 옵션의 비-소프트(non-soft) 버전이 양수로 설정되면 유휴 연결 퇴출기가 먼저 검사해요: 퇴출기가 유휴 연결을 방문할 때 유휴 시간을 (풀의 유휴 연결 수를 고려하지 않고) 먼저 그 값과 비교한 다음, 최소 유휴 연결 제약 조건을 포함하여 이 소프트 옵션과 비교해요. | |
| Time Between Eviction Runs | Time Between Eviction Runs | -1 | 유휴 연결 퇴출기 스레드 실행 사이에 대기하는 기간이에요. 양수 이하이면 유휴 연결 퇴출기 스레드가 실행되지 않아요. | |
| Validation Query | Validation Query | 연결을 반환하기 전에 검증하는 데 사용하는 검증 쿼리예요. 연결이 유효하지 않으면 삭제되고 새 유효한 연결이 반환돼요. 참고: 검증을 사용하면 성능 저하가 있을 수 있어요. |
상태 관리 (State management)
이 컴포넌트는 상태를 저장하지 않아요.
제한 (Restricted)
이 컴포넌트에는 제한(restriction)이 있어요.
| 필수 권한 (Required Permission) | 설명 (Explanation) |
|---|---|
| reference remote resources | Database Driver Location은 HTTP를 통해 리소스를 참조할 수 있어요. |
시스템 리소스 고려 사항 (System Resource Considerations)
이 컴포넌트는 시스템 리소스 고려 사항을 지정하지 않아요.