메타데이터 버킷 버전 만들기
이 가이드에서는 Manufacturing Data Engine (MDE)의 기존 버킷에 새 메타데이터 버킷 버전을 만드는 방법을 설명합니다.
메타데이터 버킷 버전을 사용하면 버킷 스키마를 발전시킬 수 있습니다. 유형과 파서는 항상 특정 버킷 버전을 참조하므로 새 버전을 만들어도 기존 데이터 처리 파이프라인에는 영향을 주지 않습니다. 새 버킷 버전을 사용하려면 유형과 파서를 업그레이드하거나 새 유형과 파서를 만들어야 합니다. 구성 API 또는 MDE 웹 인터페이스를 사용하여 메타데이터 버킷 버전을 만들 수 있습니다.
시작하기 전에
이 가이드에서는 MDE의 메타데이터 버킷 을 이미 만들었다고 가정합니다.
버전 관리 제한사항
버킷의 새 버전을 만들 때는 다음 제한사항을 고려하세요.
새 버전은 다음을 수행할 수 있습니다.
- 새 선택적 필드를 추가합니다.
- 필수 필드를 선택사항으로 표시합니다.
새 버전은 다음을 수행할 수 없습니다.
- 필드를 삭제합니다.
- 기존 필드의 데이터 유형을 변경합니다.
- 선택적 속성을 필수 항목으로 표시합니다.
새 메타데이터 버킷 버전 만들기
터미널 또는 콘솔을 사용하여 메타데이터 버킷 버전을 만들 수 있습니다.
REST
다음 REST API 요청을 실행합니다.
POST /metadata/v1/buckets/BUCKET_NAME/versions
{
"schema": "BUCKET_SCHEMA",
"provider": "local"
}
다음을 바꿉니다.
BUCKET_NAME: 만들 버킷의 이름입니다.BUCKET_TYPE: 만들 버킷의 유형입니다.TAG,RECORD,LOOKUP중 하나여야 합니다.TAG버킷에 있는 메타데이터 인스턴스의natural_key는 태그 이름이어야 합니다.RECORD버킷에 있는 메타데이터 인스턴스의natural_key는 모든 키일 수 있습니다.LOOKUP버킷에 있는 메타데이터 인스턴스의natural_key는 모든 키일 수 있지만 레코드는 조회 버킷의 인스턴스를 참조할 수 없으며 인스턴스는 데이터 싱크에 기록되지 않습니다. 조회 버킷은 Whistle 함수lookupByKey를 사용하여 파서가 가져오고 레코드를 보강하는 데 사용할 수 있는 참조 데이터의 소스 역할만 합니다.BUCKET_SCHEMA: 버킷의 JSON 스키마입니다. 스키마는 버킷에서 만들 수 있는 인스턴스를 제한합니다.INSTANCE_OVERWRITE_MODE:TRUE또는FALSE입니다. 제공된 인스턴스를 지정된 자연 키의 최신 인스턴스와 병합하여 새 인스턴스를 만들지 아니면 제공된 대로 새 인스턴스를 만들지 결정합니다.
콘솔
새 메타데이터 버킷 버전 을 만들려면 Cloud Management MC 웹 인터페이스의 METADATA 섹션에서 새 버전 만들기 를 클릭합니다.
새 메타데이터 버킷 버전의 파라미터를 업데이트하는 양식이 포함된 구성 패널이 표시됩니다.
새 버전에는 이전 버전과 호환되는 변경사항만 허용됩니다. 새 버전, 호환되지 않는 변경사항, 변경사항에는 새 버킷을 만들어야 합니다. 패널에서 다음을 업데이트할 수 있습니다.
- 인스턴스 업데이트 모드: 버킷의 인스턴스 수집 동작을 변경합니다.
- 메타데이터 스키마: 버킷의 기존 스키마에 새 속성을 추가합니다.
변경사항이 구현되면 만들기 를 클릭하여 메타데이터 버킷의 새 버전을 저장합니다.
변경이 실패하면 오류 메시지가 표시됩니다. 변경이 성공하면 성공 메시지가 표시됩니다. 새 버전 번호는 순차적이며 버킷에 자동으로 할당됩니다.