Membuat project LookML baru

Project adalah kumpulan file LookML yang menjelaskan hubungan tabel database Anda satu sama lain dan cara Looker menafsirkan tabel tersebut. Anda dapat mempelajari project lebih lanjut di halaman dokumentasi Project dan model pengembangan LookML serta Istilah dan konsep LookML. Untuk informasi tentang cara mengakses dan mengedit project yang ada, lihat halaman dokumentasi Mengakses dan mengedit informasi project.

Project LookML dapat berisi lebih dari satu file model. Namun, jika ingin menentukan izin bagi pengguna terkait melihat dan mengedit LookML untuk file model tertentu, sebaiknya buat project baru. Meskipun sebagian besar izin di Looker berlaku di level model, ada beberapa izin yang berlaku untuk level project, termasuk see_lookml, yang memungkinkan Anda melihat LookML untuk project, dan develop, yang memungkinkan Anda mengedit LookML.

Pengguna Looker dengan izin manage_models dapat membuat model LookML di instance Looker.

Membuat project

Untuk membuat project, lakukan langkah-langkah berikut:

  1. Pastikan Anda berada dalam Mode Pengembangan.

  2. Pilih Project dari bagian Develop di panel navigasi.

  3. Di halaman LookML Projects, pilih New LookML Project untuk memilih opsi untuk project Anda.

Tindakan ini akan membuka halaman New Project, tempat Anda dapat menentukan setelan untuk project, termasuk nama dan titik awal project.

Looker dapat membuat project dengan beberapa cara, dan langkah-langkah yang diambil bergantung pada opsi Starting Point yang Anda pilih di halaman New Project. Bagian berikut menjelaskan cara kerja titik awal ini:

Membuat model secara otomatis dari database

Dari halaman Project Baru, tentukan opsi berikut untuk membuat model secara otomatis dari database.

  1. Project Name: Beri nama project Anda. Nama project peka huruf besar/kecil dan hanya mengizinkan karakter alfanumerik, _, ., dan -. Pilih nama project dengan cermat dan anggap sebagai ID permanen untuk project, karena Looker menggunakan nama project dengan cara berikut:

    • Untuk mengidentifikasi project untuk panggilan API yang memiliki parameter project_id.
    • Untuk mengidentifikasi project di database internal instance Looker.
    • Untuk mengidentifikasi project untuk impor project lokal.
    • Untuk menampilkan project di halaman Project LookML.
    • Untuk menampilkan project di bagian Develop pada panel navigasi Looker.
    • Sebagai bagian dari URL untuk file project. Misalnya, pada instance Looker dengan URL example.looker.com, file manifes project untuk project bernama ecommerce dapat ditemukan di URL ini: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  2. Starting Point: Pilih Generate Model from Database Schema.

  3. Connection: Dari menu drop-down, pilih nama koneksi database Anda.

  4. Build Views From: Pilih salah satu opsi berikut:

    • Semua Tabel: Generator LookML membuat file tampilan untuk setiap tabel di database Anda.
    • Tabel Tunggal: Generator LookML membuat tampilan untuk satu tabel di database Anda. Jika Anda memilih opsi ini, masukkan nama tabel database.

  5. Skema: Untuk membuat file hanya untuk satu skema di database Anda, masukkan nama skema di kolom teks Skema. Anda dapat mencantumkan beberapa skema, yang dipisahkan dengan koma.

  6. Abaikan Awalan: Untuk menghapus awalan tabel dari nama file tampilan, masukkan awalan database Anda di kolom Abaikan Awalan. Kolom ini peka huruf besar/kecil. Anda dapat mencantumkan beberapa awalan, yang dipisahkan koma. Misalnya, tabel Anda berjudul dwh_orders dan DBS_users. Jika Anda memasukkan dwh, DBS di kolom teks Abaikan Awalan, Looker akan membuat file tampilan bernama orders dan users.

Terakhir, klik Create Project untuk membuat project yang berisi model yang dihasilkan.

  • Generator LookML membuat satu file model untuk project serta file tampilan untuk setiap tabel dalam database (kecuali jika ditentukan lain). Kemudian, Looker akan membuka project baru di Looker IDE.
  • Generator LookML membuat folder IDE untuk file tampilan dan model Anda. Jika database Anda memiliki lebih dari satu skema, generator LookML akan membuat folder untuk skema.

Untuk koneksi BigQuery, jika Anda membuat project LookML dari database, Looker akan otomatis mengisi deskripsi kolom dengan deskripsi dari metadata kolom BigQuery, jika ada.

Generator juga membuat Jelajahi untuk setiap tabel database. Untuk mulai membuat kueri data, gunakan panel Explore untuk memilih nama Jelajah.

Meng-clone repositori Git publik

Jika Anda memilih Clone Public Git Repository sebagai titik awal, Looker akan menyalin file dari repositori Git publik ke project LookML baru Anda.

Project Looker yang di-clone dari repositori Git publik bersifat hanya baca. Namun, Anda dapat mengimpor project hanya baca ke project Looker lain, tempat Anda dapat mengedit file. Selain itu, Anda dapat menggunakan file repositori yang di-clone sebagai titik awal, lalu menggunakan parameter extends atau peningkatan Looker untuk membuat project dari sana.

Dari halaman New Project, tentukan opsi berikut untuk meng-clone repositori Git publik yang ada ke dalam project Looker:

  1. Project Name: Beri nama project Anda. Nama project peka huruf besar/kecil dan tidak boleh menggunakan spasi atau karakter khusus tertentu. Pilih nama project dengan cermat dan anggap sebagai ID permanen untuk project, karena Looker menggunakan nama project dengan cara berikut:

    • Untuk mengidentifikasi project untuk panggilan API yang memiliki parameter project_id.
    • Untuk mengidentifikasi project di database internal instance Looker.
    • Untuk mengidentifikasi project untuk impor project lokal.
    • Untuk menampilkan project di halaman Project LookML.
    • Untuk menampilkan project di bagian Develop pada panel navigasi Looker.
    • Sebagai bagian dari URL untuk file project. Misalnya, pada instance Looker dengan URL example.looker.com, file manifes project untuk project bernama ecommerce dapat ditemukan di URL ini: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  2. Titik Awal: Pilih Clone Public Git Repository.

  3. URL Repositori Git: Masukkan URL untuk repositori Git publik. Pastikan URL dalam format git://github.com/example/my-repository.git.

    Jika memiliki URL seperti https://github.com/llooker/blocks_redshift_admin, Anda dapat mengeditnya menggunakan format yang benar dengan mengganti "https://" dengan "git://", lalu menambahkan ".git" di bagian akhir. URL yang akan Anda masukkan adalah git://github.com/llooker/blocks_redshift_admin.git.

Terakhir, klik Create Project. Looker akan menarik semua file repositori publik ke project LookML baru dan membuka project di Looker IDE.

Membuat project kosong

Jika Anda memilih Blank Project sebagai titik awal, Looker akan membuat project kosong sehingga Anda dapat membuat file LookML dari awal.

Dari halaman Project Baru, tentukan opsi berikut untuk membuat project kosong:

  1. Project Name: Beri nama project Anda. Nama project peka huruf besar/kecil dan tidak boleh menggunakan spasi atau karakter khusus tertentu. Pilih nama project dengan cermat dan anggap sebagai ID permanen untuk project, karena Looker menggunakan nama project dengan cara berikut:

    • Untuk mengidentifikasi project untuk panggilan API yang memiliki parameter project_id.
    • Untuk mengidentifikasi project di database internal instance Looker.
    • Untuk mengidentifikasi project untuk impor project lokal.
    • Untuk menampilkan project di halaman Project LookML.
    • Untuk menampilkan project di bagian Develop pada panel navigasi Looker.
    • Sebagai bagian dari URL untuk file project. Misalnya, pada instance Looker dengan URL example.looker.com, file manifes project untuk project bernama ecommerce dapat ditemukan di URL ini: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  2. Starting Point: Pilih Blank Project.

Terakhir, klik Create Project. Looker akan membuat project dan membukanya di Looker IDE.

Langkah berikutnya

Setelah project dibuat, Anda dapat: