required_access_grants (untuk kolom)

Halaman ini merujuk pada parameter required_access_grants yang merupakan bagian dari dimensi, grup dimensi, ukuran, filter, atau parameter.

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 gabungan, yang dijelaskan di halaman dokumentasi parameter required_access_grants (untuk gabungan).

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

Penggunaan

view: view_name {
  dimension: field_name {
    required_access_grants: [access_grant_name, access_grant_name, ...]
  }
}

Hierarki Lihat File view Jenis Kolom required_access_grants

Jenis Kolom yang Mungkin Dimensi, grup dimensi, ukuran, filter, parameter 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 kolom hanya bagi pengguna yang memiliki nilai atribut pengguna tertentu yang ditetapkan kepada mereka.

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 kolom hanya bagi pengguna yang memiliki akses ke setiap pemberian akses yang tercantum.

Misalnya, LookML berikut mengharuskan pengguna memiliki akses ke hibah akses can_view_financial_data dan view_payroll untuk melihat dimensi salary:

dimension: salary {
  ...
  required_access_grants: [can_view_financial_data, view_payroll]
}

Pengguna yang tidak memiliki akses ke semua hibah akses yang ditetapkan ke kolom tidak akan memiliki akses ke kolom tersebut. Mereka tidak akan melihat kolom di pemilih kolom saat menjelajahi. Jika pengguna melihat Look yang menyertakan kolom yang dibatasi, 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 access_grant.

Contoh

Tampilkan dimensi salary hanya kepada pengguna yang memiliki akses ke payroll access_grant:

dimension: salary {
  type: number
  required_access_grants: [payroll]
}

Pertimbangan lainnya

Melihat tampilan terbatas dengan kolom kalkulasi pada dasbor dan tampilan tersimpan

Karena pengguna yang tidak memiliki akses ke kolom yang dibatasi tidak dapat mengakses kolom tersebut, hal ini dapat menyebabkan perubahan pada data yang dilihat dalam Look tersimpan atau kartu dasbor.

Misalnya, kueri yang menggunakan dimensi yang dibatasi tidak akan memiliki akses ke data dalam dimensi yang dibatasi, sehingga agregasi ukuran terjadi tanpa data tersebut. Oleh karena itu, pengguna yang tidak memiliki akses ke dimensi yang dibatasi akan melihat hasil yang berbeda dalam ukuran daripada pengguna yang memiliki akses ke dimensi yang dibatasi.

Penghitungan tabel berdasarkan kolom yang dibatasi akan menampilkan error bagi pengguna yang tidak memiliki akses ke kolom yang dibatasi, karena penghitungan tabel tidak memiliki akses ke kolom yang dibatasi.