Validasi konten

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

Anda harus memiliki izin develop untuk menggunakan Validator Konten.

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

Sebelum menggunakan Validator Konten

Anda harus extremely berhati-hati saat membuat perubahan menggunakan validasi konten. Validator Konten tidak memiliki fungsi urungkan, dan berpotensi memengaruhi banyak Tampilan dan dasbor, beserta link Jelajahi dari Sini. Jika Anda melakukan kesalahan, Anda harus berusaha memperbaikinya sesegera mungkin, sebelum perubahan tambahan mempersulit isolasi Tampilan yang terpengaruh.

Selain itu, pertimbangkan waktu Anda saat menggunakan Validator Konten. Saat menerapkan perubahan pengembangan ke produksi, Anda harus memperbaiki tampilan dan kartu yang terpengaruh kira-kira pada waktu yang bersamaan, sehingga akan rusak selama jangka waktu minimum. Jika Anda memperbaiki tampilan dan kartu terlalu awal, berdasarkan pekerjaan Anda dalam Mode Pengembangan, fitur tersebut akan terlihat rusak kepada pengguna sampai Anda menerapkan perubahan. Demikian pula, jika Anda menunda untuk memperbaiki Tampilan dan kotak hingga lama setelah menerapkan perubahan, Tampilan dan kotak akan terlihat rusak kepada pengguna hingga Anda memperbaikinya.

Menggunakan Validator Konten untuk memperbaiki kesalahan

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

Saat Anda menjalankan Validator Konten, Validator Konten memvalidasi semua referensi yang dibuat oleh Tampilan dan dasbor Anda pada model, Eksplorasi, tampilan, dan kolom LookML, dan 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 developnya tidak Anda miliki. Validator Konten tercakup dalam izin Anda, sehingga Anda hanya dapat menggunakan Validator Konten pada konten yang izin developnya Anda miliki (model yang dapat dilihat di Looker IDE). Lihat halaman dokumentasi Peran untuk informasi tentang izin model.
  • Sepertinya yang telah dihapus dan ada di Sampah. Jika Anda ingin memvalidasi Tampilan yang dihapus, admin Looker Anda harus memulihkan Tampilan tersebut terlebih dahulu.

Menjalankan Validator Konten

Untuk memvalidasi LookML dengan Validator Konten:

  1. Klik Validasi.
  2. Pilih tab Group by untuk mengubah cara error dikelompokkan:
    • Error: Cantumkan setiap error, dengan mengelompokkan konten Looker yang mengalami error tersebut. Hal ini berguna jika Anda ingin memperbaiki error yang sama di beberapa konten sekaligus.
    • Folder: Cantumkan setiap folder, dengan mengelompokkan konten Looker yang memiliki error. Hal ini berguna jika Anda hanya ingin memperbaiki error dalam folder tertentu.
    • Konten: Cantumkan setiap 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 perubahan Tampilan dan ubin. Jika Anda "memperbaikinya" sebelum mengaktifkan perubahan yang dapat menyebabkan gangguan, akan ada jangka waktu perbaikan bersifat prematur, sehingga pengguna akan mengalami Tampilan atau kotak yang rusak. Pesan peringatan membantu Anda mengingat hal ini.
  4. Tabel error menampilkan error, beserta daftar Tampilan dan ubin yang berisi error, serta model dasar dan Jelajah yang menyebabkan 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 bawah.

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 kesalahan untuk detail tentang elemen LookML yang dapat ditemukan dan divalidasi oleh Validator Konten.

Ikon di samping nama konten mengidentifikasi jenis konten:

  • Ikon kotak di dasbor. — Kartu dasbor
  • Ikon notifikasi di dasbor. — Pemberitahuan dasbor
  • Ikon Jadwal di dasbor atau Jadwal di Tampilan. — Menjadwalkan untuk dasbor atau Look
  • Ikon filter di dasbor. — Filter untuk dasbor, atau kolom di kartu yang memproses filter dasbor (lihat halaman dokumentasi Menambahkan dan mengedit filter dasbor yang ditetapkan pengguna untuk mendapatkan informasi tentang cara mengonfigurasi kartu guna memproses filter dasbor)

Hasil validasi didasarkan pada LookML yang tersedia di mode Anda saat menjalankan validator. Jika Anda berada dalam Mode Produksi, hasil validasi akan mencerminkan semua LookML yang telah didorong ke produksi. Jika Anda berada dalam Mode Pengembangan, hasil validasi akan mencerminkan LookML yang tersimpan, meskipun belum diteruskan ke produksi.

Error mungkin disebabkan oleh perubahan yang disengaja dalam LookML Anda serta kesalahan ketik atau gabungan yang hilang.

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

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

Bergantung pada setelan Group by Anda, tombol akan berlaku untuk satu item (Lihat atau kartu), atau ke beberapa item:

  • Jika Anda mengelompokkan berdasarkan Error, tombol tersebut akan berlaku untuk semua kemunculan error tersebut di semua Tampilan dan kotak di instance Looker Anda, sehingga Anda dapat memperbaiki semua kemunculan dalam satu operasi.
  • Jika Anda mengelompokkan berdasarkan Folder atau Konten, tombol akan berlaku untuk satu kemunculan error dalam satu Tampilan atau kotak, sehingga Anda dapat mempertimbangkan setiap kemunculan error secara terpisah.

Misalnya, tabel error dikelompokkan berdasarkan Error dan menampilkan tiga instance konten dengan Jelajah yang tidak dikenal bernama customers. Tindakan yang diberikan 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 muncul untuk beberapa konten. Misalnya, tabel error dikelompokkan berdasarkan Konten dan menampilkan bagian konten yang disebut Detail Pesanan. Ada empat error Unknown field yang ditampilkan di kolom Error, dan setiap error memiliki tombol tindakan Replace dan Remove di kolom Actions.

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

Mengganti nama untuk kolom, tampilan, Jelajah, dan model

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

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

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

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

  1. Klik Validasi untuk menjalankan Validator Konten.
  2. Pilih setelan Group by untuk memilih cara error dikelompokkan. Misalnya, Anda dapat mengelompokkan berdasarkan Error agar Anda dapat menyesuaikan beberapa item sekaligus.

  3. Dalam tabel error, klik tombol Ganti di samping error yang ingin Anda perbaiki untuk membuka dialog Update dalam Konten.

  4. Di bagian Type pada dialog Update in Content, pilih jenis elemen LookML yang ingin Anda ubah: kolom, tampilan, Jelajahi, atau model. Looker menampilkan opsi yang sesuai untuk setiap error.

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

  6. Di bagian Penggantian Nama Kolom, masukkan nama baru item.

  7. Jika pengelompokan dilakukan berdasarkan Error dan ada beberapa item yang akan terpengaruh, Anda dapat mengklik Tampilkan Konten untuk melihat daftar item yang akan diperbarui oleh Validator Konten.

  8. Atau, Anda dapat menghapus centang pada kotak di samping item yang tercantum agar namanya tidak berubah.

  9. Untuk melakukan perubahan, klik Ganti.

Menghapus nama kolom

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

  • Di bagian Data pada kartu Tampilan atau dasbor
  • Direferensikan dalam konfigurasi visualisasi, seperti area Penyesuaian di tab Seri untuk diagram kolom
  • Dirujuk oleh ubin dasbor untuk memproses filter dasbor (ini dikonfigurasi di tab Ubin untuk Memperbarui 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 yang memerlukan perbaikan filter kustom, kolom kustom, dan ekspresi penghitungan tabel, lalu kerjakan ulang ekspresi tersebut sebagaimana mestinya.

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

  3. Pada tabel error, klik Remove di samping error kolom yang ingin Anda perbaiki untuk membuka dialog Remove from Content.

  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 pengelompokan dilakukan berdasarkan 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. Jika ingin, Anda dapat menghapus centang pada kotak di samping Tampilan atau kotak agar namanya tidak berubah.

  7. Klik Hapus Kolom untuk membuat perubahan.

Menghapus Tampilan

Jika mengelompokkan tabel error menurut Konten, Anda memiliki opsi untuk menghapus Tampilan di 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 Pilih di samping Tampilan atau Tampilan yang ingin dihapus.
  4. Klik Hapus semua Tampilan yang dipilih.
  5. Klik Oke di kotak konfirmasi untuk menghapus Tampilan atau Tampilan yang dipilih.

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 menyukai satu kolom daripada yang lain dan ingin membuat pengganti itu dalam project Anda, meskipun tidak ada error. Daftar lengkap elemen yang dapat ditelusuri/diganti oleh Validator Konten tersedia di bagian Mengganti nama untuk kolom, tampilan, Jelajah, dan model di atas.

Untuk menggunakan Validator Konten sebagai alat cari dan ganti:

  1. Di layar Validator Konten, klik Cari & Ganti di Semua Konten untuk membuka dialog Perbarui di Konten.
  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 Penggantian untuk kolom, tampilan, Jelajah, atau model.
  5. Klik Ganti untuk melakukan perubahan.

Hal-hal yang perlu dipertimbangkan

Rencanakan untuk menjalankan kembali validasi konten untuk melihat hasil perbaikan apa pun yang Anda lakukan.

Perhatikan hal-hal berikut tentang Validator Konten:

  • Untuk tampilan, Jelajah, atau model, Anda dapat mengubah namanya, tetapi Anda tidak dapat menghapus namanya sepenuhnya. Lihat bagian Menghapus nama kolom untuk 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.
  • Tampaknya yang telah dihapus dan berada di halaman Sampah tidak akan divalidasi. Jika Anda ingin memvalidasi Tampilan yang dihapus, admin Looker Anda harus memulihkan Tampilan tersebut terlebih dahulu.
  • Jika Anda berada dalam Mode Pengembangan, hasil validasi akan mencerminkan LookML yang tersimpan meskipun belum diteruskan ke produksi. Namun, perubahan apa pun yang Anda lakukan menggunakan Validator Konten akan memengaruhi pengguna yang melihat konten dalam mode Produksi. Pertimbangkan untuk beralih ke mode Produksi sebelum menjalankan Validator Konten.