Validasi konten

Validator Konten menelusuri LookML Anda untuk menemukan nama model, Jelajah, dan kolom yang dirujuk dalam konten Looker (Tampilan dan dasbor). 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.

Alasannya adalah developer harus dapat memperbaiki konten yang mungkin rusak saat developer membuat perubahan pada LookML yang mendasarinya.

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

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.

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 apa pun ke kolom customer dan juga akan menyediakan tombol Ganti atau Hapus untuk memperbaiki error.

Saat Anda menjalankan Validator Konten, validator 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:

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

Menjalankan Validator Konten

Untuk meningkatkan performa Content Validator, admin Looker dapat mengaktifkan fitur Lab Cakupan Content Validator di instance Anda. Jika fitur Labs ini diaktifkan, Anda dapat menentukan cakupan validasi ke project LookML tertentu dan folder konten tertentu. Lihat bagian Menentukan Cakupan Validator Konten untuk mengetahui informasi tentang cara menentukan cakupan validasi.

Jika fitur Content Validator Scoping Labs tidak diaktifkan di instance Anda, ikuti langkah-langkah berikut untuk menjalankan validasi konten:

  1. Klik ikon Menu utama Looker dan pilih Kembangkan, jika menu Kembangkan belum ditampilkan.
  2. Dari menu Develop, pilih Content Validator.
  3. Di halaman Validator Konten, klik Validasi.

Validator Konten akan menjalankan validasi pada semua konten yang didasarkan pada project LookML yang izinnya Anda miliki, lalu menampilkan hasilnya.develop Lihat bagian Melihat hasil validasi konten untuk mengetahui informasi tentang meninjau hasil.

Menentukan Cakupan Validator Konten

Jika fitur Labs Cakupan Validator Konten diaktifkan, Anda dapat menentukan cakupan validasi untuk project LookML tertentu dan folder konten tertentu (termasuk subfoldernya, jika ada). Hal ini dapat meningkatkan performa Validator Konten.

Perhatikan hal berikut untuk cakupan Content Validator:

  • Jika Anda tidak menentukan folder atau project LookML, validasi tidak akan dicakup. Validator Konten akan memvalidasi semua konten yang didasarkan pada model yang izinnya Anda miliki.develop
  • Jika Anda menentukan folder konten, Validator Konten akan menjalankan validasi pada folder konten dan semua subfoldernya, jika ada.
  • Jika Anda menentukan folder konten dan satu atau beberapa project LookML, kedua kondisi akan berlaku: Validator Konten akan membatasi validasinya hanya pada konten dalam folder (dan subfolder) yang didasarkan pada project LookML yang Anda pilih.
  • Notifikasi dasbor, jadwal dasbor, dan jadwal Tampilan tidak disimpan di folder konten. Oleh karena itu, jika Anda menentukan cakupan validasi konten ke folder, Validator Konten tidak akan memvalidasi jadwal atau pemberitahuan apa pun.
  • Jika Anda menentukan project LookML, Validator Konten akan menentukan model terkait project dengan melihat LookML sumber project yang ditentukan dan dengan melihat model yang dikonfigurasi untuk setiap project, yang dapat Anda lihat di halaman Project LookML. Jika file model telah dihapus dari project LookML dan tidak ditampilkan sebagai model dalam project di halaman Project LookML, Validator Konten tidak akan menampilkan error yang terkait dengan konten berdasarkan model yang dihapus tersebut.

Untuk menjalankan Content Validator di instance Looker dengan Cakupan Content Validator diaktifkan, ikuti langkah-langkah berikut:

  1. Klik ikon Menu utama Looker dan pilih Kembangkan, jika menu Kembangkan belum ditampilkan.
  2. Dari menu Develop, pilih Content Validator.
  3. Di halaman Validator Konten, klik Validasi.

    Validator Konten menampilkan dialog Pilih Project untuk Divalidasi.

  4. Pada dialog Choose Projects to Validate, lakukan salah satu tindakan berikut:

    • Untuk menjalankan validator di semua project LookML, biarkan kolom Select projects apa adanya, tanpa memilih project, lalu klik Next.
    • Untuk menjalankan validator di satu atau beberapa project LookML tertentu, klik menu drop-down Select projects, pilih project yang ingin Anda validasi, lalu klik Next.

    Validator Konten menampilkan dialog Choose Folder to Validate.

  5. Pada dialog Choose Folder to Validate, lakukan salah satu hal berikut:

    • Untuk menjalankan validator di semua folder konten, biarkan pemilih Folder apa adanya, tanpa memilih folder, lalu klik Berikutnya.
    • Untuk menjalankan validator di satu folder konten tertentu (dan subfoldernya, jika ada), gunakan pemilih Folder untuk memilih folder yang ingin Anda validasi, lalu klik Berikutnya.

    Dialog Tinjau Pilihan menampilkan project dan folder yang Anda pilih untuk validasi.

  6. Pada dialog Tinjau Pilihan, klik Validasi.

Validator Konten akan menjalankan validasi pada konten yang Anda tentukan, lalu menampilkan hasilnya. Lihat bagian Melihat hasil validasi konten untuk mengetahui informasi tentang meninjau hasil.

Melihat hasil validasi konten

Saat menyelesaikan validasi, Content Validator akan menampilkan tabel error. Jika admin Looker telah mengaktifkan fitur Labs Cakupan Content Validator di instance Anda, hasil validasi akan dicakupkan ke project dan folder yang Anda pilih saat menjalankan Content Validator.

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.

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 LookML belum di-push ke produksi.

Tabel error menampilkan setiap error, beserta daftar Tampilan dan kartu yang berisi error, serta model dan Jelajahi yang mendasarinya yang menghasilkan error.

Jendela Content Validator yang menampilkan beberapa error dalam hasil validasi

Anda dapat menggunakan tab Kelompokkan menurut di kanan atas halaman untuk mengubah tata letak tabel 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.

Ikon di samping nama konten mengidentifikasi jenis konten:

  • Ikon kartu di dasbor. — Kartu dasbor
  • Ikon pemberitahuan di dasbor. — Notifikasi dasbor
  • Ikon Jadwalkan di dasbor atau Jadwalkan di Look. — Jadwal 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 ditentukan pengguna untuk mengetahui informasi tentang cara mengonfigurasi kartu agar memproses filter dasbor)

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

Untuk setiap baris, Looker menyediakan tombol Ganti atau tombol Hapus, atau keduanya, bergantung pada jenis error. Tombol ini menyediakan fungsi untuk memperbaiki error dan dijelaskan secara lebih mendetail di Menggunakan Validator Konten untuk memperbaiki error. 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 Validator Konten).

Bergantung pada setelan Kelompokkan menurut, tombol Ganti dan Hapus 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 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 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 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:

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 menyebabkan error, Anda dapat mengganti atau menghapus kolom, atau mengganti nama tampilan, Jelajahi, atau model.
  • Jika nama Jelajah menyebabkan error, Anda dapat mengganti nama Jelajah atau nama model.
  • Jika nama model menyebabkan 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
  • Direferensikan oleh kartu dasbor untuk memproses filter dasbor (ini dikonfigurasi di tab Kartu yang Akan Diupdate 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 yang perlu diperbaiki, lalu buat ulang ekspresi tersebut sebagaimana mestinya.

  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 tombol Hapus semua Tampilan yang dipilih di bagian atas tabel error.
  5. Klik OK 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 memilih satu kolom daripada kolom lainnya dan ingin melakukan penggantian tersebut dalam project Anda, meskipun tidak ada error. Daftar lengkap elemen yang dapat ditelusuri dan diganti oleh Content Validator disediakan di bagian Mengganti nama untuk kolom, tampilan, Jelajahi, dan model.

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 folder 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.