Setelan admin - Tabel Turunan Persisten

Fungsi tabel turunan persisten (PDT) Looker memungkinkan Anda melakukan analisis yang kompleks dalam Looker. Looker menampilkan beberapa fitur admin yang dapat membantu melacak dan memecahkan masalah perilaku PDT di halaman Persistent Derived Tables, yang dapat diakses oleh admin dan pengguna dengan izin yang sesuai dari bagian Database di panel Admin Looker. (Lihat halaman dokumentasi Tabel turunan di Looker untuk mengetahui informasi tentang cara memecahkan masalah PDT.)

Catatan: Untuk mengakses semua halaman admin di Looker, Anda harus memiliki peran Admin. Jika Anda memiliki izin yang hanya mengaktifkan bagian panel Admin, seperti manage_schedules atau manage_themes, tetapi tidak memiliki peran Admin, Looker mungkin tidak menampilkan halaman yang dijelaskan dalam artikel ini di panel Admin. Selain itu, izin see_admin memberikan izin hanya baca ke sebagian besar (tetapi tidak semua) halaman Admin. Lihat deskripsi see_admin untuk mengetahui informasi selengkapnya.

Halaman Tabel Turunan Persisten hanya menampilkan koneksi yang mengaktifkan PDT dan hanya PDT yang memenuhi kriteria berikut:

• PDT ditentukan dalam file tampilan yang sedang dalam produksi, kecuali jika Anda berada dalam Mode Pengembangan. Jika demikian, Anda dapat menggunakan tab Pengembangan untuk melihat versi pengembangan tabel yang dipertahankan.
• PDT adalah bagian dari model yang dikonfigurasi dengan benar.
• PDT adalah bagian dari model yang akses datanya Anda miliki.

Informasi di halaman ini didasarkan pada log peristiwa PDT internal, yang dijelaskan di bagian Model Log Peristiwa PDT di halaman ini.

Menyesuaikan tabel

Secara default, halaman Persistent Derived Tables menampilkan maksimum 25 PDT di halaman dan memuat PDT untuk semua koneksi yang akses datanya Anda miliki di instance Looker. Ada beberapa cara untuk mengubah data yang ditampilkan dalam tabel:

1. Klik panah di samping Semua Koneksi untuk melihat PDT hanya dari koneksi tertentu. Pemilih hanya menampilkan koneksi yang mengaktifkan PDT dan yang dapat Anda akses datanya.
2. Ketik kata kunci di kotak penelusuran untuk mempersempit daftar PDT menjadi PDT yang namanya menyertakan kata kunci. Tabel akan menampilkan PDT dengan istilah penelusuran yang cocok dalam cetak tebal. Klik X di kotak penelusuran untuk menghapus istilah kueri penelusuran Anda.
3. Klik ikon Filters untuk menentukan filter untuk tabel.
4. Klik ikon tutup/buka untuk menampilkan atau menyembunyikan bagian Sekilas.
5. Klik nama kolom untuk mengurutkan tabel menurut kolom tersebut. Klik nama kolom untuk kedua kalinya untuk membalikkan urutan pengurutan.
6. Klik ikon Select columns to display untuk menyembunyikan atau menampilkan kolom dalam tabel.
7. Gunakan pemilih tampilan untuk memilih jumlah hasil yang ditampilkan di satu halaman. Jika tabel lebih panjang dari satu halaman, Anda dapat mengklik panah di bagian tengah bawah halaman untuk membuka halaman berikutnya atau sebelumnya.

Pemfilteran

Anda dapat menggunakan ikon Filter di samping kotak penelusuran untuk memilih PDT yang ditampilkan di halaman Persistent Derived Tables. Misalnya, Anda dapat memfilter menurut Status Build Terakhir untuk hanya melihat PDT yang mengalami error build, atau Anda dapat memfilter menurut Model untuk membatasi PDT yang ditampilkan ke model tertentu.

Untuk memfilter halaman Tabel Turunan Persisten:

1. Klik ikon Filter .
2. Pilih opsi filter dari pemilih filter pertama di menu filter. Opsi berikut tersedia:
   • Not Triggered in the Last — Memfilter halaman Persistent Derived Tables berdasarkan PDT yang belum dipicu dalam jumlah jam dan menit yang ditentukan.
   • Dipicu dalam Terakhir — Memfilter halaman Tabel Turunan Persisten menurut PDT yang telah dipicu dalam jumlah jam dan menit yang ditentukan.
   • Model — Memfilter halaman Persistent Derived Tables untuk PDT yang disertakan dalam model yang ditentukan.
   • Aturan Persisten — Memfilter halaman Tabel Turunan Persisten menurut jenis persistensi PDT.
   • Last Attempt Status — Memfilter halaman Persistent Derived Tables berdasarkan status PDT yang ditentukan.
   • Dipublikasikan sebagai Tampilan Stabil — Boolean yang memfilter halaman Tabel Turunan Persisten untuk PDT dan menampilkan Ya untuk PDT yang dipublikasikan sebagai tampilan stabil, dan Tidak untuk PDT yang tidak dipublikasikan sebagai tampilan stabil, seperti yang ditentukan oleh nilai parameter publish_as_db_view.
   • Last Build Duration Longer Than — Memfilter halaman Persistent Derived Tables berdasarkan PDT yang build-nya memerlukan waktu lebih lama dari jumlah detik yang ditentukan.
   • Project — Memfilter halaman Tabel Turunan Persisten menurut PDT dari project LookML yang ditentukan.
3. Pilih nilai yang ingin Anda filter di halaman Persistent Derived Tables di pemilih filter kedua. Untuk opsi Tidak Dipicu dalam Terakhir atau Dipicu dalam Terakhir, masukkan jumlah jam atau menit. Untuk opsi Durasi Build Terakhir Lebih Lama Dari, masukkan jumlah detik.
4. Klik Tambahkan Filter untuk menambahkan filter lainnya, lalu ulangi langkah 2 dan 3 untuk setiap filter yang Anda tambahkan.
   • Untuk menghapus pilihan filter dan memulai dari awal kapan saja, klik Hapus Semua.
   • Untuk menghapus filter tambahan satu per satu, klik opsi Hapus untuk filter yang ingin Anda hapus.
5. Untuk menerapkan kriteria filter yang dipilih ke halaman Tabel Turunan Persisten, klik Terapkan.

Anda akan melihat filter yang diterapkan di bagian atas halaman Tabel Turunan Persisten.

Klik X di samping filter yang diterapkan di halaman Persistent Derived Tables untuk menghapus filter dari halaman Persistent Derived Tables. Klik Hapus Semua untuk menghapus semua filter.

Memahami halaman PDT

Bagian berikut menjelaskan informasi di halaman Tabel Turunan Persisten.

Tab Produksi dan Pengembangan

Jika Anda adalah developer LookML dalam Mode Pengembangan, tabel Tabel Turunan Persisten akan memiliki dua tab:

• Tab Production dipilih secara default dan menampilkan PDT produksi. Ini adalah PDT yang telah di-deploy ke produksi di instance Anda; PDT ini menyediakan data untuk kueri Jelajah pengguna Anda. (Jika Anda berada dalam Mode Produksi atau jika Anda tidak memiliki izin develop, halaman Tabel Turunan Persisten tidak akan menampilkan tab apa pun, dan halaman tersebut hanya akan menampilkan informasi untuk PDT produksi.)

• Tab Development menampilkan PDT pengembangan. PDT pengembangan belum di-push ke lingkungan produksi.

Looker membuat PDT pengembangan saat developer LookML dalam Mode Pengembangan membuat perubahan yang memengaruhi data di PDT atau cara PDT dikueri. Perubahan ini akan meminta Looker untuk membuat PDT pengembangan, tetapi Looker sebenarnya tidak mem-build PDT kecuali jika PDT dikueri setelah perubahan dilakukan. Tab Pengembangan dapat membantu Anda menentukan PDT pengembangan yang telah dibuat Looker dan apakah PDT tersebut telah di-build.

Tips: Anda juga dapat melihat PDT yang belum di-build di project menggunakan Looker IDE.

Lihat halaman dokumentasi Tabel turunan di Looker untuk mengetahui informasi selengkapnya tentang hal yang mendorong Looker untuk membuat PDT pengembangan dan berapa lama PDT pengembangan dipertahankan di database Anda.

Bagian Sekilas

Bagian Sekilas menampilkan ringkasan visual status untuk PDT yang saat ini ditampilkan di tabel PDT. Jika Anda telah menentukan filter untuk tabel, atau jika Anda telah menggunakan panah di samping Semua Koneksi di bagian atas halaman untuk mempersempit tabel ke koneksi tertentu, bagian Sekilas akan mempersempit hasil agar cocok dengan yang ditampilkan di tabel PDT.

Anda dapat menampilkan atau menyembunyikan bagian Sekilas dengan mengklik ikon tutup/buka di bagian atas.

Kolom tabel

Bagian berikut menjelaskan kolom tabel di halaman Tabel Turunan yang Persisten. Anda mengklik ikon Pilih kolom yang akan ditampilkan untuk menyembunyikan atau menampilkan beberapa kolom tabel. Untuk informasi selengkapnya, lihat bagian Menyesuaikan tabel di halaman ini.

Nama PDT

Kolom Nama PDT menampilkan nama PDT seperti yang ditentukan dalam parameter view dari file tampilan LookML PDT.

Kolom Nama PDT menampilkan informasi tambahan ini di bawah nama PDT, jika ada:

• Build Lama menunjukkan bahwa baris menampilkan informasi tentang build PDT lama. Lihat pop-up Detail PDT di menu Opsi untuk mengetahui informasi selengkapnya tentang pesan ini.
• Inkremental menunjukkan bahwa PDT adalah PDT inkremental.
• Tampilan Terwujud menunjukkan bahwa PDT adalah tampilan terwujud di database Anda.

Status Percobaan Terakhir

Kolom Last Attempt Status menampilkan status upaya terakhir untuk mem-build setiap PDT yang tercantum:

• Pembuatan ulang menunjukkan bahwa PDT dapat dikueri dan ada tabel yang diperbarui yang sedang dibuat. Stempel waktu menunjukkan kapan PDT mulai di-build.
• Success menunjukkan bahwa PDT berhasil di-build.
• Mem-build menunjukkan bahwa PDT saat ini sedang mem-build dan tidak dapat dikueri hingga build selesai.
• Tidak Di-build menunjukkan bahwa PDT saat ini tidak di-build.
• Build Error menunjukkan bahwa error telah terjadi selama build. Anda dapat mengklik Error Build untuk melihat sumber error dan membuka LookML PDT jika memiliki izin yang sesuai untuk melihat LookML. Lihat bagian Menu opsi di halaman ini untuk mempelajari lebih lanjut cara memecahkan masalah PDT dari halaman Persistent Derived Tables.

Terakhir Dicoba Pada

Kolom Last Attempted At menunjukkan waktu build PDT yang terakhir dicoba.

Build Terakhir yang Berhasil

Kolom Last Successful Build menunjukkan waktu build PDT terakhir yang berhasil.

Durasi Build Terakhir

Kolom Last Build Duration menampilkan jumlah waktu dalam detik yang diperlukan untuk build terbaru PDT tersebut dan waktu yang diperlukan untuk mem-build PDT rata-rata dalam detik.

Aturan Persistensi

Kolom Aturan Persistensi menampilkan jenis persistensi yang diterapkan ke PDT, seperti yang ditentukan dalam file tampilan PDT. Kolom ini juga menunjukkan waktu terakhir PDT yang berhasil dibuat diperiksa (untuk PDT jenis pemicu) atau kapan PDT yang berhasil dibuat akan berakhir masa berlakunya (untuk PDT jenis persist). Ada dua jenis persistensi yang ditampilkan di kolom Aturan Persistensi:

• Persist for: (time) ditampilkan untuk PDT yang dipertahankan dengan parameter persist_for.
• Pemicu: (nama grup data) ditampilkan untuk PDT yang dipertahankan dengan parameter datagroup_trigger. Anda dapat mengklik link nama grup data untuk melihat nilai sql_trigger untuk parameter datagroup.
• Pemicu: SQL ditampilkan untuk PDT yang dipertahankan dengan parameter sql_trigger_value. Anda dapat mengklik link untuk melihat pernyataan sql_trigger_value.
• Tampilan Terwujud ditampilkan untuk tampilan terwujud, yang memanfaatkan fungsi database Anda untuk mempertahankan tabel turunan di database Anda.

Project

Kolom Project menunjukkan nama project LookML tempat PDT ditentukan.

Koneksi

Jika Semua Koneksi dipilih dari pilihan koneksi, kolom Koneksi akan muncul dan menampilkan nama koneksi tempat PDT diaktifkan.

Model

Kolom Model menampilkan nama file model tempat file tampilan PDT disertakan.

Catatan: Jika file tampilan PDT disertakan dalam beberapa file model yang memiliki koneksi yang sama, beberapa model akan muncul di kolom Model. Jika file tampilan PDT disertakan dalam beberapa file model dengan koneksi yang berbeda, PDT juga akan muncul dalam daftar PDT koneksi lainnya.

Anda harus jelas saat menyertakan file tampilan dalam model, karena menyertakan semua file tampilan dapat mengacaukan skema database Anda dan menyebabkan beberapa salinan PDT di-build di database Anda, atau di beberapa database.

Menu opsi

Menu Opsi tiga titik sangat berguna untuk memecahkan masalah perilaku yang tidak terduga. Opsi yang ditampilkan memungkinkan Anda memeriksa kapan tabel terakhir dibuat, memeriksa berapa lama waktu yang diperlukan untuk membuat tabel, membandingkan waktu build terbaru dengan waktu build rata-rata, dan memeriksa apakah pemicu berfungsi dengan benar. Anda dapat memilih dari:

• Go to LookML — Membuka file tampilan tempat PDT ditentukan jika Anda memiliki izin yang sesuai untuk melihat LookML.
• Dasbor Aktivitas PDT — Membuka dasbor Aktivitas PDT, yang difilter untuk menampilkan aktivitas untuk PDT yang dipilih selama empat minggu terakhir.
• Detail PDT — Membuka pop-up yang berisi informasi dan statistik selengkapnya untuk PDT tertentu. Lihat bagian Modal detail PDT di halaman ini untuk mengetahui informasi selengkapnya.

Lihat Bagian pemantauan dan pemecahan masalah PDT di halaman dokumentasi Tabel turunan di Looker untuk mendapatkan tips pemecahan masalah.

Modal detail PDT

Klik opsi Detail PDT dari menu Opsi tiga titik PDT untuk melihat modal detail PDT.

Informasi dalam modal bergantung pada konfigurasi PDT. Berikut adalah informasi yang mungkin Anda lihat:

• Nama Tabel: Hash PDT terbaru yang berhasil dibuat.
• Model: Nama file model tempat file tampilan PDT disertakan.
• Nama Stabil: Nama tampilan database stabil PDT di database Anda, jika PDT telah dipublikasikan sebagai tampilan stabil. Anda dapat memublikasikan PDT sebagai tampilan stabil di database dengan menambahkan pernyataan publish_as_db_view: yes ke tabel turunan, atau dengan menggunakan pernyataan materialized_view: yes untuk menjadikan tabel turunan sebagai tampilan terwujud.
• Koneksi: Nama koneksi tempat PDT diaktifkan.
• Build Lama: Boolean yang menampilkan Ya jika build adalah build PDT lama atau Tidak jika bukan.
  • Jenis Tabel: Untuk build lama, kolom ini muncul dan menampilkan jenis tabel. Nilainya mencakup Tabel Generasi Lama dan Pengganti.
• PDT Inkremental: Boolean yang menampilkan Ya jika PDT adalah PDT inkremental atau Tidak jika bukan.
• Status: Memberikan Status Percobaan Terakhir. Untuk build yang gagal, berikan pesan error SQL dan link ke LookML model jika pengguna memiliki izin yang sesuai untuk melihat LookML.
• Dependensi: Klik tombol Tampilkan Grafik Dependensi untuk menampilkan diagram hubungan semua tabel turunan yang diperlukan oleh PDT ini. Setiap node dalam diagram sesuai dengan tabel turunan. Warna setiap node sesuai dengan status tabel turunan tersebut, sebagai berikut:
  • Node hijau mewakili PDT yang telah berhasil dibuat.
  • Node kuning mewakili PDT yang sedang di-build atau ditingkatkan.
  • Node merah mewakili PDT yang gagal di-build.
  • Node abu-abu mewakili PDT yang belum di-build.
  • Node putih mewakili tabel turunan sementara, yang tidak dibuat oleh Looker.
• Build Terakhir:
  • Latest Successful Build: Tanggal dan waktu build PDT terbaru yang berhasil.
  • Durasi Build Terbaru: Durasi build PDT terbaru (dalam detik; menampilkan – jika tabel belum dibuat).
  • Rata-Rata Durasi Build: Rata-rata waktu yang diperlukan untuk mem-build PDT (dalam detik; menampilkan – jika tabel belum di-build).
  • Alasan Build: Alasan PDT dibuat (awal untuk build awal; datagroup dipicu jika PDT dipertahankan dengan datagroup; perubahan nilai pemicu jika nilai pemicu SQL PDT telah berubah).
  • Increment Key: Parameter increment_key untuk PDT yang menggunakan build inkremental.
  • Increment Offset: Parameter increment_offset untuk PDT yang menggunakan build inkremental.
  • Increment Build Added/Removed Rows: Jumlah baris yang ditambahkan ke atau dihapus dari tabel saat tabel terakhir kali bertambah (menampilkan – jika tidak ada baris yang ditambahkan atau dihapus saat strategi persistensi tabel terakhir kali memicu penambahan).
  • SQL yang Terakhir Dicoba: SQL yang digunakan untuk membuat kueri database guna membuat build terakhir tabel.
• Aturan Persisten:
  • Type: Jenis persistensi yang digunakan oleh tabel. Lihat bagian kolom Aturan Persistensi di halaman ini untuk mengetahui kemungkinan nilai.
  • Persist For: Untuk PDT jenis Persist, nilai durasi persistensi. Tidak berlaku untuk PDT jenis Pemicu.
  • Datagroup: Untuk PDT pemicu datagroup, memberikan nama datagroup.
  • Blok kode SQL: Untuk PDT pemicu SQL dan grup data, blok kode akan menampilkan pernyataan SQL pemicu. Untuk pemicu grup data, ini adalah SQL untuk parameter sql_trigger grup data. Untuk pemicu SQL, ini adalah SQL untuk parameter sql_trigger_value.
  • Nilai Pemicu: Untuk PDT jenis Pemicu, nilai yang memicu build PDT (menampilkan – untuk PDT yang berhasil dibuat dan dipertahankan dengan datagroup_trigger; untuk melihat nilai pemicu terbaru untuk datagroup, lihat halaman Datagroup di panel Admin).
  • Terakhir Diperiksa: Untuk PDT jenis Pemicu, saat nilai pemicu terakhir kali diperiksa.
  • Berakhir: Saat PDT berakhir, jika berlaku (tidak berlaku untuk pemicu grup data).

Dasbor Aktivitas PDT

Dasbor Aktivitas PDT menampilkan informasi tentang PDT, build ulang, dan kuerinya.

Dasbor Aktivitas PDT secara default menampilkan informasi aktivitas dari empat minggu sebelumnya. Anda dapat mengubah jangka waktu yang ditampilkan menggunakan panel filter di bagian atas dasbor. Dasbor Aktivitas PDT menyertakan kartu yang menampilkan informasi berikut:

• Ringkasan PDT yang menyertakan nama model dan tampilan LookML yang menentukan PDT, nama koneksi database yang digunakan PDT, jumlah total upaya build PDT yang berhasil dan gagal, serta persentase total upaya build yang gagal.
• Tanggal dan waktu build ulang penuh PDT terbaru.
• Jika PDT adalah PDT inkremental, tanggal dan waktu build ulang inkremental terbaru PDT.
• Jika PDT adalah PDT inkremental, jumlah build ulang inkremental yang telah terjadi sejak build ulang penuh terbaru.
• Waktu rata-rata yang diperlukan untuk mem-build ulang PDT.
• Visualisasi yang menampilkan semua peristiwa pembuatan yang baru-baru ini terjadi, yang dikelompokkan berdasarkan ringkasan jenis tindakan yang menyebabkan peristiwa tersebut.
• Daftar semua build ulang PDT yang telah terjadi selama jangka waktu dasbor, termasuk tanggal setiap build ulang selesai, jumlah detik yang diperlukan untuk menyelesaikan setiap build ulang, apakah build ulang adalah build inkremental, pemicu yang menyebabkan setiap build ulang, dan jumlah build PDT.
• Daftar semua upaya rebuild yang gagal, termasuk tanggal dan waktu rebuild yang gagal dimulai, jenis error yang menyebabkan kegagalan, pesan error, dan jumlah kegagalan pembuatan.
• Daftar semua peristiwa pemicu rebuild PDT, termasuk nomor ID peristiwa, tanggal peristiwa, jenis peristiwa, dan data yang disertakan dengan peristiwa pemicu.
• Daftar semua peristiwa pembuatan ulang PDT, termasuk nomor ID peristiwa, tanggal peristiwa, jenis peristiwa, dan data yang disertakan dengan peristiwa pembuatan ulang.
• Jumlah kueri yang langsung membuat kueri kolom, yang dikelompokkan menurut sumber kueri dan runtime rata-rata untuk setiap sumber kueri.
• Jumlah total kueri yang dijalankan di PDT.
• Daftar semua kolom PDT yang dikueri, termasuk tampilan dan model LookML tempat kolom ditentukan, nama kolom, nama eksekusi Jelajah yang menyertakan kolom, dan frekuensi kolom disertakan dalam kueri.

Model Log Aktivitas PDT

Looker menyertakan model bawaan bernama system_activity yang memungkinkan eksplorasi log peristiwa PDT dengan mudah, yang merupakan tabel dalam skema sementara koneksi database yang melacak pemicu dan aktivitas build PDT.

Anda dapat mengakses model dengan link Peristiwa Build Terbaru dan Peristiwa Pemicu Terbaru di menu tiga titik Opsi di halaman Tabel Turunan Persisten, atau dari halaman Koneksi di panel Admin Looker.

Untuk mengakses log peristiwa PDT Jelajahi dari halaman Koneksi, pilih opsi Tampilkan Log Peristiwa PDT dari menu drop-down ikon roda gigi untuk setiap koneksi.

Anda dapat menjelajahi model seperti Jelajahi Looker lainnya. Saat diakses dari halaman Koneksi, Jelajah Log Peristiwa PDT difilter untuk seluruh koneksi. Saat diakses dari halaman Tabel Turunan Persisten, Eksplorasi Log Peristiwa PDT difilter untuk PDT tertentu.

Berikut adalah panduan singkat untuk kolom yang tersedia di Jelajahi Log Peristiwa PDT:

Kolom	Deskripsi
Tindakan	Menjelaskan tindakan yang terjadi; tindakan ini dapat mencakup aktivitas regenerasi, penghapusan, pembuatan, dan panen. Lihat halaman dokumentasi Memahami tindakan log PDT untuk mengetahui informasi selengkapnya tentang cara melihat dan memahami tindakan log PDT serta data tindakan yang sesuai.
Data Tindakan	Memberikan detail yang lebih spesifik tentang tindakan, termasuk pemicu yang digunakan, nilai pemicu, waktu habis masa berlaku untuk tabel persisten, penyebab pembuatan ulang, teks pesan error, dan sebagainya. Lihat halaman dokumentasi Memahami tindakan log PDT untuk mengetahui informasi selengkapnya tentang cara melihat dan memahami tindakan log PDT serta data tindakan yang sesuai.
Koneksi	Nama koneksi tempat tabel turunan berada.
Hash	Setiap tabel turunan berisi hash SQL yang ditulis untuk membuatnya.
ID	ID unik instance Looker yang menghasilkan PDT. Dalam banyak kasus, hanya akan ada satu instance Looker yang mengarah ke database, sehingga Anda hanya akan melihat satu ID. Namun, jika Anda memiliki instance staging, atau sesuatu yang serupa, Anda mungkin melihat beberapa ID.
Nama Model	Nama model tempat tabel dibuat.
Tanggal Terjadi	Tanggal dan waktu peristiwa terjadi.
Tanggal Tampilan Utc Terjadi	Tanggal dan waktu peristiwa terjadi dalam UTC.
Urutan	Nomor langkah dalam build PDT.
Hash Pendek	Versi hash SQL yang terpotong yang ditulis untuk membuat tabel turunan.
Nama Tabel	Nama lengkap PDT, termasuk awalan jenis tabel, hash, dan nama tampilan.
Tid	ID transaksi.
Nama Tampilan	Nama tampilan untuk tabel turunan.