SimpleScriptedLookupService
SimpleScriptedLookupService (간단한 스크립트 조회 서비스)
SimpleScriptedLookupService는 사용자가 스크립트 기반의 LookupService 인스턴스를 직접 제공해서 들어오는 플로우 파일의 레코드를 보강(enrich)할 수 있게 해주는 컨트롤러 서비스예요. 스크립트로 직접 조회 로직을 짜고 싶을 때 유용한 서비스입니다. 스크립트는 임의의 객체(예: 레코드)가 아니라 선택적 문자열 값(optional string)을 반환해야 해요.
출처: Snowflake 문서
본문
기능 — 일반 사용 가능 (Generally Available)
- Openflow Snowflake Deployments는 AWS, Azure, GCP의 Commercial 리전에 있는 모든 계정에서 사용할 수 있어요.
- Openflow BYOC 배포는 AWS Commercial 리전의 모든 계정에서 사용할 수 있어요.
설명 (Description)
들어오는 플로우 파일의 레코드를 보강하기 위해 스크립트 기반 LookupService 인스턴스를 사용자가 제공할 수 있게 해줘요. 스크립트는 임의의 객체(예: 레코드)가 아니라 선택적 문자열 값(optional string)을 반환해야 해요. 또한 스크립트 기반 조회 서비스는 StringLookupService를 구현해야 해요. 그렇지 않으면 getValueType() 메서드를 반드시 구현해야 하는데, SimpleScriptedLookupService가 스크립트를 대신해 값 유형으로 String을 반환하므로 이 메서드는 구현해도 무시돼요.
태그 (Tags)
groovy, invoke, lookup, script
속성 (Properties)
아래 목록에서 필수 속성(Properties)은 별표(*)로 표시돼요. 나머지 속성은 선택 사항이에요. 표는 각 속성의 기본값과 NiFi Expression Language 지원 여부도 함께 보여줘요.
| 표시 이름 | API 이름 | 기본값 | 허용 값 | 설명 |
|---|---|---|---|---|
| Module Directory | Module Directory | 스크립트에 필요한 모듈이 담긴 파일 및/또는 디렉터리 경로의 쉼표로 구분된 목록이에요. | ||
| Script Body | Script Body | 실행할 스크립트 본문이에요. Script File과 Script Body 중 하나만 사용할 수 있어요. | ||
| Script Engine * | Script Engine | Groovy | - Groovy | 스크립트를 실행할 언어 엔진이에요. |
| Script File | Script File | 실행할 스크립트 파일의 경로예요. Script File과 Script Body 중 하나만 사용할 수 있어요. |
상태 관리 (State management)
이 컴포넌트는 상태(state)를 저장하지 않아요.
제한 (Restricted)
이 컴포넌트는 제한되며, 다음 권한이 필요해요.
| 필요한 권한 | 설명 |
|---|---|
| execute code | NiFi가 가진 모든 권한을 가정하고 임의의 코드를 실행할 수 있는 권한을 운영자에게 부여해요. |
시스템 리소스 고려 사항 (System Resource Considerations)
이 컴포넌트는 별도 시스템 리소스 고려 사항이 없어요.