Menyesuaikan Pemblokiran Looker Marketplace

Looker BlocksTM adalah model data bawaan untuk sumber data dan pola analisis umum. Halaman ini menjelaskan cara developer dapat menyesuaikan Pemblokiran Looker yang diinstal dari Looker Marketplace. Looker Marketplace adalah lokasi sentral untuk menemukan, men-deploy, dan mengelola berbagai jenis konten Looker seperti aplikasi, visualisasi, dan plugin.

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

Persyaratan untuk menginstal dan mengelola Pemblokiran Looker dari Looker Marketplace

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

  • Jika Anda menginstal pemblokiran melalui Looker Marketplace, admin Looker Anda harus mengaktifkan fitur Marketplace.

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

    • Analisis Digital Marketing
    • 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 mendapatkan informasi tentang cara menginstal dan mengelola Pemblokiran Looker dari Looker Marketplace.

Mengakses LookML untuk Pemblokiran Marketplace

Blok yang didasarkan pada project yang menggunakan penajaman diinstal dari Marketplace sebagai project CONFIG tunggal 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 penyempurnaan Marketplace biasanya diawali dengan marketplace_ diikuti dengan ID listingan.

Meskipun Anda tidak dapat langsung memodifikasi proyek CORE hanya-baca blok, Anda dapat menggunakan LookML yang didefinisikan dalam file CORE hanya-baca blok sebagai referensi ketika Anda menyesuaikan file CONFIG blok. Anda dapat melihat file CORE blok dengan membuka file project blok di IDE dan memperluas 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 terkait dengan penginstalan blok; menangani impor model apa pun dari project CORE blok. Ketika blok di-uninstal atau diperbarui, file model atau file yang terkait akan dihapus, sehingga mencegah konflik model di antara beberapa penginstalan blok.
manifest.lkml Dapat diedit bagi pengguna yang memiliki izin develop Menjelaskan proyek dan ketergantungan 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 spesifik yang dikaitkan dengan penginstalan. Berisi informasi tentang konstanta yang dikonfigurasi selama penginstalan (dan yang dapat diperbarui menggunakan opsi Kelola di UI Marketplace).
refinements.lkml Dapat diedit bagi pengguna yang memiliki izin develop Memungkinkan developer menyaring tampilan dan Jelajah yang ditentukan dalam file project CORE yang diimpor.

Menyesuaikan Pemblokiran Marketplace

Aktifkan Mode Pengembangan untuk menyesuaikan file blok yang dapat diedit.

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

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

Anda tidak dibatasi pada memodifikasi file ini untuk mencapai penyesuaian yang Anda inginkan. Anda juga dapat membuat file baru di project CONFIG — pastikan untuk include file baru di file refinements.lkml.

Menyesuaikan file penyempurnaan

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 Jelajah yang ada, menentukan kolom baru atau menentukan ulang kolom yang ada, atau menerapkan label sesuai kebutuhan guna membuat model untuk analisis yang ingin Anda berikan. Jika telah membuat file baru di project CONFIG, Anda harus include file tersebut di file penajaman.

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 penajaman 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 Explore 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 otomatis disertakan dalam file model "virtual" blok, yang pada dasarnya mengimpor model dari project CORE.

Lihat dokumentasi penyempurnaan LookML untuk informasi selengkapnya tentang topik lanjutan ini.

Menyesuaikan file manifes yang dapat diedit

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

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

Sebelum Anda dapat menggunakan atau membuat blok yang berisi parameter local_dependency, admin Looker harus terlebih dahulu mengaktifkan fitur Impor Project Lokal Lab.

Mengupdate nilai untuk konstanta

constants 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 pemblokiran, pengguna harus memiliki izin develop, manage_models, dan deploy.

Untuk mengganti nilai konstanta dengan memperbarui blok:

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

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

Mempertahankan penyesuaian dari Pemblokiran Marketplace yang digunakan akan memperluas

Beberapa pemblokiran yang tersedia dari Looker Marketplace terdiri dari project yang menggunakan extends LookML. Looker mengonversi semua Pemblokiran Marketplace untuk instance di Looker 21.8 atau yang lebih baru menjadi struktur project yang menggunakan penyempitan LookerML dan akan menghapus dukungan untuk blok yang didasarkan pada extends.

Looker merekomendasikan agar Anda menginstal versi berbasis penajaman dari setiap Pemblokiran Marketplace yang dimiliki pada instance Anda saat blok tersebut tersedia, menggantikan blok yang dibuat dengan perluasan. Meskipun proses penggantian ini sederhana — Anda dapat menginstal blok baru (penyempurnaan) dari listingan Blokir Looker Marketplace dan meng-uninstal blok asli (diperluas) pada halaman Kelola di Looker Marketplace — tindakan ini tidak akan mempertahankan penyesuaian apa pun yang mungkin telah dilakukan pada blok yang dibuat dengan perluasan. 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 perluasan yang akan sulit atau memakan waktu untuk direplikasi dari awal.

Untuk mempertahankan penyesuaian pemblokiran Anda, pengguna dengan kemampuan untuk menginstal dan mengelola paket dari Marketplace harus:

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

Memperbarui blok yang disesuaikan untuk mempersiapkan migrasi

Bagian ini menjelaskan cara memperbarui file proyek utama dalam blok yang dibuat dengan perluasan sehingga Anda dapat menyalin penyesuaian blok ke versi blok baru berbasis penyempurnaan. Blok yang didasarkan pada project yang menggunakan perluasan 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 Project, 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 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. Tambahkan + di awal 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 pertahankan konten file ini untuk langkah berikutnya.

Menginstal Pemblokiran Marketplace baru

Blok yang didasarkan pada project yang menggunakan penyempurnaan diinstal dari Marketplace sebagai project LookML tunggal 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 Pemblokiran Marketplace baru berbasis penajaman. Blok ini memiliki nama yang sama dengan blok yang ada dan dibuat dengan perluasan.
  3. Klik Instal untuk menginstal blok baru. Setelah blok ini diinstal, Anda akan melihat dua listingan yang sama di halaman Kelola Looker Marketplace.

Mentransfer penyesuaian ke Pemblokiran Marketplace baru

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

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

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

    Nama blok penyempurnaan Marketplace biasanya diawali dengan marketplace_ diikuti dengan ID listingan.

  2. Di file refinements.lkml, tempelkan konten yang diperbarui dari file model blok asli (diperluas). Pastikan untuk mempertahankan pernyataan include apa pun yang sudah ada di file penajaman.

Membuat ulang konten Looker berdasarkan blok asli

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

Anda harus membuat ulang pemberitahuan atau pengiriman terjadwal ini di dasbor LookML blok baru (penyempurnaan). Admin dan pengguna Looker dengan izin yang sesuai untuk jadwal dan pemberitahuan dapat menggunakan halaman Pemberitahuan & Jadwal di bagian admin untuk menelusuri nama dasbor blok (diperluas), lalu membuat pemberitahuan baru atau pengiriman terjadwal sesuai kebutuhan di dasbor terkait blok (penyempurnaan).

Anda juga harus mengubah konten Looker lainnya yang mereferensikan dasbor Explores atau LookML blok asli (diperluas) agar mengarah ke blok (penyempurnaan) baru, sesuai kebutuhan.

Meng-uninstal blok awal

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. Pada halaman Kelola, klik ikon tempat sampah untuk meng-uninstal blok awal (diperluas). Anda dapat membedakan daftar blokir yang diperluas dari daftar blok penyempitan dengan melihat nomor versinya. Blok perluasan akan menjadi salah satu versi utama di balik blok penyempurnaan. Misalnya, blok perluasan mungkin versi 1.0.4 dan blok perbaikan mungkin versi 2.0.0.

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

Memecahkan masalah terkait pemblokiran

Jika Pemblokiran Marketplace menampilkan error, ada kemungkinan skema Anda tidak cocok dengan struktur blok tersebut.

Sebaiknya Anda juga memeriksa apakah constants yang diberikan selama penginstalan blok, yang mewakili koneksi, database, atau skema blok, telah ditetapkan 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 Manage, klik ikon roda gigi blok untuk melihat setelan konfigurasinya.

  4. Di jendela Update configurations, konfirmasi bahwa blok sudah dikonfigurasi dengan benar. Klik Perbarui setelah melakukan perubahan untuk menyimpan pembaruan dan tutup jendela konfigurasi blokir.