Menyesuaikan Blok Looker Marketplace

Blok Looker adalah model data siap pakai untuk pola analitis 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 mengimpor project. Blok berikut berisi parameter local_dependency:

  • Analisis Pemasaran Digital
  • Analisis Penjualan
  • Analytics 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 yang mengimpor project CORE dari jarak jauh, yang berisi semua kode LookML dan parameterisasi konstan.

Setelah blok diinstal dari Marketplace, Anda dapat mengakses projectnya 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 mengubah project CORE hanya baca blok, Anda dapat menggunakan LookML yang ditentukan dalam file CORE hanya baca blok sebagai referensi saat 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 akan dibuat secara otomatis sebagai bagian dari CONFIG project blok:

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 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 lain dapat dilakukan di file refinements.lkml blok. Kombinasi penyempurnaan dan LookML asli berperilaku seolah-olah merupakan 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 pada pengubahan file ini untuk mendapatkan penyesuaian yang Anda inginkan. Anda juga dapat membuat file baru di project CONFIG — cukup 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 Eksplorasi yang ada, menentukan kolom baru atau mendefinisikan ulang kolom yang ada, atau menerapkan label sesuai kebutuhan untuk membuat model analisis yang ingin Anda berikan. Jika Anda 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 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 penyempurnaan LookML untuk mengetahui 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 CONFIG manifest.lkml untuk menambahkan parameter project ke parameter yang sudah muncul di file manifes project CORE. Misalnya, Anda dapat menambahkan local_dependency ke gabung 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 memperbarui blok. Untuk memperbarui pemblokiran, pengguna harus memiliki izin develop, manage_models, dan deploy.

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

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

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

Mempertahankan penyesuaian dari Blok Marketplace yang menggunakan extends

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 penyempurnaan LookML dan akan menghapus dukungan untuk blok yang didasarkan pada extends.

Looker merekomendasikan agar Anda menginstal versi berbasis penyempurnaan dari setiap Blok Marketplace yang ada di instance Anda saat blok ini tersedia, menggantikan blok yang dibuat dengan extends. Meskipun proses penggantian ini sederhana — Anda dapat menginstal blok baru (penyempurnaan) dari listingan Blok Looker Marketplace dan meng-uninstal blok asli (perluasan) di halaman Kelola 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 ekstensi yang jika tidak, akan sulit atau memakan waktu untuk direplikasi dari awal.

Untuk mempertahankan penyesuaian blok Anda, pengguna dengan kemampuan untuk menginstal dan mengelola paket dari Marketplace harus melakukan langkah-langkah berikut:

1. Memperbarui project CONFIG blok asli untuk bersiap melakukan migrasi
2. Menginstal versi baru blok 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 bersiap melakukan migrasi

Bagian ini menjelaskan cara mengupdate file project utama dalam blok yang dibuat dengan extends sehingga Anda dapat menyalin penyesuaian blok ke versi blok baru berbasis penyempurnaan. Blok yang didasarkan pada project yang menggunakan extends 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. Di Mode Pengembangan, lakukan langkah-langkah berikut:

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

   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 dan mengimpor project yang berisi semua parameterisasi LookML dan konstanta dari jarak jauh.

1. Pilih ikon toko di 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 Looker Marketplace.

Mentransfer penyesuaian ke Blok Marketplace baru

Bagian ini menjelaskan cara mentransfer pembaruan yang Anda lakukan pada 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. Dalam file refinements.lkml, tempelkan konten yang diperbarui dari file model blok asli (memperluas). Pastikan untuk mempertahankan pernyataan include yang sudah ada dalam file perbaikan.

Membuat ulang konten Looker berdasarkan blok asli

Langkah terakhir dalam mengadopsi versi berbasis penyempurnaan dari Blok Marketplace adalah meng-uninstal versi blok berbasis perluasan yang asli. Beberapa blok berbasis perluasan berisi dasbor dan Eksplorasi LookML bawaan. Jika pengguna telah membuat pemberitahuan atau pengiriman terjadwal yang didasarkan pada dasbor LookML yang ditentukan dalam blok asli (extends), pemberitahuan atau jadwal tersebut akan dinonaktifkan atau 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 Pemberitahuan & Jadwal di bagian admin untuk menelusuri nama dasbor blok (perluasan), lalu membuat pemberitahuan baru atau pengiriman terjadwal sesuai kebutuhan di dasbor yang sesuai untuk blok (penyempurnaan).

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

Menghapus instalasi blok asli

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

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

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

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

Memecahkan masalah pemblokiran

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

Anda juga sebaiknya memeriksa apakah konstanta yang diberikan selama penginstalan blok, yang merepresentasikan 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 Kelola di panel navigasi utama untuk membuka halaman Kelola.

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

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