StandardProtobufReader
StandardProtobufReader (표준 Protobuf 리더)
StandardProtobufReader는 Protocol Buffers 메시지를 바이너리 형식에서 NiFi Records로 파싱하는 리더 컨트롤러 서비스예요. 인라인 스키마 텍스트, 스키마 레지스트리 조회, 스키마 참조 리더를 포함한 여러 스키마 접근 전략을 지원합니다. Protobuf 리더는 바이너리 페이로드를 올바르게 역직렬화하려면 Proto 스키마 메시지 이름을 알아야 해요.
출처: Snowflake 문서
본문
기능 — 일반 사용 가능 (Generally Available)
- Openflow Snowflake Deployments는 AWS, Azure, GCP의 Commercial 리전에 있는 모든 계정에서 사용할 수 있어요.
- Openflow BYOC 배포는 AWS Commercial 리전의 모든 계정에서 사용할 수 있어요.
설명 (Description)
Protocol Buffers 메시지를 바이너리 형식에서 NiFi Records로 파싱해요. 인라인 스키마 텍스트, 스키마 레지스트리 조회, 스키마 참조 리더를 포함한 여러 스키마 접근 전략을 지원해요. Protobuf 리더는 바이너리 페이로드를 올바르게 역직렬화하려면 Proto 스키마 메시지 이름을 알아야 해요. 이 메시지의 이름은 'Message Name' 속성을 사용해 정적으로 결정하거나, Message Name Resolver 서비스를 사용해 동적으로 결정할 수 있어요.
태그 (Tags)
parser, protobuf, reader, record
속성 (Properties)
아래 목록에서 필수 속성(Properties)은 별표(*)로 표시돼요. 나머지 속성은 선택 사항이에요. 표는 각 속성의 기본값과 NiFi Expression Language 지원 여부도 함께 보여줘요.
| 표시 이름 | API 이름 | 기본값 | 허용 값 | 설명 |
|---|---|---|---|---|
| Message Name * | Message Name | 패키지를 포함한 Protocol Buffers 메시지의 정규화된 이름이에요(예: mypackage.MyMessage). | ||
| Message Name Resolution Strategy * | Message Name Resolution Strategy | MESSAGE_NAME_PROPERTY | Message Name Property Message Name Resolver |
처리를 위해 Protocol Buffers 메시지 이름을 결정하는 전략이에요. |
| Message Name Resolver * | Message Name Resolver | FlowFile 내용 또는 속성에서 Protocol Buffer 메시지 이름을 동적으로 해석하는 서비스예요. | ||
| Schema Access Strategy * | Schema Access Strategy | schema-name | Use 'Schema Name' Property Use 'Schema Text' Property Schema Reference Reader |
데이터 해석에 사용할 스키마를 얻는 방법을 지정해요. |
| Schema Branch | Schema Branch | Schema Registry 속성에서 스키마를 조회할 때 사용할 브랜치 이름을 지정해요. 선택한 Schema Registry가 브랜칭(branching)을 지원하지 않으면 이 값은 무시돼요. | ||
| Schema Name | Schema Name | ${schema.name} | Schema Registry 속성에서 조회할 스키마의 이름을 지정해요. | |
| Schema Reference Reader * | Schema Reference Reader | Schema Reference 식별자를 결정하기 위해 FlowFile 속성 또는 내용을 읽는 역할을 맡은 서비스 구현이에요. | ||
| Schema Registry | Schema Registry | Schema Registry에 사용할 Controller Service를 지정해요. | ||
| Schema Text * | Schema Text | ${proto.schema} | Proto 3 형식의 스키마 텍스트예요. | |
| Schema Version | Schema Version | Schema Registry에서 조회할 스키마의 버전을 지정해요. 지정하지 않으면 스키마의 최신 버전을 가져와요. |
상태 관리 (State management)
이 컴포넌트는 상태(state)를 저장하지 않아요.
제한 (Restricted)
이 컴포넌트는 제한되지 않아요.
시스템 리소스 고려 사항 (System Resource Considerations)
이 컴포넌트는 별도 시스템 리소스 고려 사항이 없어요.