메타데이터 버킷 만들기

이 가이드에서는 메타데이터 버킷을 만드는 방법을 설명합니다. Configuration API 또는 Manufacturing Data Engine (MDE) 웹 인터페이스를 사용하여 메타데이터 버킷을 만들 수 있습니다.

시작하기 전에

버킷을 만들기 전에 MDE 문서의 메타데이터 모델링 방법 섹션을 읽어보세요.

버킷 이름 지정

버킷을 만들 때 이름은 MDE 배포에서 고유해야 합니다. 버킷 이름에는 공백이나 &, @, %와 같은 특수문자가 포함되어서는 안 됩니다.

메타데이터 버킷 만들기

터미널 또는 콘솔 인터페이스를 사용하여 메타데이터 버킷을 만들 수 있습니다.

REST

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

POST /metadata/v1/buckets

  {
    "name": "BUCKET_NAME",
    "type": "BUCKET_TYPE",
    "schema": "BUCKET_SCHEMA",
    "provider": "local",
    "attributes": {
      "instanceOverwriteMode": "INSTANCE_OVERWRITE_MODE"
    }
  }

다음을 바꿉니다.

  • 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입니다. 제공된 인스턴스를 지정된 자연 키의 최신 인스턴스와 병합하여 새 인스턴스를 만들지 아니면 제공된 대로 새 인스턴스를 만들지 결정합니다.

콘솔

콘솔을 사용하여 새 메타데이터 버킷 을 추가하려면 클라우드 관리 섹션의 상단 메뉴에서 메타데이터 섹션을 클릭합니다. 메타데이터 구성 페이지에는 MDE 인스턴스에서 사용할 수 있는 버킷 이 나열됩니다.

유형 섹션 - 메타데이터 목록

각 버킷 에 대해 다음 정보가 제공됩니다.

  • 이름: 버킷의 이름입니다. 각 이름은 고유해야 합니다.
  • 버전: 버킷의 버전입니다. 기본적으로 사용 가능한 최신 버전만 표시됩니다. 이전 버전을 표시하려면 '최신 버전만' 체크박스를 선택 해제합니다.
  • 버킷 유형: 버킷의 유형을 시각화합니다. 다음과 같은 세 가지 버킷 유형이 지원됩니다.
    1. 태그: 지정된 태그를 한정하는 버킷입니다. 유형과 연결되어 있으며 해당 유형의 모든 태그에서 상속됩니다. 특정 레코드가 아닌 변수 자체를 한정하기 위한 것이므로 태그 수준에서 인스턴스화할 수 있습니다. 태그 버킷의 예로는 태그의 '애셋 계층 구조' 또는 '측정 단위'가 있습니다.
    2. 레코드: 레코드 버킷은 지정된 태그의 각 레코드를 한정합니다. 또한 유형과 연결되어 있으며 태그에서 상속되지만 레코드 수준에서 인스턴스화됩니다. 각 레코드는 제한된 버킷 인스턴스 집합 중에서 서로 다른 값을 가져야 합니다. 레코드 버킷의 예로는 '교대' 또는 '운영자 이름'이 있습니다.
    3. 참조: 사용자 정의 키와 인스턴스 간의 키-값 쌍 집합을 정의하는 버킷입니다.

새 버킷 을 만들려면 새 메타데이터 버킷 추가 를 클릭합니다.

유형 섹션 - 유형 목록

측면 패널에 표시된 양식에 필요한 버킷 매개변수를 입력합니다.

  • 버킷 이름: 버킷의 고유한 사용자 정의 이름입니다.
  • 버킷 유형: 버킷 클래스를 정의합니다.
  • 인스턴스 업데이트 모드: 메타데이터 버킷에 지정된 인스턴스 업데이트 유형을 지정합니다.
    1. 인스턴스 재정의: 기존 인스턴스가 불완전하더라도 에지에서 수신된 최신 인스턴스로 대체됩니다.
    2. 인스턴스 병합: 기존 인스턴스가 에지에서 수신된 최신 인스턴스와 병합됩니다. 새 에지 인스턴스에 포함된 속성만 대체됩니다.
  • JSON 스키마: JSON Schema의 구조를 정의하는 버킷입니다. 유효한 스키마여야 합니다. 모든 메타데이터 인스턴스는 버킷 스키마에 대해 검증됩니다.

다음은 기본 구성 패키지에서 제공하는 기본 메타데이터 버킷 의 샘플 JSON Schema입니다.

{
  "$id": "https://gmde.cloud/tag.schema.json",
  "$schema": "https://json-schema.org/draft/2019-09/schema",
  "title": "Tag metadata bucket",
  "type": "object",
  "properties": {
    "datatype": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "registerId": {
      "type": "string"
    },
    "edgeTagName": {
      "type": "string"
    },
    "tagName": {
      "description": "Tag name",
      "type": "string"
    },
    "deviceID": {
      "type": "string"
    },
    "deviceName": {
      "type": "string"
    },
    "deviceMetadata": {
      "type": "object"
    }
  },
  "required": ["tagName"],
  "additionalProperties": false
}