메타데이터 인스턴스 만들기

이 가이드에서는 메타데이터 버킷에서 클라우드 메타데이터 인스턴스를 만드는 방법을 설명합니다. Manufacturing Data Engine (MDE)은 메타데이터 인스턴스를 만드는 두 가지 방법을 제공합니다.

  1. Metadata API 또는 웹 인터페이스 (모든 버킷)
  2. 파서에서 동적으로 (레코드 및 태그 버킷만 해당)

시작하기 전에

이 가이드를 완료하려면 이미 메타데이터 버킷을 만들었어야 합니다.

메타데이터 API 또는 콘솔을 통한 메타데이터 인스턴스 생성

Metadata API 또는 MDE UI를 통해 메타데이터 인스턴스를 만들 수 있습니다. API를 사용하여 외부 소스에서 MDE로 메타데이터 인스턴스를 로드하고 참조 데이터로 조회 버킷을 채울 수 있습니다.

REST API 호출 또는 콘솔에 대한 다음 안내에 따라 클라우드 메타데이터 인스턴스를 만듭니다.

REST

POST metadata/v1/buckets/BUCKET_NAME/BUCKET_VERSION/instances

{
    "naturalKey": "NATURAL_KEY",
    "instance": METADATA_INSTANCE_OBJECT
}

다음을 바꿉니다.

  • BUCKET_NAME을 메타데이터 인스턴스를 만들 버킷의 이름으로 바꿉니다.
  • BUCKET_VERSION를 사용하여 메타데이터 인스턴스를 생성할 메타데이터 버킷의 버전을 지정합니다.
  • NATURAL_KEY 메타데이터 인스턴스의 기본 키를 사용합니다. BUCKET_NAME이 태그 버킷에 해당하는 경우 tagName이어야 합니다. BUCKET_NAME가 레코드 버킷에 해당하고 자연 키가 생략되면 자연 키가 값의 해시로 자동 설정됩니다.
  • METADATA_INSTANCE_OBJECT을 메타데이터 인스턴스 객체로 바꿉니다. 메타데이터 인스턴스 객체는 BUCKET_NAME 및 BUCKET_VERSION에 정의된 스키마를 준수해야 합니다.

콘솔

UI의 상단 메뉴에서 'CLOUD TAGS' 섹션을 열어 Metadata Instance를 만듭니다. 기본 뷰에는 MDE 인스턴스에서 사용할 수 있는 태그 목록이 표시됩니다.

메타데이터 섹션 - 목록

UI에서는 태그 메타데이터 버킷 수정만 지원합니다. 다른 버킷 유형 인스턴스는 API를 사용해서만 만들 수 있습니다. 태그 메타데이터 인스턴스를 만들려면 다음 단계를 따르세요.

  1. 목록에서 선택한 태그의 '작업' 아이콘을 클릭합니다.

  2. '보기 / 수정'을 선택합니다.

    태그 섹션 - 태그 수정

  3. '태그 수정' 측면 메뉴에서 '태그 메타데이터' 섹션을 찾아 메타데이터 인스턴스를 수정하거나 새로 추가합니다.

  4. 구현하려는 버킷의 배지를 클릭합니다. 버킷의 속성이 아래에 표시됩니다.

    태그 섹션 - 태그 메타데이터 수정

  5. 필요에 따라 기존 속성을 수정하거나 새 속성을 추가합니다. 이러한 속성은 수정할 수 있습니다.

  6. 양식의 각 상자에 선택한 값을 추가합니다.

  7. 인스턴스가 완료되면 '저장'을 클릭합니다.

  8. 그런 다음 인스턴스가 버킷 스키마에 대해 검증됩니다. 유효성 검사가 성공하면 인스턴스가 저장되고 성공 메시지가 표시됩니다. 이 인스턴스는 이 태그에 대해 수신된 새 레코드를 검증하는 현재 유효한 인스턴스가 됩니다.

파서에서 동적으로 메타데이터 인스턴스 생성

메타데이터 인스턴스는 메타데이터 인스턴스 참조를 확인하는 lookup by value 메서드를 사용할 때 파서에서 동적으로 만들 수 있습니다. lookup by value 메서드를 사용하고 제공된 자연 키의 최신 메타데이터 인스턴스 값이 존재하지 않으면 MDE는 프로토 레코드에 정의된 인스턴스 객체에서 자연 키의 새 메타데이터 인스턴스를 자동으로 만듭니다. 자세한 내용은 인스턴스 값으로 메타데이터 instance_id를 확인하는 방법에 관한 문서를 참고하세요.