remote_dependency

Penggunaan

remote_dependency:  public_project {
  url:  "https://github.com/llooker/google_ga360"
  ref:  "07a20007b6876d349ccbcacccdc400f668fd8147f1"
  override_constant: constant_name {
    value: "string"
  }
}

Hierarki File Manifes remote_dependency

Nilai Default Tidak ada Menerima Subparameter url yang menyertakan URL repositori Git Subparameter ref yang menentukan cabang Git, tag rilis Git, atau SHA commit di repositori Git Subparameter override_constant, yang digunakan untuk menggantikan nilai konstanta yang diimpor dari project lain

Definisi

Parameter remote_dependency memberikan detail repositori Git eksternal yang berisi project LookML yang memiliki file yang ingin Anda gunakan dalam project ini. Anda dapat menyertakan beberapa pernyataan remote_dependency dalam file manifes untuk mengimpor beberapa project.

Parameter remote_dependency ada di file manifes project Anda. Jika project Anda tidak memilikinya, Anda dapat membuat file manifes.

Parameter remote_dependency mengambil nama, yang dapat berupa apa pun yang Anda inginkan. Nama ini adalah nama yang Anda gunakan dalam pernyataan include untuk mereferensikan file yang diimpor dalam project LookML. Nama ini juga digunakan sebagai nama folder di folder imported_projects pada IDE Looker.

Selain itu, parameter remote_dependency memiliki subparameter berikut:

• url
• ref
• override_constant

url

Subparameter url menentukan alamat repositori Git eksternal. Gunakan URL utama repositori. Misalnya, menggunakan HTTPS:

url: "https://github.com/llooker/google_ga360"

Atau menggunakan SSH:

url: "[e-mail]:llooker/google_ga360.git"

ref

Subparameter ref menentukan cabang Git, tag rilis Git, atau SHA commit dari repositori Git project jarak jauh yang harus dimasukkan Looker ke project Looker Anda:

• Cabang Git: Anda dapat menentukan cabang Git jika ingin Looker mendeteksi commit baru untuk cabang tersebut secara otomatis dari project jarak jauh. Untuk mengetahui informasi selengkapnya, lihat halaman dokumentasi Mengimpor file dari project lain.
• Tag rilis Git: Anda dapat menentukan tag rilis Git jika ingin Looker mendeteksi commit baru secara otomatis untuk tag tersebut dari project jarak jauh. Untuk mengetahui informasi selengkapnya, lihat halaman dokumentasi Mengimpor file dari project lain.
• SHA commit Git: Anda dapat menentukan SHA commit jika ingin memiliki pembuatan versi statis, sehingga perubahan dalam project yang diimpor tidak akan otomatis ditampilkan di project Anda. Biasanya, ini adalah commit terbaru, tetapi tidak harus demikian. Anda dapat menemukan SHA commit di mana saja Anda dapat menjelajahi histori commit. Penyedia layanan Git biasanya membuat SHA terlihat jelas dan dapat disalin. Opsi ini cocok untuk Looker Blocks.

Berikut adalah contoh dependensi jarak jauh yang menentukan SHA commit dari project Git jarak jauh:

remote_dependency: ga_360 {
  url: "https://github.com/llooker/google_ga360"
  ref: "f99720c597f524d0756b8194990342efa11b3813"
  }

Berikut adalah contoh dependensi jarak jauh yang menentukan cabang utama pada project Git jarak jauh:

remote_dependency: ga_360 {
  url: "https://github.com/llooker/google_ga360"
  ref: "main"
}

Terlepas dari jenis ref yang Anda tentukan, saat Anda menambahkan remote_dependency ke project dan memvalidasi LookML, IDE akan menampilkan tombol Update Dependencies. Klik tombol untuk membuka file project jarak jauh. Jika ini adalah project jarak jauh pertama yang Anda tambahkan ke project, memperbarui dependensi juga akan meminta Looker untuk membuat file kunci manifes. Looker menggunakan file kunci manifes untuk melacak versi project jarak jauh. Lihat bagian Mendeteksi versi baru project jarak jauh secara otomatis di halaman dokumentasi Mengimpor file dari project lain untuk mengetahui informasi selengkapnya.

override_constant

Parameter override_constant memungkinkan Anda mengganti nilai konstanta yang ditentukan dalam project yang diimpor.

Parameter override_constant juga dapat digunakan dengan parameter local_dependency untuk impor project lokal.

Saat mengimpor file dari satu project ke project lain, Anda dapat mengganti nilai konstanta yang ditentukan dalam file manifes project yang diimpor. Saat Anda mengganti nilai konstanta, file yang diimpor yang mereferensikan konstanta tersebut akan menggunakan nilai baru yang diberikan dalam project yang mengimpor.

Jika parameter export disetel ke override_required atau override_optional untuk konstanta yang ditentukan dalam project yang diimpor, subparameter override_constant dari local_dependency dapat digunakan untuk memberikan nilai baru bagi konstanta tersebut. Misalnya, Anda memiliki konstanta connection yang ditentukan dalam file manifes project yang diimpor:

constant: connection {
  value: "imported_project_connection"
  export: override_required
}

Dalam contoh ini, karena parameter export ditetapkan ke override_required, nilainya harus diganti dalam file manifes project yang mengimpor:

project_name: "importing_project"

remote_dependency: public_project {
  url: "https://github.com/llooker/project"
  ref: "07a20007b6876d349ccbcacccdc400f668fd8147f1"
  override_constant: connection {
    value: "importing_project_connection"
  }
}

Lihat halaman dokumentasi Mengimpor file dari project lain untuk mengetahui informasi selengkapnya dan contoh lain tentang mengganti konstanta dalam mengimpor project.

Contoh

Dalam file manifes, tambahkan repositori Git "Google GA 360" sebagai sumber untuk mengimpor file dari:

project_name: "thelook"

remote_dependency: ga_360 {
  url: "https://github.com/llooker/google_ga360"
  ref: "6a95679c92efa56243c17fb4d66c820cd4a8db03"
}