스키마 적용

키 스키마

connector 는 변경 이벤트 문서의 _id 필드에 대한 기본 키 스키마를 제공합니다. 여기 이 가이드에 설명된변환 중 하나를 사용하여 변경 이벤트 문서에서 _id 필드를 제거하지 않는 한 기본 키 스키마를 사용해야 합니다.

이러한 변환 중 하나를 지정하고 수신 문서에 키 스키마를 사용하려면 이 가이드의 스키마 지정 섹션에 설명된 대로 키 스키마를 지정해야 합니다.

다음 옵션을 사용하여 기본 키 스키마를 활성화할 수 있습니다.

output.format.key=schema

값 스키마

connector 는 변경 이벤트 문서에 대한 기본값 스키마를 제공합니다. 이 가이드에 설명된 대로 변경 이벤트 문서를 변환하지 않는 한 기본값 스키마를 사용해야 합니다.

이러한 변환 중 하나를 지정하고 수신 문서에 값 스키마를 사용하려면 이 가이드의 변환된 문서에 대한 스키마 섹션에 설명된 메커니즘 중 하나를 사용해야 합니다.

다음 옵션을 사용하여 기본값 스키마를 활성화할 수 있습니다.

output.format.value=schema

스키마 지정

Avro 스키마 구문을 사용하여 수신 문서에 대한 스키마를 지정할 수 있습니다. 문서 값 및 키에 대한 스키마를 지정하는 방법을 보려면 다음 탭을 클릭하세요.

output.format.key=schema
output.schema.key=<your avro schema>

output.format.value=schema
output.schema.value=<your avro schema>

스키마를 지정하는 방법을 보여주는 예시를 보려면 스키마 지정 사용 예시를 참조하세요.

Avro 스키마에 대해 자세히 알아보려면 데이터 형식 가이드를 참조하세요.

스키마 추론

소스 connector 가 수신 문서에 대한 스키마를 추론하도록 할 수 있습니다. 이 옵션은 개발 및 구조가 자주 변경되지 않는 데이터 소스에는 적합하지만, 대부분의 프로덕션 배포 에서는 스키마를 지정하는 것이 좋습니다.

다음 옵션을 지정하여 커넥터가 스키마를 추론하도록 할 수 있습니다.

output.format.value=schema
output.schema.infer.value=true

소스 커넥터는 배열에 저장된 중첩 문서를 포함하는 수신 문서의 스키마를 추론할 수 있습니다. 커넥터 버전 1.9부터 스키마 추론는 다음 사례에서 설명하는 중첩 문서 간에 차이가 있는 경우 string 유형 할당을 기본값으로 설정하는 대신 필드에 적합한 데이터 유형을 수집합니다.

• 필드가 한 문서에는 있지만 다른 문서에는 없습니다.

• 필드가 한 문서에는 있지만 다른 문서에는 null입니다.

• 필드가 한 문서에서는 모든 유형의 요소가 포함된 배열이지만 다른 문서에서는 다른 데이터 유형의 요소나 요소가 추가로 포함됩니다.

• 필드가 한 문서에서는 모든 유형의 요소가 포함된 배열이지만 다른 문서에서는 빈 배열입니다.

중첩 문서 간에 필드 유형이 충돌하는 경우 커넥터는 충돌을 해당 필드의 스키마로 푸시하고 string 유형 할당을 기본값으로 설정합니다.