DatabaseLookup

사용자가 지정한 SQL 문을 사용해 데이터베이스로 보강(enrichment)할 수 있게 하는 조회 서비스예요.

출처: 문서

본문

기능 — 일반 공개(Generally Available)

Openflow Snowflake 배포는 AWS, Azure, GCP 상용(Commercial) 지역의 모든 계정에서 사용할 수 있어요. Openflow BYOC 배포는 AWS 상용 지역의 모든 계정에서 사용할 수 있어요.

설명 (Description)

사용자가 지정한 SQL 문을 사용해 데이터베이스로 보강할 수 있게 하는 조회 서비스예요. SQL 문은 호출하는 프로세서가 제공하는 FlowFile의 Record에 있는 모든 값을 참조할 수 있어요.

태그 (Tags)

database, enrich, join, lookup, openflow, rdbms, record, sql

속성 (Properties)

아래 목록에서 필수 속성은 별표(*)로 표시돼요. 그 외 속성은 선택 사항으로 간주돼요. 표에는 기본값과 해당 속성이 NiFi Expression Language를 지원하는지 여부도 함께 표시돼요.

표시 이름 (Display Name)	API 이름 (API Name)	기본값 (Default Value)	허용 값 (Allowable Values)	설명 (Description)
Connection Pooling Service *	Connection Pooling Service			데이터베이스에 대한 연결을 얻는 데 사용하는 Connection Pooling Service예요.
Max Array Size *	Max Array Size	1000		배열에 포함할 최대 레코드 수예요. 반환된 결과가 메모리 문제를 일으키지 않도록 하는 메커니즘이에요. 결과 집합에 이 값보다 많은 레코드가 있으면 조회가 실패해요. 반환되는 행 수를 제한하려면 SQL에 LIMIT 절을 추가해야 해요.
Multiple Result Field Name *	Multiple Result Field Name	results		여러 결과가 반환되면 배열로 결합돼요. 이 속성은 반환된 레코드에서 해당 필드의 이름을 결정해요.
Multiple Result Strategy *	Multiple Result Strategy	Fail	Use Array, Use First Only, Fail	조회 결과가 여러 레코드일 때 처리하는 방법을 지정해요.
SQL *	SQL			값을 조회하기 위해 데이터베이스에서 실행할 SQL 문이에요. 이 문은 호출하는 프로세서가 Expression Language를 통해 제공하는 들어오는 Record의 속성이나 값을 참조할 수 있어요. 프로세서는 Expression Language 표현식을 추출해 매개변수화된 값으로 대체해서 SQL을 안전하게 실행하고 SQL 주입(SQL Injection) 공격을 피해요.

상태 관리 (State management)

이 컴포넌트는 상태를 저장하지 않아요.

제한 (Restricted)

이 컴포넌트는 제한되지 않아요.

시스템 리소스 고려 사항 (System Resource Considerations)

이 컴포넌트는 시스템 리소스 고려 사항을 지정하지 않아요.