DatabaseRecordLookupService
DatabaseRecordLookupService
테이블에서 레코드를 조회해 반환하는 관계형 데이터베이스 기반 조회 서비스예요.
출처: 문서
본문
기능 — 일반 공개(Generally Available)
Openflow Snowflake 배포는 AWS, Azure, GCP 상용(Commercial) 지역의 모든 계정에서 사용할 수 있어요. Openflow BYOC 배포는 AWS 상용 지역의 모든 계정에서 사용할 수 있어요.
설명 (Description)
관계형 데이터베이스 기반 조회 서비스예요. 데이터베이스에서 조회 키를 찾으면 지정된 열(Lookup Value Columns가 지정되지 않은 경우 전체)을 Record로 반환해요. 각 조회에 대해 한 행만 반환되며 중복 데이터베이스 항목은 무시돼요.
태그 (Tags)
cache, database, enrich, join, key, lookup, rdbms, record, reloadable, value
속성 (Properties)
아래 목록에서 필수 속성은 별표(*)로 표시돼요. 그 외 속성은 선택 사항으로 간주돼요. 표에는 기본값과 해당 속성이 NiFi Expression Language를 지원하는지 여부도 함께 표시돼요.
| 표시 이름 (Display Name) | API 이름 (API Name) | 기본값 (Default Value) | 허용 값 (Allowable Values) | 설명 (Description) |
|---|---|---|---|---|
| Cache Expiration | Cache Expiration | 모든 캐시 항목을 지우는 시간 간격이에요. Cache Size가 0이면 이 속성은 무시돼요. | ||
| Default Decimal Precision * | Default Decimal Precision | 10 | DECIMAL/NUMBER 값이 'decimal' Avro 논리 타입으로 쓰일 때 사용 가능한 자릿수를 나타내는 특정 'precision'이 필요해요. 일반적으로 precision은 열 데이터 타입 정의나 데이터베이스 엔진의 기본값에 의해 정의돼요. 그러나 일부 데이터베이스 엔진에서는 정의되지 않은 precision(0)이 반환될 수 있어요. 'Default Decimal Precision'은 이러한 정의되지 않은 precision 숫자를 쓸 때 사용돼요. | |
| Default Decimal Scale * | Default Decimal Scale | 0 | DECIMAL/NUMBER 값이 'decimal' Avro 논리 타입으로 쓰일 때 사용 가능한 소수 자릿수를 나타내는 특정 'scale'이 필요해요. 일반적으로 scale은 열 데이터 타입 정의나 데이터베이스 엔진의 기본값에 의해 정의돼요. 그러나 일부 데이터베이스 엔진에서는 정의되지 않은 precision(0)이 반환될 때 scale도 불확실할 수 있어요. 'Default Decimal Scale'은 이러한 정의되지 않은 숫자를 쓸 때 사용돼요. 값이 지정된 scale보다 소수가 많으면 반올림되는데, 예를 들어 scale 0에서는 1.53이 2가 되고 scale 1에서는 1.5가 돼요. | |
| 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 Columns | dbrecord-lookup-value-columns | 조회 키가 일치할 때 반환될 테이블의 열 목록(쉼표로 구분)이에요. 데이터베이스에 따라 대소문자를 구분할 수 있다는 점에 유의하세요. |
상태 관리 (State management)
이 컴포넌트는 상태를 저장하지 않아요.
제한 (Restricted)
이 컴포넌트는 제한되지 않아요.
시스템 리소스 고려 사항 (System Resource Considerations)
이 컴포넌트는 시스템 리소스 고려 사항을 지정하지 않아요.