Validasi konten

Validator Konten menelusuri LookML Anda untuk menemukan nama model, Jelajah, dan kolom yang dirujuk dalam konten Looker Anda. Ini adalah alat yang berguna untuk memvalidasi referensi LookML, memperbaiki error di LookML setelah Anda melakukan perubahan, dan memperbarui nama elemen LookML di seluruh project.

Anda harus memiliki izin develop untuk menggunakan Validator Konten.

Untuk membuka Content Validator, pilih Content Validator dari menu Develop di panel navigasi kiri. Dari sini, Anda dapat menggunakan Validator Konten dengan dua cara:

• Klik Validasi untuk menemukan dan memperbaiki error yang disebabkan oleh perubahan pada model LookML Anda.
• Klik Cari & Ganti di Semua Konten untuk menemukan dan mengganti nama model, Jelajah, atau kolom di seluruh konten Looker, terlepas dari apakah ada error dalam konten Looker atau tidak.

Sebelum menggunakan Validator Konten

Anda harus sangat berhati-hati saat membuat perubahan menggunakan validasi konten. Pengvalidasi Konten tidak memiliki fungsi undo, dan dapat memengaruhi banyak Tampilan dan dasbor, beserta link Jelajahi dari Sini. Jika Anda melakukan kesalahan, Anda harus mencoba memperbaikinya sesegera mungkin, sebelum perubahan tambahan mempersulit isolasi Tampilan yang terpengaruh.

Selain itu, pertimbangkan waktu Anda saat menggunakan Validator Konten. Saat mendorong perubahan pengembangan ke produksi, Anda harus memperbaiki Tampilan dan kartu yang terpengaruh secara bersamaan, sehingga tidak rusak dalam waktu minimum. Jika Anda memperbaiki Tampilan dan kartu terlalu awal, berdasarkan pekerjaan Anda di Mode Pengembangan, tampilan dan kartu tersebut akan tampak rusak bagi pengguna hingga Anda menerapkan perubahan. Demikian pula, jika Anda menunda perbaikan Tampilan dan kartu hingga lama setelah menerapkan perubahan, Tampilan dan kartu akan tampak rusak bagi pengguna hingga Anda memperbaikinya.

Catatan: Jika Anda menggunakan Pemeriksa Konten untuk mengubah nama kolom yang berfungsi sebagai filter di dasbor, pastikan untuk meninjau bagian Filter di jadwal dasbor dan memperbarui filter sesuai kebutuhan untuk mencerminkan perubahan Anda. Jika pengiriman dasbor terjadwal menyertakan filter yang tidak lagi berfungsi (misalnya, jika kolom yang dirujuk telah berubah), pengiriman terjadwal akan gagal dan pemilik jadwal akan menerima pesan error bahwa filter tidak valid.

Berhati-hatilah saat menggunakan Pemeriksa Konten untuk membuat perubahan pada Jelajah yang digunakan di kartu dasbor hasil gabungan, karena Pemeriksa Konten akan menerapkan perubahan apa pun pada setiap Jelajah yang disertakan dalam kartu hasil gabungan. Misalnya, Anda tidak dapat menggunakan Validator Konten untuk mengubah nama model dalam satu Jelajah di kartu hasil gabungan tanpa mengubah nama model di semua Jelajah yang disertakan dalam hasil gabungan.

Menggunakan Validator Konten untuk memperbaiki error

Validator Konten adalah alat yang berguna untuk menemukan dan memperbaiki error yang dihasilkan dari perubahan pada LookML Anda. Misalnya, jika Anda mengubah nama kolom dari customer menjadi user, semua Tampilan atau kartu dasbor yang menyertakan kolom customer tidak akan berfungsi lagi (kecuali jika Anda menggunakan parameter alias). Validator Konten akan mencantumkan referensi ke kolom customer, dan juga akan memberikan cara mudah untuk memperbaiki error.

Saat Anda menjalankan Validator Konten, validator ini akan memvalidasi semua referensi yang dibuat oleh Tampilan dan dasbor ke model, Jelajahi, tampilan, dan kolom LookML, serta akan menampilkan error untuk setiap referensi yang dibuat konten Anda ke objek LookML yang tidak dikenal.

Validator Konten tidak menampilkan error untuk hal berikut:

• Konten yang izin develop-nya tidak Anda miliki. Content Validator dicakup dalam izin Anda, sehingga Anda hanya dapat menggunakan Content Validator pada konten yang memiliki izin develop (model yang dapat Anda lihat di Looker IDE). Lihat halaman dokumentasi Peran untuk mengetahui informasi tentang izin model.
• Tampilan yang telah dihapus dan berada di Sampah. Jika Anda ingin memvalidasi Tampilan yang dihapus, Lookeradmin Anda harus memulihkan Tampilan terlebih dahulu.

Menjalankan Validator Konten

Penting: Baca bagian Sebelum menggunakan Content Validator sebelum melanjutkan. Validator Konten dapat memengaruhi banyak bagian konten Looker Anda, jadi penting untuk merencanakan dan mempertimbangkannya terlebih dahulu.

Untuk memvalidasi LookML dengan Content Validator:

1. Klik Validasi.
2. Pilih tab Kelompokkan menurut untuk mengubah cara pengelompokan error:
   • Error: Mencantumkan setiap error, dengan mengelompokkan konten Looker yang memiliki error. Hal ini berguna jika Anda ingin memperbaiki error yang sama di beberapa konten sekaligus.
   • Folder: Mencantumkan setiap folder, yang mengelompokkan konten Looker yang memiliki error. Hal ini berguna jika Anda hanya ingin memperbaiki error di folder tertentu.
   • Konten: Mencantumkan setiap bagian konten yang memiliki error, dengan mengelompokkan error-nya. Hal ini berguna jika Anda ingin memperbaiki semua error dalam satu Tampilan, kartu, filter, dll.
3. Jika Anda berada dalam Mode Pengembangan, Looker akan memberikan pesan peringatan. Penting untuk memahami implikasi dari perubahan Tampilan dan kartu. Jika Anda "memperbaiki"nya sebelum perubahan yang menyebabkan error ditayangkan, akan ada periode waktu saat perbaikan tersebut belum selesai, sehingga pengguna akan mengalami Tampilan atau kartu yang rusak. Pesan peringatan membantu Anda mengingat hal ini.
4. Tabel error menampilkan error apa pun, beserta daftar Tampilan dan kartu yang berisi error, serta model dan Jelajah yang mendasarinya yang menghasilkan error. Anda dapat menggunakan tab Kelompokkan menurut di kanan atas halaman untuk mengubah tata letak tabel error.
5. Looker menyediakan tombol Ganti dan/atau Hapus untuk setiap baris, bergantung pada jenis error. Tombol ini menyediakan fungsi untuk memperbaiki error dan dijelaskan secara lebih mendetail di Menggunakan Validator Konten untuk memperbaiki error.

Melihat hasil validasi konten

Hasil validasi konten menampilkan konten Looker yang menggunakan nama model, nama Jelajah, nama tampilan, atau nama kolom yang tidak ada atau tidak dapat ditemukan. Lihat bagian Menggunakan Validator Konten untuk memperbaiki error guna mengetahui detail tentang elemen LookML yang dapat ditemukan dan divalidasi oleh Validator Konten.

Ikon di samping nama konten mengidentifikasi jenis konten:

• — Kartu dasbor
• — Notifikasi dasbor
• — Jadwal untuk dasbor atau Look
• — Filter untuk dasbor, atau kolom di kartu yang memproses filter dasbor (lihat halaman dokumentasi Menambahkan dan mengedit filter dasbor yang ditentukan pengguna untuk mengetahui informasi tentang cara mengonfigurasi kartu agar memproses filter dasbor)

Hasil validasi didasarkan pada LookML yang tersedia dalam mode yang Anda gunakan saat menjalankan validator. Jika Anda menggunakan Mode Produksi, hasil validasi akan mencerminkan semua LookML yang telah di-push ke produksi. Jika Anda berada dalam Mode Pengembangan, hasil validasi akan mencerminkan LookML yang disimpan, meskipun belum di-push ke produksi.

Error dapat disebabkan oleh perubahan yang disengaja pada LookML Anda serta kesalahan ketik atau join yang hilang.

Untuk menyesuaikan error, Anda dapat menggunakan tombol Ganti dan Hapus di setiap baris tabel error sebagai berikut:

• Ganti: Looker menyediakan tombol Ganti untuk setiap error (lihat bagian Mengganti nama untuk kolom, tampilan, Jelajahi, dan model di halaman ini untuk mengetahui cara mengganti nama dengan Validator Konten).
• Hapus: Untuk error pada nama kolom di bagian Data pada Tampilan atau kartu, Looker juga menampilkan tombol Hapus (lihat bagian Menghapus nama kolom nanti di halaman ini untuk mengetahui cara menghapus nama dengan Content Validator).

Bergantung pada setelan Kelompokkan menurut, tombol akan diterapkan ke satu item (Tampilan atau kartu), atau ke beberapa item:

• Jika Anda mengelompokkan menurut Error, tombol tersebut akan berlaku untuk semua kemunculan error tersebut di semua Tampilan dan kartu di instance Looker Anda — yang memungkinkan Anda memperbaiki semua kemunculan dalam satu operasi.
• Jika Anda mengelompokkan menurut Folder atau menurut Konten, tombol tersebut akan berlaku untuk satu kemunculan error dalam satu Tampilan atau kartu — yang memungkinkan Anda mempertimbangkan setiap kemunculan error secara terpisah.

Misalnya, tabel error dikelompokkan menurut Error dan menampilkan tiga instance konten dengan Jelajah yang tidak diketahui bernama customers. Tindakan yang disediakan untuk ketiga konten tersebut adalah Ganti. Mengklik Ganti akan memengaruhi ketiga instance konten dengan error 3 x Unknown explore 'customers'.

Dalam beberapa kasus, beberapa error mungkin ada untuk beberapa konten. Misalnya, tabel error dikelompokkan menurut Konten dan menampilkan bagian konten yang disebut Detail Pesanan. Ada empat error Unknown field yang ditampilkan di kolom Errors, dan setiap error memiliki tombol tindakan Replace dan Remove sendiri di kolom Actions.

Selain itu, jika mengelompokkan menurut Konten, Anda memiliki opsi tambahan untuk menghapus Tampilan.

Mengganti nama untuk kolom, tampilan, Eksplorasi, dan model

Hasil validasi konten menyertakan tombol Ganti untuk jenis elemen berikut sehingga Anda dapat mengganti namanya:

• Nama model di kartu dasbor dan Look
• Menjelajahi nama di kartu dasbor dan Look
• Melihat nama di filter kustom atau penghitungan tabel
• Melihat nama di kartu dasbor dan Look
• Nama kolom:
  • Di bagian Data pada Tampilan
  • Di kartu dasbor berbasis kueri
  • Direferensikan dalam kalkulasi tabel
  • Direferensikan dalam filter kustom
  • Direferensikan di kolom kustom
  • Direferensikan dalam konfigurasi visualisasi, seperti area Penyesuaian di tab Deret untuk diagram kolom
  • Dirujuk oleh kartu dasbor untuk memproses filter dasbor (ini dikonfigurasi di tab Kartu yang Akan Diperbarui pada jendela konfigurasi filter, yang dijelaskan di halaman dokumentasi Menambahkan dan mengedit filter dasbor yang ditentukan pengguna)

Untuk setiap error ini, Anda dapat menggunakan Validator Konten untuk mengganti atribut konten yang sama dengan atau lebih umum daripada atribut yang mengalami error:

• Jika kolom mengalami error, Anda dapat mengganti/menghapus kolom, atau mengganti nama tampilan, Jelajahi, atau model.
• Jika nama Jelajah mengalami error, Anda dapat mengganti nama Jelajah atau nama model.
• Jika nama model mengalami error, Anda dapat mengganti nama model.

Berikut adalah cara menggunakan Validator Konten untuk mengganti nama elemen dalam model Anda:

1. Klik Validasi untuk menjalankan Validator Konten.
2. Pilih setelan Kelompokkan menurut untuk memilih cara error dikelompokkan. Misalnya, Anda dapat mengelompokkan berdasarkan Error sehingga Anda dapat menyesuaikan beberapa item secara bersamaan.

3. Di tabel error, klik tombol Ganti di samping error yang ingin Anda perbaiki untuk membuka dialog Perbarui di Konten.

4. Di bagian Jenis pada dialog Perbarui di Konten, pilih jenis elemen LookML yang ingin Anda ubah: kolom, tampilan, Jelajahi, atau model. Looker menampilkan opsi yang sesuai untuk setiap error.

5. Di bagian Name, verifikasi nama item yang ingin Anda ganti. Validator Konten akan mengisi informasi ini secara otomatis.

6. Di bagian Nama Pengganti, masukkan nama baru item.

7. Jika Anda telah mengelompokkan menurut Error dan ada beberapa item yang akan terpengaruh, Anda dapat mengklik Tampilkan Konten untuk melihat daftar item yang akan diperbarui oleh Validator Konten.

   

8. Secara opsional, Anda dapat menghapus centang pada kotak di samping item yang tercantum agar nama item tersebut tidak berubah.

9. Untuk melakukan perubahan, klik Ganti.

Menghapus nama kolom

Untuk error dengan nama kolom di bagian Data pada Tampilan atau kartu, tabel error akan menyediakan tombol Hapus di sebelah kanan error. Anda dapat menggunakan Validator Konten untuk menghapus kolom yang:

• Di bagian Data pada kartu Look atau dasbor
• Direferensikan dalam konfigurasi visualisasi, seperti area Penyesuaian di tab Deret untuk diagram kolom
• Dirujuk oleh kartu dasbor untuk memproses filter dasbor (ini dikonfigurasi di tab Kartu yang Akan Diperbarui pada jendela konfigurasi filter, yang dijelaskan di halaman dokumentasi Menambahkan dan mengedit filter dasbor yang ditentukan pengguna)

Anda tidak dapat menggunakan Validator Konten untuk menghapus kolom dari filter kustom, kolom kustom, atau penghitungan tabel, karena biasanya Anda perlu melakukan perubahan tambahan agar ekspresi tetap berfungsi. Sebagai gantinya, gunakan pesan error validasi konten untuk menemukan tempat filter kustom, kolom kustom, dan ekspresi penghitungan tabel perlu diperbaiki, lalu buat ulang ekspresi sesuai kebutuhan.

1. Klik Validasi untuk menjalankan Validator Konten.
2. Pilih setelan Kelompokkan menurut untuk memilih cara error dikelompokkan. Misalnya, Anda dapat mengelompokkan menurut Error sehingga Anda dapat menyesuaikan beberapa item (Tampilan, kartu, atau keduanya) secara bersamaan.

3. Di tabel error, klik Hapus di samping error kolom yang ingin Anda perbaiki untuk membuka dialog Hapus Kolom dari Konten.

   

4. Di bagian Kolom pada dialog Hapus Kolom dari Konten, verifikasi nama item yang ingin Anda hapus. Validator Konten akan mengisinya secara otomatis.

5. Jika Anda telah mengelompokkan menurut Error dan ada beberapa item (Tampilan, kartu, atau keduanya), Anda dapat mengklik Tampilkan Konten untuk melihat daftar item yang akan diperbarui oleh Validator Konten.

   

6. Secara opsional, Anda dapat menghapus centang pada kotak di samping Tampilan atau kartu agar nama tidak berubah.

7. Klik Hapus Kolom untuk melakukan perubahan.

Menghapus Tampilan

Jika mengelompokkan tabel error menurut Konten, Anda memiliki opsi untuk menghapus Tampilan dalam tabel.

Untuk menggunakan Validator Konten guna menghapus Tampilan:

1. Klik Validasi untuk menjalankan Validator Konten.
2. Kelompokkan tabel menurut Konten.
3. Di tabel error, klik kotak Select di samping Tampilan atau Tampilan yang ingin Anda hapus.
4. Klik Hapus semua Tampilan yang dipilih.
5. Klik OK di kotak konfirmasi untuk menghapus Tampilan atau Tampilan yang dipilih.

Catatan: Jika Anda tidak sengaja menghapus Tampilan, admin Looker mungkin dapat memulihkannya untuk Anda. Looker menyimpan konten yang dihapus di sampah hingga tim admin Looker mengosongkan sampah sebagai bagian dari proses pemeliharaan mereka.

Menggunakan Validator Konten untuk menemukan dan mengganti

Validator Konten juga dapat digunakan untuk menelusuri dan mengganti nama model, Jelajah, dan kolom. Misalnya, Anda mungkin memutuskan bahwa Anda lebih memilih satu kolom daripada kolom lainnya dan ingin melakukan penggantian tersebut dalam project Anda, meskipun tidak ada error. Daftar lengkap elemen yang dapat ditelusuri/diganti oleh Content Validator disediakan di bagian Mengganti nama untuk kolom, tampilan, Jelajah, dan model.

Penting: Baca bagian Sebelum menggunakan Content Validator sebelum melanjutkan. Validator Konten dapat memengaruhi banyak bagian konten Looker Anda, jadi penting untuk merencanakan dan mempertimbangkannya terlebih dahulu.

Untuk menggunakan Validator Konten sebagai alat cari dan ganti:

1. Di layar Content Validator, klik Find & Replace in All Content untuk membuka dialog Update in Content.
2. Pilih Jenis elemen LookML yang ingin Anda ubah (kolom, tampilan, Jelajah, atau model).
3. Masukkan Nama item yang ingin Anda ganti.
4. Masukkan Nama Pengganti untuk kolom, tampilan, Jelajahi, atau model.
5. Klik Ganti untuk melakukan perubahan.

Hal-hal yang perlu dipertimbangkan

Rencanakan untuk menjalankan ulang validasi konten guna melihat hasil perbaikan yang Anda lakukan.

Perhatikan hal-hal berikut tentang Validator Konten:

• Untuk tampilan, Jelajah, atau model, Anda dapat mengubah namanya, tetapi tidak dapat menghapus namanya sepenuhnya. Lihat bagian Menghapus nama kolom untuk mengetahui daftar item yang dapat Anda hapus dengan Validator Konten.
• Penghitungan tabel hanya dapat mereferensikan kolom yang disertakan dalam kueri Tampilan atau kartu. Artinya, jika Anda menghapus kolom dari kueri Tampilan atau kartu, tetapi penghitungan tabel masih menggunakan kolom tersebut, Anda akan mendapatkan error validasi konten baru.
• Tampilan yang telah dihapus dan berada di halaman Sampah tidak akan divalidasi. Jika Anda ingin memvalidasi Tampilan yang dihapus, admin Looker harus memulihkan Tampilan terlebih dahulu.
• Jika Anda berada dalam Mode Pengembangan, hasil validasi akan mencerminkan LookML yang disimpan meskipun belum di-push ke produksi. Namun, setiap perubahan yang Anda buat menggunakan Validator Konten akan memengaruhi pengguna yang melihat konten dalam mode Produksi. Pertimbangkan untuk beralih ke mode Produksi sebelum menjalankan Validator Konten.