Membuat versi huruf

Panduan ini menjelaskan cara membuat versi jenis baru untuk jenis yang ada di Manufacturing Data Engine (MDE).

Sebelum memulai

Sebelum mulai membuat versi jenis baru untuk jenis yang ada, Anda harus membaca cara membuat jenis.

Batasan pembuatan versi

Saat membuat versi baru jenis, pertimbangkan batasan berikut:

Versi baru dapat:

Tambahkan kolom opsional baru ke skema data.
Menandai kolom wajib diisi sebagai opsional dalam skema data.
Menambahkan referensi bucket metadata baru.

Versi baru mungkin tidak:

Menghapus kolom dari skema data.
Ubah jenis data kolom yang ada dalam skema data.
Menandai atribut opsional sebagai wajib di skema data.
Hapus referensi bucket metadata.

Membuat versi huruf baru

Anda dapat membuat versi jenis baru yang mengaitkan bucket metadata baru dengan jenis yang sudah ada yang sudah memiliki pengaitan bucket metadata dan menerapkan spesifikasi penyimpanan umum menggunakan API atau Konsol.

REST

Jalankan permintaan REST API berikut:

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"
    }
  ]
}

Ganti kode berikut:

TYPE_NAME: Nama jenis yang versi barunya dibuat.
EXISTING_BUCKET_NAME: Nama bucket yang ada dan sudah dikaitkan dengan jenis ini.
EXISTING_BUCKET_VERSION: Versi bucket yang ada sudah dikaitkan dengan jenis ini.
NEW_BUCKET_NAME: Nama bucket baru.
NEW_BUCKET_VERSION: Versi bucket baru.

Konsol

Untuk membuat Versi Jenis baru menggunakan Konsol, buka tab bagian Jenis.
Semua jenis yang tersedia di instance MDE tercantum di bagian ini. Daftar ini menampilkan konfigurasi dasar setiap jenis, termasuk:

Name: Nama jenis yang unik. Semua jenis harus memiliki nama unik yang berbeda.
Penyimpanan: Menampilkan spesifikasi penyimpanan saat ini yang terkait dengan jenis.
Archetype: Menampilkan nama arketipe yang menentukan jenis. Setiap jenis dikaitkan dengan arketipe unik. Asosiasi arketipe tidak dapat diubah setelah jenis dibuat.
Versi: Nomor versi jenis. Jenis dapat diberi versi. Tampilan default dalam daftar ini hanya menampilkan versi terbaru yang tersedia untuk jenis tersebut. Anda dapat menampilkan versi sebelumnya dengan menghapus centang pada kotak Tampilkan Terbaru.
Metadata: Merender badge berkode warna untuk setiap bucket metadata yang terkait dengan jenis. Bucket metadata tag dibedakan dari bucket metadata rekaman menggunakan ikon tertentu di dalam badge.
- Transformasi: Menampilkan badge untuk setiap jenis transformasi yang terkait dengan jenisnya.
Diaktifkan: Menampilkan nilai true jika jenis diaktifkan dan nilai false jika tidak. Pengguna dapat mengaktifkan atau menonaktifkan jenis kapan saja.
Aktif: Saat dibuat, jenis memerlukan waktu tertentu untuk disediakan. Saat jenis sedang disediakan, status aktifnya adalah false. Saat siap, statusnya akan ditampilkan sebagai true.

Untuk membuat Type Version baru di antarmuka web ini, klik ikon Actions, lalu klik Create New Version. Formulir berikut akan muncul:
Create New Type Version akan terbuka dan menampilkan formulir untuk mengubah setelan jenis yang dipilih:

Bagian atas formulir menampilkan nama dan arketipe jenis. Atribut tersebut tidak dapat diubah. Hanya mengubah spesifikasi metadata atau mengubah skema data yang akan memicu versi jenis baru. Mengubah parameter jenis lainnya akan mengupdate jenis, tetapi tidak memerlukan versi baru.

Spesifikasi metadata dan skema data dapat diubah dengan menambahkan elemen baru. Namun, semua versi jenis baru harus kompatibel dengan versi sebelumnya. Bucket metadata tidak dapat dihapus untuk membuat versi baru jenis tersebut. Anda dapat menambahkan bucket metadata baru dengan membuka bagian Bucket Metadata.