유형 만들기

이 가이드에서는 Manufacturing Data Engine (MDE)에서 새 유형을 만드는 방법을 설명합니다. 구성 API 또는 MDE 웹 인터페이스를 사용하여 유형을 만들 수 있습니다.

시작하기 전에

다른 구성 설정 중에서 유형을 사용하면 해당 유형의 레코드에 대한 컨텍스트화 범위를 정의할 수 있습니다. 즉, 레코드의 컨텍스트화에 사용할 수 있거나 사용해야 하는 메타데이터 버킷입니다. 메타데이터 버킷을 유형에 연결하려면 먼저 버킷을 만들어야 합니다. 자세한 내용은 메타데이터 버킷을 만드는 방법을 참고하세요.

유형 이름 지정

유형을 만들 때 이름은 MDE 배포에서 고유해야 합니다. 유형 이름에는 &, @, %와 같은 공백이나 특수문자를 사용할 수 없습니다.

유형 만들기

메타데이터 버킷 연결 하나와 일반적인 스토리지 사양으로 유형을 만들려면 터미널 또는 콘솔 인터페이스를 사용하면 됩니다.

REST

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

POST /configuration/v1/types

{
  "archetype": "ARCHETYPE NAME",
  "name": "TYPE_NAME",
  "metadataBuckets": [
    {
      "bucketName": "BUCKET_NAME",
      "version": "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"
    }
  ]
}

다음을 바꿉니다.

ARCHETYPE: 원형의 이름입니다. DISCRETE_DATA_SERIES, CLUSTERED_DISCRETE_DATA_SERIES, NUMERIC_DATA_SERIES, CLUSTERED_NUMERIC_DATA_SERIES, CONTINUOUS_DATA_SERIES, CLUSTERED_CONTINUOUS_DATA_SERIES 중 하나입니다.
TYPE_NAME: 만들 유형의 이름입니다.
BUCKET_NAME: 이 유형과 연결할 버킷의 이름입니다.
BUCKET_VERSION: 이 유형과 연결할 버킷의 버전입니다.

콘솔

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

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

각 새 유형은 생성될 때 모든 데이터 싱크의 태그와 레코드를 저장하기 위해 자체 인프라를 프로비저닝합니다. 예를 들어 새 유형은 유형의 새 테이블을 BigQuery에 만들고 원형에 해당하는 스키마를 자동으로 채웁니다. 유형이 프로비저닝되는 동안에는 Non Active로 표시됩니다.

새 유형을 만들려면 새 유형 추가를 클릭합니다. 다음 양식이 표시됩니다.
새 유형을 정의하려면 이름과 원형을 제공합니다. 유형이 생성되면 이름과 원형을 변경할 수 없습니다. 모든 유형의 이름은 고유해야 합니다. 사용 가능한 원형 목록에서 원형을 선택해야 합니다. 기존 원형은 시스템 구성의 일부이므로 만들거나 수정할 수 없습니다.
데이터 스키마 섹션을 열어 필요한 경우 새 유형의 데이터 필드를 정의하는 JSON schema를 정의합니다.
데이터 스키마는 유효한 JSON Schema이어야 하며, 그렇지 않으면 허용되지 않습니다. 이 데이터 스키마는 수집 파이프라인의 일부로 적용되지 않습니다. 향후 MDE 버전에서는 수신 메시지의 데이터 객체가 해당 유형의 데이터 스키마에 대해 검사됩니다. 데이터 스키마는 다양한 데이터 싱크에서 사용할 수 있는 데이터 필드의 구조를 보여줍니다. 각 데이터 스키마 사양도 원형의 특성에 따라 정의해야 합니다.
메타데이터 버킷 섹션을 열어 유형과 연결된 메타데이터 버킷을 정의하여 새 유형의 정의를 완료합니다.
유형에 메타데이터 버킷을 추가하려면 추가를 클릭합니다.
사용 가능한 메타데이터 버킷 목록에서 추가할 버킷을 선택합니다. 이러한 버킷의 최신 버전만 표시됩니다. 메타데이터 버킷 버전은 나중에 유형의 새 버전을 만들어 업데이트할 수 있습니다. 버킷이 추가되면 메타데이터 섹션에 새 배지가 표시됩니다.
양식의 저장 설정 섹션을 열어 기본 저장 설정을 정의합니다. 이 섹션에는 이 MDE 인스턴스에서 사용할 수 있는 각 데이터 싱크의 전환 버튼이 있습니다.
이 유형에 속하는 태그가 기본적으로 저장될 싱크를 각각 선택합니다. 스토리지 사양은 태그가 생성될 때 태그에 상속됩니다. 저장소 사양은 언제든지 태그 수준에서 수정할 수 있습니다.
새 유형의 정의를 완료하려면 변환 및 연결 섹션을 열어 이 유형과 연결된 변환을 선택합니다.
유형과 연결할 변환을 선택하고 변환 구성 방법에 따라 매개변수를 정의합니다.
모든 매개변수를 추가한 후 만들기를 클릭하여 새 유형을 저장합니다. 매개변수가 잘못되면 오류 메시지가 표시됩니다. 작업이 성공하면 확인 메시지가 표시됩니다.