SimpleDatabaseLookupService
SimpleDatabaseLookupService (간단한 데이터베이스 조회 서비스)
SimpleDatabaseLookupService는 관계형 데이터베이스(RDBMS) 기반의 조회 컨트롤러 서비스예요. 조회 키가 데이터베이스에서 발견되면 지정한 조회 값 열(lookup value column)의 값을 반환해요. 각 조회마다 값이 하나만 반환되며, 중복된 데이터베이스 항목은 무시돼요.
출처: Snowflake 문서
본문
기능 — 일반 사용 가능 (Generally Available)
- Openflow Snowflake Deployments는 AWS, Azure, GCP의 Commercial 리전에 있는 모든 계정에서 사용할 수 있어요.
- Openflow BYOC 배포는 AWS Commercial 리전의 모든 계정에서 사용할 수 있어요.
설명 (Description)
관계형 데이터베이스 기반 조회 서비스예요. 조회 키가 데이터베이스에서 발견되면 지정된 조회 값 열을 반환해요. 각 조회마다 값이 하나만 반환되며, 중복된 데이터베이스 항목은 무시돼요.
태그 (Tags)
cache, database, enrich, join, key, lookup, rdbms, reloadable, value
속성 (Properties)
아래 목록에서 필수 속성(Properties)은 별표(*)로 표시돼요. 나머지 속성은 선택 사항이에요. 표는 각 속성의 기본값과 NiFi Expression Language 지원 여부도 함께 보여줘요.
| 표시 이름 | API 이름 | 기본값 | 허용 값 | 설명 |
|---|---|---|---|---|
| Cache Expiration | Cache Expiration | 모든 캐시 항목을 비우는 시간 간격이에요. Cache Size가 0이면 이 속성은 무시돼요. | ||
| Cache Size * | dbrecord-lookup-cache-size | 0 | 얼마나 많은 조회 값/레코드를 캐시할지 지정해요. 캐시는 모든 테이블에서 공유되며, 조회 값을 레코드로 매핑한 맵을 유지해요. 이 속성을 0으로 설정하면 캐싱을 하지 않고 각 레코드의 각 조회 값마다 테이블을 조회해요. 조회 테이블이 자주 바뀌거나 가장 최신 데이터를 가져와야 한다면 캐시를 사용하지 마세요. | |
| Clear Cache on Enabled * | dbrecord-lookup-clear-cache-on-enabled | true | true false |
이 서비스가 활성화될 때 캐시를 비울지 여부예요. Cache Size가 0이면 이 속성은 무시돼요. 서비스가 활성화될 때 캐시를 비우면 서비스가 먼저 데이터베이스에서 가장 최신 데이터를 가져오도록 보장해요. |
| Database Connection Pooling Service * | dbrecord-lookup-dbcp-service | 데이터베이스에 대한 연결을 얻는 데 사용하는 Controller Service예요. | ||
| Lookup Key Column * | dbrecord-lookup-key-column | 테이블에서 조회 키 역할을 하는 열이에요. 조회 프로세서에 지정된 속성과 일치시킬 열이에요. 데이터베이스에 따라 대소문자를 구분할 수 있으니 주의하세요. | ||
| Table Name * | dbrecord-lookup-table-name | 조회할 데이터베이스 테이블의 이름이에요. 데이터베이스에 따라 대소문자를 구분할 수 있으니 주의하세요. | ||
| Lookup Value Column * | lookup-value-column | 조회 값이 일치할 때 값을 반환할 열이에요. |
상태 관리 (State management)
이 컴포넌트는 상태(state)를 저장하지 않아요.
제한 (Restricted)
이 컴포넌트는 제한되지 않아요.
시스템 리소스 고려 사항 (System Resource Considerations)
이 컴포넌트는 별도 시스템 리소스 고려 사항이 없어요.