Membuat versi bucket metadata

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

Versi bucket metadata memungkinkan Anda mengembangkan skema bucket. Jenis dan parser selalu mereferensikan versi bucket tertentu, jadi saat Anda membuat versi baru, hal ini tidak memengaruhi pipeline pemrosesan data yang ada. Anda harus mengupgrade jenis dan parser atau membuat jenis dan parser baru untuk menggunakan versi bucket baru. Anda dapat membuat versi bucket metadata menggunakan Configuration API atau antarmuka web MDE.

Sebelum memulai

Panduan ini mengharuskan Anda telah membuat bucket metadata untuk MDE.

Batasan pembuatan versi

Saat membuat versi baru bucket, pertimbangkan batasan berikut:

Versi baru dapat:

• Tambahkan kolom opsional baru.
• Menandai kolom wajib diisi sebagai opsional.

Versi baru mungkin tidak:

• Menghapus kolom.
• Mengubah jenis data kolom yang ada.
• Menandai atribut opsional sebagai wajib.

Membuat versi bucket metadata baru

Anda dapat membuat versi bucket metadata menggunakan terminal atau konsol.

REST

Jalankan permintaan REST API berikut:

POST /metadata/v1/buckets/BUCKET_NAME/versions

{
  "schema": "BUCKET_SCHEMA",
  "provider": "local"
}

Ganti kode berikut:

• BUCKET_NAME: Nama bucket yang akan dibuat.
• BUCKET_TYPE: Jenis bucket yang akan dibuat. Harus salah satu dari TAG, RECORD, atau LOOKUP. natural_key instance metadata dalam bucket TAG harus berupa nama tag. natural_key instance metadata dalam bucket RECORD dapat berupa kunci apa pun. natural_key dari instance metadata dalam bucket LOOKUP dapat berupa kunci apa pun, tetapi rekaman tidak dapat mereferensikan instance dalam bucket pencarian, dan instance tidak ditulis ke sink data apa pun. Bucket penelusuran hanya berfungsi sebagai sumber data referensi yang dapat diambil oleh parser menggunakan fungsi Whistle lookupByKey dan digunakan untuk memperkaya data.
• BUCKET_SCHEMA: Skema JSON bucket. Skema membatasi instance yang dapat dibuat di bucket.
• INSTANCE_OVERWRITE_MODE: TRUE atau FALSE. Menentukan apakah instance baru dibuat dengan menggabungkan instance yang diberikan dengan instance terbaru untuk kunci alami tertentu atau apakah instance baru dibuat seperti yang diberikan.

Konsol

1. Untuk membuat versi bucket metadata baru, klik Buat Versi Baru dari bagian METADATA di antarmuka web Cloud Management MC:

   

2. Panel konfigurasi ditampilkan dengan formulir untuk memperbarui parameter versi bucket metadata baru:

   

   Hanya perubahan yang kompatibel dengan versi lama yang diizinkan untuk versi baru. Perubahan baru dan perubahan yang menyebabkan gangguan memerlukan pembuatan bucket baru. Di panel ini, Anda dapat memperbarui hal berikut:

   • Mode update instance: Mengubah perilaku penyerapan instance bucket.
   • Skema metadata: Menambahkan atribut baru ke skema bucket yang ada.

3. Setelah perubahan diterapkan, klik BUAT untuk menyimpan versi baru bucket metadata.

4. Pesan error akan ditampilkan jika perubahan tidak berhasil. Pesan berhasil akan ditampilkan jika perubahan berhasil. Nomor versi baru bersifat berurutan dan ditetapkan secara otomatis ke bucket.