Menyesuaikan Blok Looker Marketplace

Looker Blocks™ adalah model data siap pakai untuk pola analisis dan sumber data umum. Halaman ini menjelaskan cara developer dapat menyesuaikan Blok Looker yang diinstal dari Looker Marketplace. Looker Marketplace adalah lokasi terpusat untuk menemukan, men-deploy, dan mengelola berbagai jenis konten Looker seperti aplikasi, visualisasi, dan plugin.

Untuk informasi selengkapnya tentang semua Blok Looker yang tersedia, termasuk blok yang saat ini tidak tersedia dari Looker Marketplace, serta metode penyesuaian blok alternatif, lihat halaman dokumentasi Blok Looker.

Persyaratan untuk menginstal dan mengelola Blok Looker dari Looker Marketplace

Sebelum Anda dapat menginstal dan menggunakan beberapa blok dari Looker Marketplace, admin Looker Anda harus mengaktifkan fitur berikut:

  • Jika Anda menginstal blok melalui Looker Marketplace, admin Looker harus mengaktifkan fitur Marketplace.
  • Jika blok tertentu berisi parameter local_dependency, admin Looker Anda juga harus mengaktifkan fitur Impor Project Lokal Labs. Blok ini berisi parameter local_dependency:

    • Analisis Pemasaran Digital
    • Analisis Penjualan
    • Analisis Web

Pengguna harus memiliki izin develop, manage_models, dan deploy untuk menginstal dan mengelola paket dari Marketplace.

Lihat halaman dokumentasi Looker Marketplace untuk mengetahui informasi tentang cara menginstal dan mengelola Blok Looker dari Looker Marketplace.

Mengakses LookML untuk Blok Marketplace

Blok yang didasarkan pada project yang menggunakan penyempurnaan diinstal dari Marketplace sebagai satu project CONFIG yang dapat diedit yang mengimpor project CORE dari jarak jauh, yang berisi semua kode LookML dan parameterisasi konstan.

Setelah blok diinstal dari Marketplace, Anda dapat mengakses project-nya dari menu Develop dengan mengklik nama project dalam daftar project. Nama blok Penyaringan Marketplace biasanya diawali dengan marketplace_, diikuti dengan ID listingan.

Meskipun Anda tidak dapat langsung mengubah project CORE hanya baca blok, sebaiknya gunakan LookML yang ditentukan dalam file CORE hanya baca blok sebagai referensi saat Anda menyesuaikan file CONFIG blok. Anda dapat melihat file CORE blok dengan membuka file project blok di IDE dan meluaskan direktori imported_projects di browser file IDE.

Struktur file blok

Saat Anda menginstal blok yang dibuat untuk penyempurnaan, file ini dibuat secara otomatis sebagai bagian dari bagian CONFIG project blok:

Nama file Akses Fungsi
<model_name>.model.lkml Hanya baca untuk semua pengguna File model virtual yang terikat dengan penginstalan blok; menangani impor model apa pun dari project CORE blok. Saat blok di-uninstal atau diupdate, file model terkait akan dihapus, sehingga mencegah konflik model antara beberapa penginstalan blok.
manifest.lkml Dapat diedit untuk pengguna dengan izin develop Menjelaskan project dan dependensi eksternalnya. Berisi ID listingan Marketplace untuk penginstalan blok dan memfasilitasi impor jarak jauh file project CORE blok melalui kata kunci marketplace.
marketplace_lock.lkml Hanya baca untuk semua pengguna Berisi referensi ke kata kunci marketplace_ref dari file manifes yang menangani impor jarak jauh project CORE. Memberikan informasi listingan, versi, dan model tertentu yang terkait dengan penginstalan. Berisi informasi tentang konstanta yang dikonfigurasi selama penginstalan (dan yang dapat diperbarui menggunakan opsi Kelola di UI Marketplace).
refinements.lkml Dapat diedit untuk pengguna dengan izin develop Memungkinkan developer meningkatkan kualitas tampilan dan Jelajah yang ditentukan dalam file project CORE yang diimpor.

Menyesuaikan Blok Marketplace

Aktifkan Mode Pengembangan untuk melakukan penyesuaian pada file yang dapat diedit di blok.

Jika memiliki izin develop, Anda dapat menyesuaikan LookML dalam file refinements.lkml dari project CONFIG blok. Anda dapat menyaring tampilan dan Jelajah yang sudah ditentukan dalam project CORE blok atau bahkan menambahkan tampilan dan Jelajah baru yang belum ditentukan dalam project CORE. Apa pun yang dapat dilakukan dengan peningkatan LookML di project LookML lain dapat dilakukan di file refinements.lkml blok. Kombinasi penyempurnaan dan LookML asli berperilaku seolah-olah itu adalah LookML asli untuk objek.

Anda juga dapat membuat perubahan pada file manifest.lkml project CONFIG untuk menentukan dependensi yang perlu diambil untuk blok tersebut.

Anda tidak terbatas untuk mengubah file ini guna mendapatkan penyesuaian yang Anda inginkan. Anda juga dapat membuat file baru di project CONFIG — pastikan untuk include file baru apa pun dalam file refinements.lkml.

Menyesuaikan file perincian

Jika memiliki izin develop, Anda dapat menambahkan LookML kustom ke project CONFIG untuk menggabungkan data tambahan atau mengubah model analisis inti blok. Anda dapat membuat tampilan baru dan menggabungkannya ke Eksplorasi yang ada, menentukan kolom baru atau menentukan ulang kolom yang ada, atau menerapkan label sesuai kebutuhan untuk membuat model analisis yang ingin Anda berikan. Jika telah membuat file baru di project CONFIG, Anda harus include file tersebut dalam file perbaikan.

Misalnya, Anda telah menginstal blok dan file refinements.lkml-nya berisi:

include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"

dengan listing_id adalah nilai parameter listing dari file manifest.lkml.

Anda dapat menggunakan penyempurnaan untuk menambahkan dimensi baru ke tampilan yang disebut flights:

include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"

view: +flights {
  dimension: air_carrier {
    type: string
    sql: ${TABLE}.air_carrier ;;
  }
}

Atau, Anda dapat menerapkan label ke Jelajahi yang disebut aircraft sehingga muncul di UI sebagai Pesawat Sederhana:

include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"

explore: +aircraft {
  label: "Aircraft Simplified"
}

File refinements.lkml disertakan secara otomatis dalam file model "virtual" blok, yang pada dasarnya mengimpor model dari project CORE.

Lihat dokumentasi Peningkatan LookML untuk mengetahui informasi selengkapnya tentang topik lanjutan ini.

Menyesuaikan file manifes yang dapat diedit

Dalam blok yang menggunakan peningkatan, project CORE dan CONFIG memiliki file manifes; tetapi, hanya file manifes project CONFIG yang dapat diedit.

Anda dapat mengedit file CONFIG manifest.lkml untuk menambahkan parameter project ke parameter yang sudah muncul di file manifes project CORE. Misalnya, Anda dapat menambahkan local_dependency untuk menggabungkan blok ke blok lain di instance Looker yang sama.

Sebelum Anda dapat menggunakan atau mem-build pada blok yang berisi parameter local_dependency, admin Looker harus mengaktifkan fitur Local Project Import Labs terlebih dahulu.

Memperbarui nilai untuk konstanta

Konstanta blok ditentukan dalam file manifes project CORE yang diimpor. Mengganti nilai konstanta, jika diizinkan, harus dilakukan di UI Marketplace selama konfigurasi atau dengan memperbarui blok. Untuk memperbarui blok, pengguna harus memiliki izin develop, manage_models, dan deploy.

Untuk mengganti nilai konstanta dengan memperbarui blok:

  1. Di Looker Marketplace, buka blok yang ingin diperbarui.
  2. Klik tombol Kelola.
  3. Di samping nama blok yang ingin diperbarui, klik ikon roda gigi. Tindakan ini akan membuka jendela konfigurasi blok.
  4. Buat perubahan pada nilai konstan sesuai kebutuhan.
  5. Klik Update untuk menutup jendela konfigurasi blok dan memperbarui blok dengan perubahan Anda.

Perubahan Anda akan diterapkan dalam file marketplace_lock.lkml hanya baca di project yang diinstal.

Mempertahankan penyesuaian dari Blok Marketplace yang menggunakan ekstensi

Beberapa blok yang tersedia dari Looker Marketplace terdiri dari project yang menggunakan ekstensi LookML. Looker mengonversi semua Blok Marketplace untuk instance di Looker 21.8 atau yang lebih baru ke struktur project yang menggunakan peningkatan LookML dan akan menghapus dukungan untuk blok yang didasarkan pada extends.

Looker merekomendasikan agar Anda menginstal versi Marketplace Blocks berbasis peningkatan yang Anda miliki di instance saat blok ini tersedia, yang akan menggantikan blok yang dibuat dengan ekstensi. Meskipun proses penggantian ini sederhana — Anda dapat menginstal blok baru (peningkatan) dari listingan Blok Looker Marketplace dan meng-uninstal blok asli (ekstensi) di halaman Kelola di Looker Marketplace — proses ini tidak akan mempertahankan penyesuaian apa pun yang mungkin telah dilakukan pada blok yang dibuat dengan ekstensi. Looker juga tidak akan mentransfer konten atau fungsi Looker apa pun yang didasarkan pada konten tersebut — dasbor, Jelajah, pengiriman konten terjadwal, pemberitahuan — dari blok asli ke blok baru.

Bagian ini menjelaskan cara mempertahankan penyesuaian apa pun pada blok yang dibuat dengan project yang menggunakan ekstensi yang akan sulit atau memakan waktu untuk direplikasi dari awal.

Untuk mempertahankan penyesuaian blok, pengguna yang memiliki kemampuan untuk menginstal dan mengelola paket dari Marketplace harus:

  1. Memperbarui project CONFIG blok asli untuk mempersiapkan migrasi
  2. Menginstal blok versi baru dari Looker Marketplace
  3. Mentransfer penyesuaian ke Blok Marketplace baru
  4. Membuat ulang konten Looker berdasarkan blok asli
  5. Meng-uninstal versi blok yang dibuat dengan extends

Memperbarui blok yang disesuaikan untuk mempersiapkan migrasi

Bagian ini menjelaskan cara mengupdate file project utama dalam blok yang dibuat dengan ekstensi sehingga Anda dapat menyalin penyesuaian blok ke versi blok baru berbasis peningkatan. Blok yang didasarkan pada project yang menggunakan ekstensi diinstal dari Marketplace sebagai project CORE hanya baca dan project CONFIG yang dapat diedit.

  1. Buka project CONFIG blok dari bagian Develop dengan salah satu cara berikut:

    • Klik opsi Projects, lalu klik nama project.
    • Klik nama project CONFIG blok dalam daftar project.

    Nama project CONFIG biasanya diakhiri dengan _config, sedangkan nama project CORE biasanya tidak memiliki akhiran.

  2. Buka file model project, yang mungkin terlihat seperti ini:


    explore: ga_sessions_config {
      extends: [ga_sessions_core]
      extension: required
      join: user_sales_data {
        sql_on: ${user_sales_data.full_visitor_id} = ${ga_sessions.full_visitor_id} ;;
      }
      join: sales__by__category {
        sql: LEFT JOIN UNNEST(${user_sales_data.sales_by_category}) as sales__by__category;;
      }
    }

    explore: future_input_config {
      extends: [future_input_core]
      extension: required
      join: future_purchase_prediction {
        type: left_outer
        sql_on: ${future_input.full_visitor_id} = ${future_purchase_prediction.full_visitor_id} ;;
        relationship: one_to_one
      }
    }

  1. Dalam Mode Pengembangan:

    1. Hapus seluruh baris extends dan extension.
    2. Hapus _config dari nama explore.
    3. Awali dengan + ke nama explore.

    Contoh file model sebelumnya akan terlihat seperti ini:


    explore: +ga_sessions {
      join: user_sales_data {
        sql_on: ${user_sales_data.full_visitor_id} = ${ga_sessions.full_visitor_id} ;;
      }
      join: sales__by__category {
        sql: LEFT JOIN UNNEST(${user_sales_data.sales_by_category}) as sales__by__category;;
      }
    }

    explore: +future_input {
      join: future_purchase_prediction {
        type: left_outer
        sql_on: ${future_input.full_visitor_id} = ${future_purchase_prediction.full_visitor_id} ;;
        relationship: one_to_one
      }
    }

  1. Salin dan simpan konten file ini untuk langkah berikutnya.

Menginstal Blok Marketplace baru

Blok yang didasarkan pada project yang menggunakan penyempurnaan diinstal dari Marketplace sebagai satu project LookML yang dapat diedit yang mengimpor project yang berisi semua LookML dan parameterisasi konstan dari jarak jauh.

  1. Pilih ikon toko di panel menu Looker untuk membuka Looker Marketplace.
  2. Klik listingan untuk Blok Marketplace baru berbasis penyempurnaan. Blok ini memiliki nama yang sama dengan blok yang ada yang dibuat dengan extends.
  3. Klik Instal untuk menginstal blok baru. Setelah blok ini diinstal, Anda akan melihat dua listingan yang identik di halaman Kelola di Looker Marketplace.

Mentransfer penyesuaian ke Blok Marketplace baru

Bagian ini menjelaskan cara mentransfer pembaruan yang Anda buat ke blok asli (perluasan) ke blok baru (peningkatan).

  1. Dari bagian Develop, buka project blok baru dengan salah satu cara berikut:

    • Klik opsi Projects, lalu klik nama project.
    • Klik nama project blok dalam daftar project.

    Nama blok Penyaringan Marketplace biasanya diawali dengan marketplace_, diikuti dengan ID listingan.

  2. Di file refinements.lkml, tempel konten yang diperbarui dari file model blok asli (memperluas). Pastikan untuk mempertahankan pernyataan include yang sudah ada dalam file perincian.

Membuat ulang konten Looker berdasarkan blok asli

Langkah terakhir dalam mengadopsi versi Blok Marketplace berbasis peningkatan adalah meng-uninstal versi blok asli berbasis ekstensi. Beberapa blok berbasis ekstensi berisi dasbor dan Jelajah LookML bawaan. Jika pengguna telah membuat notifikasi atau pengiriman terjadwal yang didasarkan pada dasbor LookML yang ditentukan di blok asli (perluasan), notifikasi atau jadwal tersebut akan dinonaktifkan atau akan gagal, setelah blok tersebut di-uninstal dari Looker Marketplace.

Anda harus membuat ulang pemberitahuan atau pengiriman terjadwal ini di dasbor LookML blok baru (peningkatan). Admin dan pengguna Looker yang memiliki izin yang sesuai untuk jadwal dan notifikasi dapat menggunakan halaman Notifikasi & Jadwal di bagian admin untuk menelusuri nama dasbor blok (perluasan), lalu membuat notifikasi baru atau pengiriman terjadwal sesuai kebutuhan di dasbor yang sesuai untuk blok (peningkatan).

Anda juga harus mengubah konten Looker lain yang mereferensikan dasbor Jelajah atau LookML blok asli (perluasan) agar mengarah ke blok baru (peningkatan), sesuai kebutuhan.

Meng-uninstal blok asli

Untuk meng-uninstal versi blok yang dibuat dengan ekstensi:

  1. Pilih ikon toko di panel menu Looker untuk membuka Looker Marketplace.

  2. Di Looker Marketplace, pilih Kelola di navigasi sebelah kiri untuk membuka halaman Kelola.

  3. Di halaman Kelola, klik ikon tempat sampah untuk meng-uninstal blok asli (memperluas). Anda dapat membedakan daftar blokir ekstensi dari daftar blokir perincian dengan melihat nomor versi. Blok ekstensi akan menjadi satu versi utama di belakang blok peningkatan. Misalnya, blok ekstensi mungkin adalah versi 1.0.4 dan blok peningkatan mungkin adalah versi 2.0.0.

Setelah blok di-uninstal, listingan blok asli (ekstensi) akan hilang dari navigasi sebelah kiri di instance Looker, Jelajahnya akan hilang dari bagian Jelajah, dasbor LookML-nya akan hilang dari folder Dasbor LookML, dan pemberitahuan atau pengiriman terjadwal yang didasarkan pada dasbor LookML blok akan dinonaktifkan atau gagal.

Memecahkan masalah pemblokiran

Jika Blok Marketplace menampilkan error, mungkin skema Anda tidak cocok dengan struktur blok.

Anda juga dapat memeriksa apakah konstanta yang diberikan selama penginstalan blok, yang mewakili koneksi, database, atau skema blok, telah ditentukan dengan benar. Untuk melakukannya, Anda dapat:

  1. Pilih ikon toko di panel menu Looker untuk membuka Looker Marketplace.

  2. Di Looker Marketplace, pilih Kelola di navigasi sebelah kiri untuk membuka halaman Kelola.

  3. Di halaman Kelola, klik ikon roda gigi blok untuk melihat setelan konfigurasinya.

  4. Di jendela Update configurations, pastikan blok dikonfigurasi dengan benar. Klik Update setelah melakukan perubahan untuk menyimpan pembaruan dan menutup jendela konfigurasi blok.