트랜스코더 구성

JSON 파일에 필요한 구성을 추가하여 메인프레임 커넥터 트랜스코더를 구성할 수 있습니다. 이 파일을 트랜스코더 구성 파일이라고 합니다. 구성 섹션에 지정된 대로 구성을 정의해야 합니다. qsam encode 및 qsam decode 명령어는 트랜스코더 구성 파일을 사용하여 데이터 트랜스코딩을 실행합니다.

이 페이지에서는 Mainframe Connector 트랜스코더를 구성할 수 있는 다양한 방법을 설명합니다.

구성

Configuration 객체는 트랜스코더 구성의 루트입니다. 트랜스코더의 모든 구성 옵션이 포함되어 있습니다.

JSON 표현
{ "defaults": object (DefaultsSection), "field_suffixes": object (FieldSuffix), "field_overrides": object (FieldOverride), "transformations": object (Transformation), "schema_validation_mode": enum (SchemaValidationMode), "header_records_to_skip": long, "record_filter_condition": string }

필드
defaults	object (DefaultsSection) Cobol 원형의 기본 필드 수정자를 지정합니다.
field_suffixes	object (FieldSuffix) 필드 접미사를 지정합니다.
field_overrides	object (FieldOverride) 필드 재정의를 지정합니다.
transformations	object (Transformation) 필드 변환을 지정합니다.
schema_validation_mode	enum (SchemaValidationMode) 스키마 검증 모드를 지정합니다.
header_records_to_skip	long 건너뛸 첫 번째 레코드 수를 지정합니다.
record_filter_condition	string 레코드의 필터 조건을 지정합니다. 필터는 다음 연산자를 지원합니다. 비교 연산자: `==`, `!=`, `<`, `<=`, `>`, `>=`. 논리 연산자: `&&` (AND), `||` (OR). 목록 포함: `in` (값이 목록 변수에 있는지 확인) 산술 연산자: `+`, `-`, `*`, `/`, `%`. 문자열 및 목록 함수: size(): 문자열 또는 목록의 길이를 반환합니다. contains(substring): 문자열에 지정된 하위 문자열이 포함되어 있는지 확인합니다. 비교 및 연산은 동일한 데이터 유형의 변수 또는 상수 간에 실행해야 합니다. 예: "record_filter_condition": "(DATE > '2025-01-12' ) && ((SCORE_A + SCORE_B) > 134)

DefaultsSection

DefaultsSection 객체를 사용하여 COBOL 유형별 기본 수정사항을 지정할 수 있습니다. 이러한 수정사항은 접미사 또는 재정의 수정사항 앞에 적용됩니다.

JSON 표현
{ "alpha_numeric_display": object (FieldModifier), "numeric_display": object (FieldModifier), "binary": object (FieldModifier), "packed_decimal": object (FieldModifier), "national": object (FieldModifier), "utf8": object (FieldModifier), "dbcs": object (FieldModifier), "hexadecimal_floating_point": object (FieldModifier) }

필드
alpha_numeric_display	object (FieldModifier) 영숫자 (PIC X) 필드의 기본값을 지정합니다.
numeric_display	object (FieldModifier) 숫자 표시 (구역 십진수) 필드의 기본값을 지정합니다.
binary	object (FieldModifier) 이진수 (COMP) 필드의 기본값을 지정합니다.
packed_decimal	object (FieldModifier) 패킹된 10진수 (COMP-3) 필드의 기본값을 지정합니다.
national	object (FieldModifier) 국가 (PIC N) 필드의 기본값을 지정합니다.
utf8	object (FieldModifier) UTF-8 (PIC U) 필드의 기본값을 지정합니다.
dbcs	object (FieldModifier) dbcs (DISPLAY-1) 필드의 기본값입니다.
hexadecimal_floating_point	object (FieldModifier) 16진수 부동 소수점 (COMP-1, COMP-2) 필드의 기본값입니다.

FieldSuffix

필드 접미사는 접미사가 있는 모든 필드에 적용됩니다.

필드는 하이픈 (-) 또는 밑줄 (_)과 서픽스로 끝나는 경우 일치합니다.

접미사는 대소문자를 구분하지 않습니다.

FieldSuffix 수정자는 FieldOverride 수정자 뒤에 적용됩니다.

예를 들어 서픽스 NID에 정의된 수정자는 FLD-NID이라는 필드에 적용되지만 FUNID 필드에는 적용되지 않습니다.

JSON 표현
{ "suffix": string, "is_inverse": boolean, "modifier": object (FieldModifier) }

필드
suffix	string 이 접미사가 있는 필드에는 수정자가 적용됩니다.
is_inverse	boolean 수정자가 역 필드 수정자인지 여부를 지정합니다. 역 필드 수정자는 수정자가 없는 수정자가 있는 필드와 이름이 같은 다른 필드에 수정자를 적용합니다. 예를 들어 동일한 레코드에 FLD-NID 및 FLD 필드가 모두 있는 경우 수정자가 FLD에 적용됩니다. 역 필드 수정자를 사용하는 경우 특수 식별자 $self는 필드 이름이 전통적으로 접미사가 있는 필드를 참조하는 데 사용될 수 있을 때마다 사용할 수 있습니다. 예를 들어 null 표시기 필드를 만들려면 is_inverse이 true로 설정된 null_if 필드 수정자를 사용하면 됩니다. 자세한 내용은 NullIf를 참고하세요.
modifier	object (FieldModifier) 일치하는 필드에 적용할 수정자를 지정합니다.

FieldOverride

지정된 필드의 디코딩 및 인코딩 체인을 재정의하거나 수정합니다.

JSON 표현
{ "field": string, "modifier": object (FieldModifier) }

필드
field	string 수정자를 적용할 필드의 이름을 지정합니다.
modifier	object (FieldModifier) 일치하는 필드에 적용할 수정자를 지정합니다.

변환

뷰 변환은 테이블과 QSAM 파일 간의 관계를 수정하는 데 사용됩니다. 변환은 항상 데이터의 관점에서 표현됩니다. 이 개념은 BigQuery의 뷰 테이블과 유사합니다.

JSON 표현
{ "exclude": object (Exclude), "unnest": object (Unnest), "move": object (Move), "rename": object (Rename) }

필드
exclude	object (Exclude)
unnest	object (Unnest)
move	object (Move)
rename	object (Rename)

FieldModifier

필드 수정자를 사용하면 특정 필드의 인코딩 또는 디코딩을 수정할 수 있습니다. 일부 수정자는 일부 필드에 적용할 수 없습니다. 자세한 내용은 특정 수정자 문서를 참고하세요.

JSON 표현

{ "filler": object (Filler), "null_if": object (NullIf), "format_date": object (FormatDate), "chain": object (ModifierChain), "zoned_decimal": object (ZonedDecimal), "binary": object (Binary), "packed_decimal": object (PackedDecimal), "null_if_invalid": object (NullIfInvalid), "bytes": object (Bytes), "varlen": object (VarLen), "string": object (String), "null_if_empty": object (NullIfEmpty), "format_timestamp": object (FormatTimestamp), "hfp": object (HFP), "decode_as_null": object (DecodeAsNull), "encode_null_as": object (EncodeNullAs) }

필드
filler	object (Filler) 처리 및 출력에서 필드를 제외합니다.
null_if	object (NullIf) 다른 필드의 값에 따라 필드를 null로 조건부로 설정합니다.
format_date	object (FormatDate) 문자열 필드의 형식을 날짜로 지정합니다.
chain	object (ModifierChain) 순차적으로 적용할 여러 수정자를 연결합니다.
zoned_decimal	object (ZonedDecimal) 영역화된 십진수 필드의 기본 구성을 재정의합니다.
binary	object (Binary) 이진 숫자 필드의 기본 구성을 재정의합니다.
packed_decimal	object (PackedDecimal) 패킹된 십진수 필드의 기본 구성을 재정의합니다.
null_if_invalid	object (NullIfInvalid) 트랜스코딩 오류가 발생하면 필드를 null로 설정하여 레코드 스필오버를 방지합니다.
bytes	object (Bytes) 이전 유형 정보를 무시하고 필드를 원시 바이트 시퀀스로 처리합니다.
varlen	object (VarLen) 레코드를 가변 길이 필드로 설정합니다.
string	object (String) 문자열 필드의 기본 구성을 재정의합니다.
null_if_empty	object (NullIfEmpty) 콘텐츠가 비어 있는 것으로 간주되면 필드를 null로 설정합니다.
format_timestamp	object (FormatTimestamp) 문자열 필드를 타임스탬프로 형식화합니다.
hfp	object (HFP) 필드를 16진수 부동 소수점 (HFP) 숫자로 해석합니다.
decode_as_null	object (DecodeAsNull) null 값을 디코딩하는 방법을 정의합니다.
encode_null_as	object (EncodeNullAs) null 값을 인코딩하는 방법을 정의합니다.

제외

결과 테이블에서 필드를 제외하지만 디코딩 또는 인코딩은 계속 진행합니다. 이 방법은 필드를 표로 전송할 필요는 없지만 트랜스코딩에 필요한 경우에 유용합니다. 예를 들어 null 표시기 또는 길이 필드는 표에서 생략할 수 있습니다.

트랜스코딩을 완전히 우회하려면 필러 수정자를 적용하세요.

JSON 표현
{ "field": string }

필드
field	string 제외할 필드를 지정합니다.

Unnest

필드를 중첩 해제합니다.

JSON 표현
{ "field": string, "format": string }

필드
field	string 중첩 해제할 필드 지정
format	string 새 필드 형식을 지정합니다. ${parent}는 중첩 해제된 필드의 이름과 함께 출시됩니다. 중첩되지 않은 구조체의 경우 ${field}이 구조체 필드의 이름으로 대체됩니다. 중첩되지 않은 배열과 목록의 경우 ${index}가 배열의 색인으로 대체됩니다.

이동

레코드의 필드를 이동합니다.

JSON 표현
{ "field": string, "offset": int }

필드
field	string 이동할 필드를 지정합니다.
offset	int 필드를 이동해야 하는 위치의 수를 앞 또는 뒤로 지정합니다.

이름 바꾸기

정규 표현식 일치를 기반으로 하나 이상의 필드 이름을 바꿉니다.

예를 들어 모든 하이픈을 밑줄로 바꾸려면 다음 JSON 형식을 사용합니다. {"find": "\\-", "replace":"_"}

JSON 표현
{ "find": string, "replace": string }

필드
find	string 이름을 바꿀 필드를 식별하는 Java 정규 표현식 pattern을 지정합니다. 패턴은 전체 필드 이름과 일치합니다. 패턴이 필드 이름의 일부와 일치하면 필드가 일치하는 것으로 간주됩니다. 예: "\\-" (하이픈이 포함된 필드와 일치) "^field_name$" (이름이 정확히 field_name인 필드와 일치) "^field_(.*)$" (field_로 시작하는 필드와 일치하고 나머지를 캡처함) "part_of_name" (part_of_name이 포함된 필드와 일치)
replace	string 일치하는 필드의 새 이름을 지정합니다. find 정규 표현식의 캡처 그룹은 $1, $2와 같은 역참조를 사용하여 replace 문자열에서 사용할 수 있습니다. 이를 통해 원래 필드 이름의 일부를 기반으로 더 복잡한 변환이 가능합니다. 예: "new_field_name" (고정된 이름으로 필드를 대체함) "new_$1" (find의 첫 번째 캡처 그룹 사용) "${1}_new" (캡처 그룹의 대체 구문) "prefix_$1_suffix" (캡처 그룹을 사용하고 접두사/접미사를 추가함)

가축 영양제

처리 중에 필드가 무시되도록 지정합니다. 필드는 입력에서 디코딩되거나 출력으로 인코딩되지 않으며 디코딩 중에 결과 스키마 및 데이터 테이블에서 제외됩니다. 이 수정자는 정적으로 알려진 크기가 있는 모든 필드에 적용할 수 있습니다.

다음과 같이 빈 JSON 객체를 제공합니다.

JSON 표현
{ }

NullIf

조건이 충족되면 필드를 null로 설정합니다. null_value, non_null_value 또는 둘 다를 지정해야 합니다.

null 표시기 필드를 만들려면 null_if 필드 수정자가 있는 FieldSuffix를 사용하고 다음 예와 같이 is_inverse를 true로 설정하면 됩니다.

예: null-indicator

null 표시기 필드를 만들려면 다음과 같이 null_if 필드 수정자를 사용하면 됩니다.

 {
  "field_suffixes": [
   {
     "suffix": "NID",
     "is_inverse": true,
     "modifier": {
     "null_if": {
       "null_value": "?",
       "target_field": "$self"
     }
    }
   }
  ]
 }

이렇게 하면 다음 카피북 스니펫에 표시된 것처럼 NID 접미사가 있는 모든 필드가 효과적으로 null 표시기가 될 수 있습니다.

 01 REC.
   02 FIELD     PIC X(10).
   02 FIELD-NID PIC X(1).

예: 바이너리 null 표시기

binary null-indicator 필드를 만들려면 다음과 같이 binary 및 null_if 필드 수정자를 사용하면 됩니다.

 {
  "field_suffixes": [
   {
     "suffix": "NID",
     "modifier": {
       "binary": {}
     }
   },
   {
     "suffix": "NID",
     "is_inverse": true,
     "modifier": {
     "null_if": {
       "null_value": "15",
       "target_field": "$self"
     }
    }
   }
  ]
 }

이를 통해 접미사 NID가 있는 모든 필드가 이전 예의 동일한 카피북을 사용하여 효과적으로 binary null 표시기가 될 수 있습니다.

예: 바이트 null 표시기

bytes null 표시기 필드를 만들려면 다음과 같이 bytes 및 null_if 필드 수정자를 사용하면 됩니다. null 및 null이 아닌 값은 HEX로 표현됩니다.

 {
  "field_suffixes": [
   {
     "suffix": "NID",
     "modifier": {
       "bytes": {}
     }
   },
   {
     "suffix": "NID",
     "is_inverse": true,
     "modifier": {
     "null_if": {
       "null_value": "FF",
       "target_field": "$self"
     }
    }
   }
  ]
 }

이를 통해 NID 접미사가 있는 모든 필드가 이전 예의 동일한 카피북을 사용하여 효과적으로 bytes null 표시기가 될 수 있습니다.

JSON 표현
{ "target_field": string, "null_value": string, "null_values": string, "non_null_value": string, "non_null_values": string }

필드
target_field	string 값을 확인할 필드를 지정합니다. 필드가 범위 내에 있어야 합니다.
null_value	string 지정된 경우 target_field이 이 값과 같으면 필드가 디코딩되거나 인코딩되지 않고 값이 null로 설정됩니다.
null_values	string 지정된 경우 target_field이 이러한 값 중 하나와 같으면 필드가 디코딩되거나 인코딩되지 않고 값이 null로 설정됩니다.
non_null_value	string 지정된 경우 target_field이 이 값과 같지 않으면 필드가 디코딩되거나 인코딩되지 않고 값이 null로 설정됩니다.
non_null_values	string 지정된 경우 target_field이 이러한 값 중 하나와 같지 않으면 필드가 디코딩되거나 인코딩되지 않고 값이 null로 설정됩니다.

FormatDate

지원되는 형식 중 하나를 사용하여 문자열을 날짜로 변환합니다. 이 수정자는 크기가 지정된 필드에만 적용할 수 있습니다. 디코딩 프로세스 중에 형식이 문자열과 일치할 때까지 순서대로 테스트됩니다. 인코딩 프로세스 중에 첫 번째 형식이 사용되고 나머지는 무시됩니다.

JSON 표현
{ "formats": object (DateTimeFormat) }

필드
formats	object (DateTimeFormat) 날짜 형식 목록입니다.

ModifierChain

수정자 체인을 지정하여 여러 수정자를 연속으로 적용합니다. 수정자는 지정된 순서대로 적용됩니다.

JSON 표현
{ "modifiers": object (FieldModifier) }

필드
modifiers	object (FieldModifier) 적용할 수정자 목록을 지정합니다.

ZonedDecimal

존 십진수의 인코딩 및 디코딩과 관련된 다양한 옵션을 설정합니다. 이 수정자는 십진수 필드에만 적용할 수 있습니다.

JSON 표현
{ "logical_type": enum (DecimalLogicalType), "encoding": enum (ZonedDecimalEncoding) }

필드
logical_type	enum (DecimalLogicalType) 필드를 디코딩하거나 인코딩할 때 사용할 논리적 유형을 지정합니다.
encoding	enum (ZonedDecimalEncoding) 필드가 인코딩된 인코딩입니다.

바이너리

이전 수정자를 무시하고 이 필드를 이진수로 처리합니다.

JSON 표현
{ "signedness": enum (BinarySignedness) }

필드
signedness	enum (BinarySignedness) 숫자의 부호입니다.

PackedDecimal

이 필드를 PackedDecimal로 설정합니다.

JSON 표현
{ "logical_type": enum (DecimalLogicalType) }

필드
logical_type	enum (DecimalLogicalType) 논리 유형을 재정의합니다. 기본적으로 Mainframe Connector는 정밀도와 스케일을 기반으로 최적의 논리 유형을 사용합니다.

NullIfInvalid

트랜스코딩이 실패하면 값을 null로 처리합니다. 이 수정자는 크기가 지정된 필드에만 적용할 수 있습니다. 오류는 무시되며 스필오버 데이터 세트에 로깅되지 않습니다. 디코딩 과정에서 이 레코드의 이 필드 값은 null입니다. 인코딩 과정에서 데이터를 쓸 수 없는 경우 전체 필드가 null 바이트로 채워집니다.

다음과 같이 빈 JSON 객체를 제공합니다.

JSON 표현
{ }

바이트

필드를 원시 바이트 시퀀스로 취급합니다. 이 수정자는 이전 유형 정보를 재정의하므로 필드의 원시 바이트 데이터가 특정 문자 인코딩이나 숫자 해석 없이 있는 그대로 보존됩니다. 원래 유형이나 크기에 관계없이 모든 필드에 이 수정자를 적용할 수 있습니다.

다음과 같이 빈 JSON 객체를 제공합니다.

JSON 표현
{ }

VarLen

가변 길이 필드를 나타냅니다.

가변 길이 필드는 다음 세 부분으로 구성됩니다.

1. 두 개의 하위 필드를 포함하는 그룹 항목입니다.
2. 트랜잭션 데이터의 길이를 포함하는 그룹 항목 내 필드입니다.
3. 데이터가 포함된 그룹 항목 내의 필드입니다.

가변 길이 필드의 이름은 그룹 이름이 됩니다.

다음과 같이 빈 JSON 객체를 제공합니다.

JSON 표현
{ }

문자열

문자열 디코딩 및 인코딩과 관련된 다양한 옵션을 설정합니다. 문자열 필드에만 적용할 수 있습니다.

JSON 표현
{ "encoding": string, "trim_suffix": boolean, "pad_char": string }

필드
encoding	string 필드가 인코딩된 인코딩입니다.
trim_suffix	boolean true로 설정하면 문자열 끝의 공백이 잘립니다. trim_suffix는 디코딩에만 영향을 미치며 인코딩은 trim_suffix를 무시합니다. 공백으로만 구성된 문자열은 빈 문자열이 됩니다.
pad_char	string pad_char로 패딩 내보내기 문자열을 설정합니다. 설정된 경우 pad_char의 길이는 1이어야 합니다. pad_char는 인코딩에만 영향을 미치며 디코딩은 pad_char를 무시합니다.

NullIfEmpty

해당 필드의 모든 바이트가 0이면 필드를 null로 설정해야 합니다.

다음과 같이 빈 JSON 객체를 제공합니다.

JSON 표현
{ }

FormatTimestamp

제공된 형식 중 하나를 사용하여 문자열을 타임스탬프로 형식 지정합니다. 크기가 지정된 필드에만 적용할 수 있습니다. 디코딩하는 동안 형식이 문자열과 일치할 때까지 순서대로 테스트됩니다. 인코딩 중에 첫 번째 형식이 사용되고 나머지는 무시됩니다.

JSON 표현
{ "formats": object (DateTimeFormat) }

필드
formats	object (DateTimeFormat) 타임스탬프 형식 목록입니다.

HFP

이 필드를 16진수 부동 소수점으로 설정합니다.

다음과 같이 빈 JSON 객체를 제공합니다.

JSON 표현
{ }

DecodeAsNull

디코딩 프로세스 중에 null 값이 해석되는 방식을 정의합니다. COBOL은 기본적으로 null을 지원하지 않으므로 이 매개변수는 null로 처리해야 하는 값을 지정합니다.

JSON 표현
{ "values": string, "hex_bytes": string }

필드
values	string 문자열 표현 목록입니다. 필드를 문자열 형식으로 초기 디코딩한 후 필드의 콘텐츠가 이러한 값 중 하나와 일치하면 null로 처리됩니다.
hex_bytes	string 단일 바이트의 16진수 표현 목록입니다. 필드에 이러한 바이트가 반복되어 포함되면 null로 처리됩니다. 예를 들어 모든 최고치에 FF을 사용하고 모든 최저치에 00을 사용합니다 (비어 있음).

EncodeNullAs

인코딩 프로세스 중에 null 값이 표현되는 방식을 정의합니다.

JSON 표현
{ "value": string, "hex_byte": string }

필드
value	string 소스 값이 null인 경우 이 특정 값을 인코딩합니다. 문자열이 필드의 유형에 유효한지 확인합니다.
hex_byte	string 소스 값이 null인 경우 이 특정 바이트 시퀀스 (16진수 문자열로 표시됨)를 인코딩합니다. 예를 들어 2바이트 필드의 FF를 높은 값으로 설정합니다. 크기를 알고 있는 모든 필드에 이를 적용할 수 있습니다. 바이트는 기본 필드의 크기에 맞게 반복됩니다.

DateTimeFormat

필드를 날짜로 변환할 때 사용할 크기와 패턴입니다.

JSON 표현
{ "size": int, "pattern": string }

필드
size	int 이 패턴이 적용되는 필드의 크기를 지정합니다.
pattern	string 날짜 포맷터 패턴을 지정합니다. 유효한 포맷터 패턴에 대한 자세한 내용은 클래스 DateTimeFormatter를 참고하세요.

ZonedDecimalEncoding

존 십진수 필드를 디코딩하거나 인코딩할 때 사용할 인코딩을 지정합니다.

열거형
UNSPECIFIED	수정자 체인에 지정된 인코딩을 유지합니다. 수정자가 지정되지 않으면 EBCDIC가 사용됩니다.
EBCDIC	EBCDIC 인코딩을 사용합니다.
ASCII	ASCII 인코딩을 사용합니다.

BinarySignedness

십진수 필드에 사용할 논리 유형입니다.

열거형
UNSPECIFIED	규모와 정밀도에 따라 가장 최적의 유형을 사용합니다.
SIGNED	64비트를 사용하여 값을 저장합니다. 이 수정자는 정밀도가 18 이하이고 스케일이 0인 숫자에만 적용됩니다.
UNSIGNED	64비트를 사용하여 값을 저장합니다. 이 수정자는 정밀도가 18 이하인 숫자에만 적용됩니다.

DecimalLogicalType

십진수 필드에 사용할 논리 유형입니다.

열거형
AUTO	규모와 정밀도에 따라 가장 최적의 유형을 사용합니다.
LONG	64비트를 사용하여 값을 저장합니다. 이 수정자는 정밀도가 18 이하이고 스케일이 0인 숫자에만 적용됩니다.
DECIMAL64	64비트를 사용하여 값을 저장합니다. 이 수정자는 정밀도가 18 이하인 숫자에만 적용됩니다.
BIG_DECIMAL	값을 무한한 십진수 값으로 저장합니다. 이 옵션은 가장 느리지만 모든 스케일에서 모든 정밀도의 십진수를 지원합니다.
BIG_INTEGER	값을 무한 정수 값으로 저장합니다. 이 옵션은 가장 느리지만 모든 정밀도의 정수를 지원합니다.

SchemaValidationMode

카피북 컴파일 중에 사용할 스키마 검증 모드를 지정합니다. 이 모드는 특정 타겟 데이터 형식과의 호환성을 확인합니다.

열거형
DEFAULT	기본 스키마 유효성 검사 모드입니다. 이 모드는 고유한 필드 이름이 카피북에 있는지 확인합니다.
BIG_QUERY	BigQuery 호환성을 위한 스키마 검증 모드입니다. 이 모드는 기본 유효성 검사를 확장하여 copybook의 스키마가 BigQuery의 데이터 유형과 호환되는지 확인합니다.
POSTGRES	PostgreSQL 호환성의 스키마 검증 모드입니다. 이 모드는 기본 유효성 검사를 확장하여 카피북의 스키마가 PostgreSQL 데이터 유형과 호환되는지 확인합니다.
MYSQL	MySQL 호환성을 위한 스키마 검증 모드입니다. 이 모드는 기본 검증을 확장하여 카피북의 스키마가 MySQL 데이터 유형과 호환되는지 확인합니다.