유형 버전 만들기

이 가이드에서는 Manufacturing Data Engine (MDE)의 기존 유형에 새 유형 버전을 만드는 방법을 설명합니다.

시작하기 전에

기존 유형의 새 유형 버전을 만들기 전에 유형을 만드는 방법을 읽어보세요.

버전 관리 제한사항

유형의 새 버전을 만들 때는 다음 제한사항을 고려하세요.

새 버전은 다음을 충족해야 합니다.

데이터 스키마에 새 선택적 필드를 추가합니다.
데이터 스키마에서 필수 필드를 선택사항으로 표시합니다.
새 메타데이터 버킷 참조 추가

새 버전은 다음을 충족해야 합니다.

데이터 스키마에서 필드를 삭제합니다.
데이터 스키마에서 기존 필드의 데이터 유형을 변경합니다.
데이터 스키마에서 선택적 속성을 필수 속성으로 표시합니다.
메타데이터 버킷 참조를 삭제합니다.

새 유형 버전 만들기

API 또는 콘솔을 사용하여 기존 메타데이터 버킷 연결이 이미 있는 기존 유형에 새 메타데이터 버킷을 연결하고 일반적인 스토리지 사양을 적용하는 새 유형 버전을 만들 수 있습니다.

REST

다음 REST API 요청을 실행합니다.

POST /configuration/v1/types/TYPE_NAME/versions

{
  "metadataBuckets": [
    {
      "bucketName": "EXISTING_BUCKET_NAME",
      "version": "EXISTING_BUCKET_VERSION"
    },
    {
      "bucketName": "NEW_BUCKET_NAME",
      "version": "NEW_BUCKET_VERSION"
    }
  ],
  "storageSpecs": [
    {
      "sink": "BIG_QUERY",
      "disabled": "false",
      "materializeCloudMetadata": "true"
    },
    {
      "sink": "BIG_TABLE",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    },
    {
      "sink": "GCS",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    },
    {
      "sink": "PUBSUB_PROTO",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    },
    {
      "sink": "PUBSUB_JSON",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    }
  ]
}

다음을 바꿉니다.

TYPE_NAME: 새 버전이 생성되는 유형의 이름입니다.
EXISTING_BUCKET_NAME: 이 유형에 이미 연결된 기존 버킷의 이름입니다.
EXISTING_BUCKET_VERSION: 이 유형에 이미 연결된 기존 버킷의 버전입니다.
NEW_BUCKET_NAME: 새 버킷의 이름입니다.
NEW_BUCKET_VERSION: 새 버킷의 버전입니다.

콘솔

콘솔을 사용하여 새 Type Version을 만들려면 Types 섹션 탭을 엽니다.
MDE 인스턴스에서 사용할 수 있는 모든 유형이 이 섹션에 나열됩니다. 목록에는 다음을 비롯한 각 유형의 기본 구성이 표시됩니다.

이름: 유형의 고유 이름입니다. 모든 유형의 고유 이름은 서로 달라야 합니다.
스토리지: 유형과 연결된 현재 스토리지 사양을 표시합니다.
원형: 유형을 정의하는 원형의 이름을 표시합니다. 각 유형은 고유한 원형과 연결됩니다. 유형을 만든 후에는 원형 연결을 수정할 수 없습니다.
버전: 유형의 버전 번호입니다. 유형은 버전이 지정될 수 있습니다. 이 목록의 기본 뷰에는 유형에 사용할 수 있는 최신 버전만 표시됩니다. 최신 버전 표시 체크박스를 선택 해제하면 이전 버전을 표시할 수 있습니다.
메타데이터: 유형과 연결된 각 메타데이터 버킷에 대해 색상 코딩된 배지를 렌더링합니다. 태그 메타데이터 버킷은 배지 내의 특정 아이콘을 사용하여 레코드 메타데이터 버킷과 구분됩니다.
- 변환: 유형과 연결된 각 변환 유형의 배지를 표시합니다.
사용 설정됨: 유형이 사용 설정된 경우 true 값을 표시하고 사용 설정되지 않은 경우 false 값을 표시합니다. 사용자는 언제든지 유형을 사용 설정하거나 사용 중지할 수 있습니다.
활성: 유형이 생성될 때 프로비저닝하는 데 일정 시간이 걸립니다. 유형이 프로비저닝되는 동안 활성 상태는 false입니다. 준비가 되면 true로 표시됩니다.

이 웹 인터페이스에서 새 유형 버전을 만들려면 작업 아이콘을 클릭하고 새 버전 만들기를 클릭합니다. 다음 양식이 표시됩니다.
새 유형 버전 만들기가 열리고 선택한 유형의 설정을 수정하는 양식이 표시됩니다.

양식의 상단 섹션에는 유형의 이름과 원형이 표시됩니다. 이러한 속성은 수정할 수 없습니다. 메타데이터 사양을 변경하거나 데이터 스키마를 수정해야 새 유형 버전이 트리거됩니다. 나머지 유형 매개변수를 수정하면 유형이 업데이트되지만 새 버전이 필요하지는 않습니다.

새 요소를 추가하여 메타데이터 사양과 데이터 스키마를 모두 수정할 수 있습니다. 하지만 모든 새 유형 버전은 이전 버전과 호환되어야 합니다. 메타데이터 버킷을 삭제하여 새 버전의 유형을 만들 수는 없습니다. 메타데이터 버킷 섹션을 열어 새 메타데이터 버킷을 추가할 수 있습니다.