Menyesuaikan Blok Looker Marketplace

Blok Looker 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 mengetahui informasi selengkapnya tentang semua Blok Looker yang tersedia 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, perhatikan persyaratan berikut:

  • Jika Anda menginstal blok melalui Looker Marketplace, admin Looker Anda harus mengaktifkan fitur Marketplace.
  • Pengguna harus memiliki izin develop, manage_models, dan deploy untuk menginstal dan mengelola paket dari Marketplace.

  • Jika blok tertentu berisi parameter local_dependency, blok tersebut akan menggunakan proses impor project lokal. Lihat halaman dokumentasi Mengimpor file dari project lain untuk mengetahui detail tentang cara mengimpor project. Blok berikut berisi parameter local_dependency:

    • Analisis Pemasaran Digital
    • Analisis Penjualan
    • Analisis Web

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 project CONFIG tunggal yang dapat diedit dan mengimpor project CORE dari jarak jauh, yang berisi semua kode LookML dan parameterisasi konstanta.

Setelah blok di instal 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 mengubah project CORE blok yang hanya dapat dibaca secara langsung, Anda dapat menggunakan LookML yang ditentukan dalam file CORE blok yang hanya dapat dibaca sebagai referensi saat 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 akan dibuat secara otomatis sebagai bagian dari bagian CONFIG project blok:

Nama file Akses Fungsi
<model_name>.model.lkml Hanya dapat dibaca 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 file project CORE blok dari jarak jauh melalui kata kunci marketplace.
marketplace_lock.lkml Hanya dapat dibaca untuk semua pengguna Berisi referensi ke marketplace_ref kata kunci dari file manifes yang menangani impor project CORE dari jarak jauh. Memberikan informasi listingan, versi, dan model tertentu yang terkait dengan penginstalan. Berisi informasi tentang konstanta yang dikonfigurasi selama penginstalan (dan yang dapat diupdate menggunakan opsi Manage di UI Marketplace).
refinements.lkml Dapat diedit untuk pengguna dengan izin develop Memungkinkan developer menyempurnakan tampilan dan Eksplorasi yang ditentukan dalam file project CORE yang diimpor.

Menyesuaikan Blok Marketplace

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

Jika memiliki izin develop, Anda dapat menyesuaikan LookML di file refinements.lkml project CONFIG blok. Anda dapat menyempurnakan tampilan dan Eksplorasi yang sudah ditentukan dalam project CORE blok atau bahkan menambahkan tampilan dan Eksplorasi baru yang belum ditentukan dalam project CORE. Semua hal yang dapat dilakukan dengan penyempurnaan LookML di project LookML lainnya dapat dilakukan di file refinements.lkml blok. Kombinasi penyempurnaan dan LookML asli berperilaku seolah-olah merupakan LookML asli untuk objek.

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

Anda tidak hanya dapat mengubah file ini untuk mendapatkan penyesuaian yang diinginkan. Anda juga dapat membuat file baru di project CONFIG — pastikan untuk include file baru apa pun 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 Eksplorasi yang ada, menentukan kolom baru atau menentukan ulang kolom yang ada, atau menerapkan label sesuai kebutuhan untuk membuat model untuk analisis yang ingin Anda berikan. Jika telah membuat file baru di project CONFIG, Anda harus include file tersebut dalam file penyempurnaan.

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

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 Eksplorasi yang disebut aircraft sehingga muncul di UI sebagai Aircraft Simplified:

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 penyempurnaan LookML untuk mengetahui informasi selengkapnya tentang topik lanjutan ini.

Menyesuaikan file manifes yang dapat diedit

Di blok yang menggunakan penyempurnaan, project CORE dan CONFIG memiliki file manifes; namun, 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 Anda ke blok lain di instance Looker yang sama.

Memperbarui nilai untuk konstanta

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

Untuk mengganti nilai konstanta dengan mengupdate blok, ikuti langkah-langkah berikut:

  1. Di Looker Marketplace, buka blok yang ingin Anda update.
  2. Klik tombol Manage.
  3. Di samping nama blok yang ingin Anda update, klik ikon roda gigi. Tindakan ini akan membuka jendela konfigurasi blok.
  4. Lakukan perubahan pada nilai konstanta sesuai kebutuhan.
  5. Klik Update untuk menutup jendela konfigurasi blok dan mengupdate blok dengan perubahan Anda.

Perubahan Anda akan ditampilkan dalam file marketplace_lock.lkml yang hanya dapat dibaca di project yang diinstal.

Mempertahankan penyesuaian dari Blok Marketplace yang menggunakan perluasan

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

Looker merekomendasikan agar Anda menginstal versi berbasis penyempurnaan dari Blok Marketplace apa pun yang ada di instance Anda saat blok ini tersedia, menggantikan blok yang dibuat dengan perluasan. Meskipun proses penggantian ini sederhana — Anda dapat menginstal blok baru (penyempurnaan) dari listingan Blok Looker Marketplace dan meng-uninstal blok asli (perluasan) di halaman Manage di Looker Marketplace — proses 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, Eksplorasi, 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 blok, pengguna yang memiliki kemampuan untuk menginstal dan mengelola paket dari Marketplace harus melakukan langkah-langkah berikut:

  1. Update project CONFIG blok asli untuk bersiap melakukan migrasi
  2. Instal versi baru blok dari Looker Marketplace
  3. Transfer penyesuaian ke Blok Marketplace baru
  4. Buat ulang konten Looker berdasarkan blok asli
  5. Uninstal versi blok yang dibuat dengan perluasan

Mengupdate blok yang disesuaikan untuk bersiap melakukan migrasi

Bagian ini menjelaskan cara mengupdate file project utama di blok yang dibuat dengan perluasan sehingga Anda dapat menyalin penyesuaian blok ke versi blok berbasis penyempurnaan yang baru. Blok yang didasarkan pada project yang menggunakan perluasan diinstal dari Marketplace sebagai project CORE yang hanya dapat dibaca 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, lakukan langkah-langkah berikut:

    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 simpan konten file ini untuk langkah berikutnya.

Menginstal Blok Marketplace baru

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

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

Mentransfer penyesuaian ke Blok Marketplace baru

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

  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 penyempurnaan Marketplace biasanya diawali dengan marketplace_ diikuti dengan ID listingan.

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

Membuat ulang konten Looker berdasarkan blok asli

Langkah terakhir dalam mengadopsi versi Blok Marketplace berbasis penyempurnaan adalah meng-uninstal versi blok berbasis perluasan yang asli. Beberapa blok berbasis perluasan berisi dasbor dan Eksplorasi LookML siap pakai. Jika pengguna telah membuat pemberitahuan atau pengiriman terjadwal yang didasarkan pada dasbor LookML yang ditentukan dalam blok asli (perluasan), pemberitahuan 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 (penyempurnaan). Admin Looker dan pengguna dengan izin yang sesuai untuk jadwal dan pemberitahuan dapat menggunakan halaman Alerts & Schedules di bagian admin untuk menelusuri nama dasbor blok (perluasan), lalu membuat pemberitahuan atau pengiriman terjadwal baru sesuai kebutuhan di dasbor yang sesuai dengan blok (penyempurnaan).

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

Meng-uninstal blok asli

Untuk meng-uninstal versi blok yang dibuat dengan perluasan, ikuti langkah-langkah berikut:

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

  2. Di Looker Marketplace, pilih Manage di navigasi sisi kiri untuk membuka halaman Manage.

  3. Di halaman Manage, klik ikon tempat sampah untuk meng-uninstal blok asli (perluasan). Anda dapat membedakan daftar blok perluasan dari listingan blok penyempurnaan dengan melihat nomor versi. Blok perluasan akan memiliki satu versi utama di belakang blok penyempurnaan. Misalnya, blok perluasan mungkin versi 1.0.4 dan blok penyempurnaan mungkin versi 2.0.0.

Memecahkan masalah blok

Jika Blok Marketplace menampilkan error, kemungkinan 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, ikuti langkah-langkah ini:

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

  2. Di Looker Marketplace, pilih Manage di panel navigasi utama untuk membuka halaman Manage.

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

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