SimpleCsvFileLookupService
SimpleCsvFileLookupService (간단한 CSV 파일 조회 서비스)
SimpleCsvFileLookupService는 다시 로드(reload)할 수 있는 CSV 파일 기반의 조회(lookup) 컨트롤러 서비스예요. CSV 파일에 담긴 키-값 쌍을 조회해서 데이터 흐름을 보강(enrich)하거나 조인할 때 사용해요. CSV 파일의 첫 번째 줄은 헤더로 간주해요.
출처: Snowflake 문서
본문
기능 — 일반 사용 가능 (Generally Available)
- Openflow Snowflake Deployments는 AWS, Azure, GCP의 Commercial 리전에 있는 모든 계정에서 사용할 수 있어요.
- Openflow BYOC 배포는 AWS Commercial 리전의 모든 계정에서 사용할 수 있어요.
설명 (Description)
다시 로드할 수 있는 CSV 파일 기반 조회 서비스예요. CSV 파일의 첫 번째 줄은 헤더로 간주해요.
태그 (Tags)
cache, csv, enrich, join, key, lookup, reloadable, value
속성 (Properties)
아래 목록에서 필수 속성(Properties)은 별표(*)로 표시돼요. 나머지 속성은 선택 사항이에요. 표는 각 속성의 기본값과 NiFi Expression Language 지원 여부도 함께 보여줘요.
| 표시 이름 | API 이름 | 기본값 | 허용 값 | 설명 |
|---|---|---|---|---|
| CSV Format * | CSV Format | default | Custom Format RFC 4180 Microsoft Excel Tab-Delimited MySQL Format Informix Unload Informix Unload Escape Disabled Default Format RFC4180 |
CSV 데이터가 어떤 형식(format)인지 지정하거나, 사용자 지정 형식을 사용할지 지정해요. |
| Character Set * | Character Set | UTF-8 | CSV 파일을 디코딩하는 데 사용하는 문자 인코딩(Character Encoding)이에요. | |
| Comment Marker | Comment Marker | 주석의 시작을 나타내는 데 사용하는 문자예요. 이 주석 문자로 시작하는 줄은 모두 무시돼요. | ||
| Escape Character * | Escape Character | CSV 파서에 특별한 의미를 갖는 문자를 이스케이프(escape)하는 데 사용하는 문자예요. 이 속성을 Expression Language로 지정했는데 실행 시 유효하지 않은 이스케이프 문자로 평가되면 건너뛰고 기본 이스케이프 문자를 사용해요. 빈 문자열로 설정하면 이스케이프 문자를 사용하지 않는다는 뜻이에요. | ||
| Quote Character * | Quote Character | " | 이스케이프 문자를 쓰지 않아도 되도록 값을 인용(quote)하는 데 사용하는 문자예요. Expression Language로 지정했는데 실행 시 유효하지 않은 인용 문자로 평가되면 건너뛰고 기본 인용 문자를 사용해요. | |
| Quote Mode * | Quote Mode | MINIMAL | Quote All Values Quote Minimal Quote Non-Numeric Values Do Not Quote Values |
값을 쓸 때 필드를 어떻게 인용할지 지정해요. |
| Trim Fields * | Trim Fields | true | true false |
필드 앞뒤의 공백을 제거할지 여부예요. |
| Value Separator * | Value Separator | , | CSV 레코드에서 값/필드를 구분하는 데 사용하는 문자예요. Expression Language로 지정했는데 실행 시 유효하지 않은 값 구분자로 평가되면 건너뛰고 기본 값 구분자를 사용해요. | |
| CSV File * | csv-file | 키-값 쌍을 조회할 수 있는 CSV 파일의 경로예요. | ||
| Ignore Duplicates * | ignore-duplicates | true | true false |
CSV 파일 레코드에서 중복 키를 무시할지 여부예요. |
| Lookup Key Column * | lookup-key-column | CSV 파일에서 조회 키(lookup key) 역할을 하는 필드예요. 조회 프로세서에 지정된 속성과 일치시킬 필드에요. | ||
| Lookup Value Column * | lookup-value-column | 조회 값 열(lookup value column)이에요. |
상태 관리 (State management)
이 컴포넌트는 상태(state)를 저장하지 않아요.
제한 (Restricted)
이 컴포넌트는 제한되며, 다음 권한이 필요해요.
| 필요한 권한 | 설명 |
|---|---|
| read filesystem | NiFi가 접근할 수 있는 모든 파일을 읽을 수 있는 권한을 운영자에게 부여해요. |
시스템 리소스 고려 사항 (System Resource Considerations)
이 컴포넌트는 별도 시스템 리소스 고려 사항이 없어요.