required_access_grants (untuk gabungan)

Halaman ini mengacu pada parameter required_access_grants yang merupakan bagian dari join.

required_access_grants juga dapat menjadi bagian dari Jelajah, yang dijelaskan di halaman dokumentasi parameter required_access_grants (untuk Jelajah).

required_access_grants juga dapat menjadi bagian dari tampilan, yang dijelaskan di halaman dokumentasi parameter required_access_grants (untuk tampilan).

required_access_grants juga dapat menjadi bagian dari dimensi, grup dimensi, ukuran, filter, atau parameter, yang dijelaskan di halaman dokumentasi parameter required_access_grants.

Penggunaan

explore: explore_name {
  join: view_name {
    required_access_grants: [access_grant_name, access_grant_name, ...]
  }
}

Hierarki File Model explore join required_access_grants

Nilai Default Tidak ada Menerima Tanda kurung siku yang berisi daftar nama pemberian akses yang dipisahkan koma

Definisi

required_access_grants dipasangkan dengan parameter access_grant tingkat model untuk membatasi akses gabungan hanya kepada pengguna yang telah diberi nilai atribut pengguna tertentu.

required_access_grants berfungsi seperti ini:

1. Anda menentukan hibah akses menggunakan parameter access_grant. Sebagai bagian dari definisi, Anda mengaitkan pemberian akses dengan atribut pengguna. Anda juga menentukan nilai atribut pengguna mana yang memberikan akses ke pemberian akses.
2. Selanjutnya, Anda menggunakan required_access_grants untuk membatasi gabungan hanya untuk pengguna yang memiliki akses ke setiap pemberian akses yang tercantum.

LookML ini mengharuskan pengguna memiliki akses ke hibah akses can_view_financial_data dan view_payroll untuk melihat gabungan payroll:

join: payroll {
  ...
  required_access_grants: [can_view_financial_data, view_payroll]
}

Pengguna yang tidak memiliki akses ke semua hibah akses yang ditetapkan ke gabungan tidak akan melihat kolom apa pun yang ditambahkan ke Eksplorasi melalui gabungan terbatas. Mereka tidak akan melihat kolom tersebut di pemilih kolom saat menjelajahi. Jika pengguna melihat Look yang menyertakan kolom yang tidak dapat mereka akses, mereka akan melihat pesan peringatan yang menyatakan, "<view.field> tidak ada lagi di <view>, atau Anda tidak memiliki akses ke kolom tersebut, dan kolom tersebut akan diabaikan". Pesan peringatan disembunyikan di kartu dasbor.

Untuk mengetahui informasi selengkapnya tentang cara menentukan pemberian akses, lihat halaman dokumentasi parameter access_grant.

Contoh

Mengekspos gabungan payroll hanya kepada pengguna yang memiliki akses ke pemberian akses pr_dept:

explore: financial {
  join: payroll {
    ...
    required_access_grants: [pr_dept]
  }
}

Pertimbangan lainnya

Melihat gabungan terbatas dengan kolom kalkulasi pada Look dan dasbor tersimpan

Karena pengguna yang tidak memiliki akses ke gabungan terbatas tidak dapat melihat kolom yang ditambahkan oleh gabungan, hal ini dapat mengubah data yang mereka lihat di Look tersimpan atau kartu dasbor.

Misalnya, ukuran yang menggunakan dimensi dari gabungan terbatas tidak akan memiliki akses ke data untuk dimensi tersebut, sehingga agregasi ukuran terjadi tanpa data tersebut. Oleh karena itu, pengguna yang tidak memiliki akses ke gabungan yang dibatasi akan melihat data yang berbeda untuk ukuran tersebut dibandingkan dengan pengguna yang memiliki akses ke gabungan yang dibatasi.

Penghitungan tabel berdasarkan kolom dalam gabungan terbatas menampilkan error untuk pengguna yang tidak memiliki akses ke gabungan terbatas, karena penghitungan tabel tidak memiliki akses ke kolom dalam gabungan terbatas.

Membatasi akses ke struktur LookML pokok

Membatasi akses ke gabungan tidak membatasi akses ke struktur LookML pokoknya. Tampilan atau kolom tidak terbatas yang merupakan bagian dari gabungan lain akan tetap tersedia jika gabungan tersebut tidak terbatas. Gunakan parameter required_access_grants di tingkat tampilan atau kolom untuk membatasi item tersebut satu per satu.