Setelan admin - Tabel Turunan Persisten

Fungsi tabel turunan persisten (PDT) di Looker memungkinkan Anda melakukan analisis kompleks di 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 pada panel Admin Looker. (Lihat halaman dokumentasi Tabel turunan di Looker untuk mengetahui informasi tentang pemecahan masalah PDT.)

Halaman Persistent Derived Tables hanya menampilkan koneksi yang mengaktifkan PDT dan hanya PDT yang memenuhi kriteria berikut:

  • PDT ditentukan dalam file tampilan yang sedang dalam tahap produksi, kecuali jika Anda berada dalam Mode Pengembangan. Dalam hal ini, Anda dapat menggunakan tab Pengembangan untuk melihat versi pengembangan dari 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 aktivitas 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 pada 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 All Connections untuk melihat PDT hanya dari koneksi tertentu. Pemilih hanya menampilkan koneksi yang mengaktifkan PDT dan yang akses datanya Anda miliki.
  2. Ketik kata kunci di kotak penelusuran untuk mempersempit daftar PDT ke PDT yang namanya menyertakan kata kunci. Tabel akan menampilkan PDT dengan istilah penelusuran yang cocok dicetak tebal. Klik X di kotak penelusuran untuk menghapus istilah kueri penelusuran Anda.
  3. Klik ikon Filter untuk menentukan filter untuk tabel.
  4. Klik ikon tutup/buka untuk menampilkan atau menyembunyikan bagian Sekilas.
  5. Klik nama kolom untuk mengurutkan tabel berdasarkan kolom tersebut. Klik nama kolom untuk kedua kalinya untuk membalik tata urutan.
  6. Klik ikon Select columns to display untuk menyembunyikan atau menampilkan kolom di tabel.
  7. Gunakan pemilih tampilan untuk memilih jumlah hasil yang ditampilkan pada 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 Last Build Status 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 Persistent Derived Tables:

  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 menurut PDT yang belum dipicu dalam jumlah jam dan menit yang ditentukan.
    • Dipicu di Terakhir — Memfilter halaman Persistent Derived Tables 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 Persistensi — Memfilter halaman Tabel Turunan Persisten menurut jenis persistensi PDT.
    • Last Try Status — Memfilter halaman Persistent Derived Tables berdasarkan status PDT yang ditentukan.
    • Dipublikasikan sebagai Tampilan Stabil — Boolean yang memfilter halaman Persistent Derived Tables untuk PDT dan menampilkan Yes untuk PDT yang dipublikasikan sebagai tampilan stabil, dan No untuk PDT yang tidak dipublikasikan sebagai tampilan stabil, seperti yang ditentukan oleh nilai parameter publish_as_db_view-nya.
    • Last Build Duration Long Than — Memfilter halaman Persistent Derived Tables menurut PDT yang build-nya memerlukan waktu lebih dari jumlah detik yang ditentukan.
    • Project — Memfilter halaman Persistent Derived Tables berdasarkan PDT dari project LookML yang ditentukan.
  3. Pilih nilai yang ingin digunakan untuk memfilter halaman Tabel Turunan Persisten di pemilih filter kedua. Untuk opsi Tidak Dipicu di Terakhir atau Dipicu di Terakhir, masukkan jumlah jam atau menit. Untuk opsi Last Build Duration Known Than, 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, klik Hapus Semua.
    • Untuk menghapus filter tambahan satu per satu, klik Hapus di atas filter yang ingin dihapus.
  5. Untuk menerapkan kriteria filter yang dipilih ke halaman Persistent Derived Tables, klik Terapkan.

Anda akan melihat filter yang diterapkan di bagian atas halaman Persistent Derived Tables.

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

Memahami halaman PDT

Bagian berikut menjelaskan informasi di halaman Persistent Derived Tables.

Tab Produksi dan Pengembangan

Jika Anda adalah developer LookML dalam Mode Pengembangan, tabel Persistent Derived Tables akan memiliki dua tab:

  • Tab Produksi dipilih secara default dan menampilkan PDT produksi. Ini adalah PDT yang telah di-deploy ke produksi pada 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 Persistent Derived Tables tidak akan menampilkan tab apa pun, dan halaman tersebut hanya akan menampilkan informasi untuk PDT produksi.)

  • Tab Pengembangan menampilkan PDT pengembangan. PDT pengembangan belum dikirim 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 membuat PDT pengembangan, tetapi Looker tidak benar-benar mem-build PDT kecuali jika PDT dikueri setelah perubahan dibuat. Tab Pengembangan dapat membantu Anda menentukan PDT pengembangan mana yang telah dibuat oleh Looker dan apakah PDT pengembangan tersebut sudah di-build.

Lihat halaman dokumentasi Tabel turunan di Looker untuk mengetahui informasi selengkapnya tentang perintah Looker untuk membuat PDT pengembangan dan durasi PDT pengembangan dipertahankan di database Anda.

bagian Sekilas

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

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

Kolom tabel

Bagian berikut menjelaskan kolom tabel di halaman Persistent Derived Tables. 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 PDT Name menampilkan nama PDT seperti yang ditentukan dalam parameter view file tampilan LookML PDT.

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

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

Status Upaya Terakhir

Kolom Last Try Status menampilkan status upaya terakhir untuk membuat setiap PDT yang tercantum:

  • Pembuatan ulang menunjukkan bahwa PDT dapat dikueri dan bahwa ada tabel yang diperbarui yang sedang dibuat. Stempel waktu menunjukkan kapan PDT mulai dibuat.
  • Berhasil menunjukkan bahwa PDT berhasil dibuat.
  • Gedung menunjukkan bahwa PDT sedang di-build dan tidak dapat dikueri hingga build selesai.
  • Tidak Dibuat menunjukkan bahwa PDT saat ini tidak dibuat.
  • Build Error menunjukkan error yang terjadi selama proses build. Anda dapat mengklik Build Error 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.

Upaya Terakhir Pada

Kolom Last Tryed At menunjukkan waktu upaya build PDT terakhir kali.

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 membuat PDT rata-rata dalam hitungan detik.

Aturan Persistensi

Kolom Aturan Persistensi menampilkan jenis persistensi yang diterapkan ke PDT, seperti yang ditentukan dalam file tampilan PDT. Ini juga menunjukkan kapan terakhir kali PDT yang berhasil dibangun diperiksa (untuk PDT jenis pemicu) atau saat PDT yang berhasil dibangun akan habis masa berlakunya (untuk PDT jenis persisten). Ada dua jenis persistensi yang ditampilkan di kolom Aturan Persistensi:

  • Tetap selama: (waktu) 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 untuk mempertahankan tabel turunan di database Anda.

Project

Kolom Project menunjukkan nama project LookML tempat PDT ditentukan.

Koneksi

Jika All Connections dipilih dari pemilihan koneksi, kolom Connection akan muncul dan menampilkan nama koneksi tempat PDT diaktifkan.

Model

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

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 berbeda, PDT juga akan muncul dalam daftar PDT koneksi lainnya.

Penting untuk bersikap eksplisit saat menyertakan file tampilan dalam model, karena menyertakan semua file tampilan dapat mengacaukan skema database Anda dan menyebabkan beberapa salinan PDT dibangun di database Anda, atau di beberapa database.

Menu opsi

Menu Options tiga titik sangat berguna untuk memecahkan masalah perilaku yang tidak terduga. Opsi yang disajikan memungkinkan Anda untuk memeriksa kapan tabel terakhir dibangun, memeriksa berapa lama waktu yang dibutuhkan untuk membangun, membandingkan waktu build terbaru dengan waktu build rata-rata, dan memeriksa apakah pemicu bekerja dengan benar. Anda dapat memilih dari:

  • Buka 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 bagi 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 PDT pemantauan dan pemecahan masalah 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 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 membuat tabel turunan menjadi tampilan terwujud.
  • Koneksi: Nama koneksi tempat PDT diaktifkan.
  • Lama Build: Boolean yang menampilkan Yes jika build adalah build PDT lama, atau No jika bukan.
    • Jenis Tabel: Untuk build lama, kolom ini akan muncul dan menampilkan jenis tabel. Nilai mencakup Legacy Generation Table dan Standin.
  • PDT inkremental: Boolean yang menampilkan Yes jika PDT merupakan PDT inkremental atau No jika bukan.
  • Status: Memberikan Status Upaya Terakhir. Untuk build yang gagal, berikan pesan error SQL dan link ke LookML model jika pengguna memiliki izin yang sesuai untuk melihat LookML.
  • Dependencies: Klik tombol Show Dependency Graph untuk menampilkan diagram hubungan semua tabel turunan yang menjadi dependensi 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 dibangun.
    • Node kuning mewakili PDT yang sedang dibuat atau bertambah.
    • Node merah mewakili PDT yang gagal dibuat.
    • Node abu-abu mewakili PDT yang belum dibuat.
    • Node putih mewakili tabel turunan sementara, yang tidak dibuat oleh Looker.
  • Build Terakhir:
    • Versi Terbaru yang Berhasil: Tanggal dan waktu build PDT terbaru yang berhasil.
    • Durasi Build Terbaru: Waktu yang diperlukan oleh build PDT terbaru (dalam hitungan detik; menampilkan jika tabel belum dibuat).
    • Durasi Build Rata-Rata: Berapa lama waktu yang diperlukan untuk membuat PDT rata-rata (dalam hitungan detik; menampilkan jika tabel belum dibuat).
    • Alasan Build: Alasan PDT dibuat (inkeption untuk build awal; datagroup dipicu jika PDT dipertahankan dengan datagroup; perubahan nilai pemicu jika nilai pemicu SQL PDT telah berubah).
    • Kunci Peningkatan: Parameter increment_key untuk PDT yang menggunakan build inkremental.
    • Increment Offset: Parameter increment_offset untuk PDT yang menggunakan build inkremental.
    • Increment Build Add/Removed Rows: Jumlah baris yang ditambahkan ke atau dihapus dari tabel saat tabel terakhir bertambah (menampilkan jika tidak ada baris yang ditambahkan atau dihapus saat strategi persistensi tabel terakhir memicu peningkatan).
    • Terakhir Dicoba SQL: SQL yang digunakan untuk membuat kueri database untuk membuat build tabel terakhir.
  • Aturan Persistensi:
    • Jenis: Jenis persistensi yang digunakan oleh tabel. Lihat bagian kolom Aturan Persistensi di halaman ini untuk mengetahui nilai yang memungkinkan.
    • Persist For: Untuk PDT jenis Persist, nilai durasi persistensi. Tidak berlaku untuk PDT jenis Pemicu.
    • Datagroup: Untuk PDT pemicu grup data, berikan 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 dari datagroup. 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 yang dipertahankan dengan datagroup_trigger; untuk melihat nilai pemicu terbaru untuk grup data, lihat halaman Grup data di panel Admin).
    • Terakhir Diperiksa: Untuk jenis PDT Pemicu, saat nilai pemicu terakhir diperiksa.
    • Berakhir: Saat masa berlaku PDT berakhir, jika berlaku (tidak berlaku untuk pemicu grup data).

Dasbor Aktivitas PDT

Dasbor PDT Activity menampilkan informasi tentang PDT, pembuatan ulangnya, 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 PDT Activity menyertakan kartu yang menampilkan informasi berikut:

  • Ringkasan PDT yang mencakup nama model dan tampilan LookML yang menentukan PDT, nama koneksi database yang digunakan PDT, jumlah total upaya build yang berhasil dan gagal, serta persentase total upaya build yang gagal.
  • Tanggal dan waktu pembuatan ulang penuh terbaru PDT.
  • Jika PDT adalah PDT inkremental, tanggal dan waktu pembuatan ulang PDT inkremental terbaru.
  • Jika PDT adalah PDT inkremental, jumlah rebuild inkremental yang telah terjadi sejak build ulang penuh terbaru.
  • Waktu rata-rata yang dibutuhkan untuk membuat ulang PDT.
  • Visualisasi yang menampilkan semua peristiwa pembuatan yang terjadi baru-baru ini, yang dikelompokkan berdasarkan ringkasan jenis tindakan yang menyebabkan peristiwa tersebut.
  • Daftar semua build ulang PDT yang terjadi selama jangka waktu dasbor, termasuk tanggal setiap build ulang selesai, jumlah detik yang dibutuhkan untuk menyelesaikan setiap build ulang, apakah build ulang adalah build inkremental, pemicu yang menyebabkan setiap build ulang, dan jumlah build PDT.
  • Daftar semua upaya build ulang yang gagal, termasuk tanggal dan waktu mulainya proses build ulang yang gagal, jenis error yang menyebabkan kegagalan, pesan error, dan jumlah kegagalan pembuatan.
  • Daftar semua peristiwa pemicu pembuatan ulang 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 secara langsung mengkueri kolom, yang dikelompokkan berdasarkan 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 yang menentukan kolom, nama kolom, nama operasi Explore yang menyertakan kolom tersebut, dan berapa kali kolom disertakan dalam kueri.

Model Log Peristiwa 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 pada halaman Tabel Persisten Turunan, atau dari halaman Koneksi di panel Admin Looker. Untuk mengakses Jelajah log aktivitas PDT dari halaman Koneksi, pilih opsi Tampilkan Log Peristiwa PDT dari menu drop-down menu roda gigi di ujung kanan setiap koneksi.

Anda dapat menjelajahi model ini seperti Jelajah pada Looker lainnya. Saat diakses dari halaman Connections, Jelajah PDT Event Log difilter untuk seluruh koneksi. Saat diakses dari halaman Persistent Derived Tables, Explore PDT Event Log difilter untuk PDT tertentu.

Ini adalah panduan singkat untuk kolom yang tersedia:

KolomDeskripsi
TindakanMenjelaskan tindakan yang terjadi; aktivitas ini dapat mencakup aktivitas pembuatan ulang, penurunan, pembuatan, dan menuai.

Lihat halaman dokumentasi Memahami tindakan log PDT untuk informasi selengkapnya tentang cara melihat dan memahami tindakan log PDT serta data tindakannya yang sesuai.
Data TindakanMemberikan 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 informasi selengkapnya tentang cara melihat dan memahami tindakan log PDT serta data tindakannya yang sesuai.
KoneksiNama koneksi tempat tabel turunan berada.
HashSetiap tabel turunan berisi {i>hash<i} dari SQL yang ditulis untuk membuatnya.
IDID 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 semacamnya, Anda mungkin akan melihat beberapa ID.
Nama ModelNama model yang digunakan untuk membuat tabel.
Tanggal KejadianTanggal dan waktu peristiwa terjadi.
Tanggal Tampilan Utc KejadianTanggal dan waktu acara berlangsung dalam UTC.
UrutanNomor langkah dalam build PDT.
Hash SingkatVersi terpotong dari {i>hash<i} dari SQL yang ditulis untuk membuat tabel turunan.
Nama TabelNama lengkap PDT, termasuk awalan jenis tabel, hash, dan nama tampilan.
TID transaksi.
Nama TampilanNama tampilan untuk tabel turunan.